Compartilhar via

Add-AzVMNetworkInterface

Módulo:
Az.Compute Module

Adiciona um adaptador de rede a uma máquina virtual.

Sintaxe

GetNicFromNicId (Padrão) 

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

Description

O cmdlet Add-AzVMNetworkInterface 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

$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"

O primeiro comando cria um objeto de máquina virtual e o armazena na variável $VirtualMachine. O comando atribui um nome e um 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

$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

O primeiro comando obtém a máquina virtual chamada VirtualMachine07 usando o cmdlet Get-AzVM . 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 em $VirtualMachine no ResourceGroup11.

Parâmetros

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DeleteOption

Especifica a opção de exclusão do adaptador de rede após a exclusão da VM. As opções são Desanexar, Excluir

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Id

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:NicId, NetworkInterfaceId

Conjuntos de parâmetros

GetNicFromNicId
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-NetworkInterface

Especifica a interface de rede.

Propriedades do parâmetro

Tipo:

List<T>[INetworkInterfaceReference]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

GetNicFromNicObject
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Primary

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

GetNicFromNicId
Cargo:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes: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-AzVMConfig . Para obter uma máquina virtual existente, use o cmdlet Get-AzVM .

Propriedades do parâmetro

Tipo:PSVirtualMachine
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:VMProfile

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

PSVirtualMachine

String

List<T>

SwitchParameter

Saídas

PSVirtualMachine