Condividi tramite

Add-AzVMNetworkInterface

Modulo:
Az.Compute Module

Aggiunge un'interfaccia di rete a una macchina virtuale.

Sintassi

GetNicFromNicId (impostazione predefinita). 

Add-AzVMNetworkInterface
    [-VM] <PSVirtualMachine>
    [-Id] <String>
    [-Primary]
    [-DeleteOption <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

GetNicFromNicObject 

Add-AzVMNetworkInterface
    [-VM] <PSVirtualMachine>
    [-NetworkInterface] <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference]>
    [-DeleteOption <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Descrizione

Il cmdlet Add-AzVMNetworkInterface aggiunge un'interfaccia di rete a una macchina virtuale. È possibile aggiungere un'interfaccia quando si crea una macchina virtuale o ne si aggiunge una a una macchina virtuale esistente.

Esempio

Esempio 1: Aggiungere un'interfaccia di rete a una nuova macchina virtuale

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
Add-AzVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"

Il primo comando crea un oggetto macchina virtuale e quindi lo archivia nella variabile $VirtualMachine. Il comando assegna un nome e una dimensione alla macchina virtuale. Il secondo comando aggiunge un'interfaccia di rete alla macchina virtuale archiviata in $VirtualMachine.

Esempio 2: Aggiungere un'interfaccia di rete a una macchina virtuale esistente

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

Il primo comando ottiene la macchina virtuale denominata VirtualMachine07 usando il cmdlet Get-AzVM . Il comando archivia la macchina virtuale nella variabile $VirtualMachine . Il secondo comando aggiunge un'interfaccia di rete alla macchina virtuale archiviata in $VirtualMachine. Il comando finale aggiorna lo stato della macchina virtuale archiviata in $VirtualMachine in ResourceGroup11.

Parametri

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Proprietà dei parametri

Tipo:IAzureContextContainer
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DeleteOption

Specifica l'opzione di eliminazione dell'interfaccia di rete dopo l'eliminazione della macchina virtuale. Le opzioni sono Detach, Delete

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Id

Specifica l'ID di un'interfaccia di rete da aggiungere a una macchina virtuale. È possibile usare il cmdlet Get-AzNetworkInterface per ottenere un'interfaccia di rete.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:NicId, IDInterfacciaDiRete

Set di parametri

GetNicFromNicId
Posizione:1
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-NetworkInterface

Specifica l'interfaccia di rete.

Proprietà dei parametri

Tipo:

List<T>[INetworkInterfaceReference]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

GetNicFromNicObject
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Primary

Indica che questo cmdlet aggiunge l'interfaccia di rete come interfaccia primaria.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

GetNicFromNicId
Posizione:2
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-VM

Specifica un oggetto macchina virtuale locale a cui aggiungere un'interfaccia di rete. Per creare una macchina virtuale, usare il cmdlet New-AzVMConfig . Per ottenere una macchina virtuale esistente, usare il cmdlet Get-AzVM .

Proprietà dei parametri

Tipo:PSVirtualMachine
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:VMProfile

Set di parametri

(All)
Posizione:0
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

PSVirtualMachine

String

List<T>

SwitchParameter

Output

PSVirtualMachine