Compartilhar via

Add-AzureRmVMNetworkInterface

  • Referência
Módulo:
AzureRM.Compute

Adiciona uma interface de rede a uma máquina virtual.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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>]

Description

O cmdlet Add-AzureRmVMNetworkInterface adiciona um adaptador de rede a uma máquina virtual. Você pode adicionar uma interface ao criar uma máquina virtual ou adicionar uma a uma máquina virtual existente.

Exemplos

Exemplo 1: Adicionar um adaptador de rede a uma nova máquina virtual

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"

O primeiro comando cria um objeto de máquina virtual e, em seguida, o armazena na variável $VirtualMachine. O comando atribui um nome e tamanho à máquina virtual. O segundo comando adiciona um adaptador de rede à máquina virtual armazenada no $VirtualMachine.

Exemplo 2: Adicionar um adaptador de rede a uma máquina virtual existente

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

O primeiro comando obtém a máquina virtual chamada VirtualMachine07 usando o cmdlet Get-AzureRmVM . O comando armazena a máquina virtual na variável $VirtualMachine . O segundo comando adiciona um adaptador de rede à máquina virtual armazenada no $VirtualMachine. O comando final atualiza o estado da máquina virtual armazenada no $VirtualMachine em ResourceGroup11.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica a ID de um adaptador de rede a ser adicionado a uma máquina virtual. Você pode usar o cmdlet Get-AzureRmNetworkInterface para obter um adaptador de rede.

Tipo:String
Aliases:NicId, NetworkInterfaceId
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NetworkInterface

Especifica a interface de rede.

Tipo:List<T>[INetworkInterfaceReference]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Primary

Indica que esse cmdlet adiciona o adaptador de rede como a interface primária.

Tipo:SwitchParameter
Cargo:2
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VM

Especifica um objeto de máquina virtual local ao qual adicionar um adaptador de rede. Para criar uma máquina virtual, use o cmdlet New-AzureRmVMConfig . Para obter uma máquina virtual existente, use o cmdlet Get-AzureRmVM .

Tipo:PSVirtualMachine
Aliases:VMProfile
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

PSVirtualMachine

String

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.Commands.Common.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

SwitchParameter

Saídas

PSVirtualMachine