Add-AzureRmVMNetworkInterface
Aggiungere un'interfaccia di rete a una macchina virtuale.
Avviso
Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.
Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.
Sintassi
Add-AzureRmVMNetworkInterface
[-VM] <PSVirtualMachine>
[-Id] <String>
[-Primary]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Add-AzureRmVMNetworkInterface
[-VM] <PSVirtualMachine>
[-NetworkInterface] <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference]>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Descrizione
Il cmdlet Add-AzureRmVMNetworkInterface 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
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> Add-AzureRmVMNetworkInterface -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
PS C:\> $VirtualMachine = Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
PS C:\> Add-AzureRmVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
PS C:\> Update-AzureRmVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine
Il primo comando ottiene la macchina virtuale denominata VirtualMachine07 usando il cmdlet Get-AzureRmVM . 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.
Tipo: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Id
Specifica l'ID di un'interfaccia di rete da aggiungere a una macchina virtuale. È possibile usare il cmdlet Get-AzureRmNetworkInterface per ottenere un'interfaccia di rete.
Tipo: | String |
Alias: | NicId, NetworkInterfaceId |
Posizione: | 1 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-NetworkInterface
Specifica l'interfaccia di rete.
Tipo: | List<T>[INetworkInterfaceReference] |
Posizione: | 1 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Primary
Indica che questo cmdlet aggiunge l'interfaccia di rete come interfaccia primaria.
Tipo: | SwitchParameter |
Posizione: | 2 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-VM
Specifica un oggetto macchina virtuale locale a cui aggiungere un'interfaccia di rete. Per creare una macchina virtuale, usare il cmdlet New-AzureRmVMConfig . Per ottenere una macchina virtuale esistente, usare il cmdlet Get-AzureRmVM .
Tipo: | PSVirtualMachine |
Alias: | VMProfile |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
Input
List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.Commands.Common.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]