Compartir a través de

Add-AzVMNetworkInterface

Módulo:
Az.Compute Module

Agrega una interfaz de red a una máquina virtual.

Sintaxis

GetNicFromNicId (valor predeterminado) 

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

El cmdlet Add-AzVMNetworkInterface agrega una interfaz de red a una máquina virtual. Puede agregar una interfaz al crear una máquina virtual o agregar una a una máquina virtual existente.

Ejemplos

Ejemplo 1: Adición de una interfaz de red a una nueva 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"

El primer comando crea un objeto de máquina virtual y, a continuación, lo almacena en la variable $VirtualMachine. El comando asigna un nombre y un tamaño a la máquina virtual. El segundo comando agrega una interfaz de red a la máquina virtual almacenada en $VirtualMachine.

Ejemplo 2: Adición de una interfaz de red a una 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

El primer comando obtiene la máquina virtual denominada VirtualMachine07 mediante el cmdlet Get-AzVM . El comando almacena la máquina virtual en la variable $VirtualMachine. El segundo comando agrega una interfaz de red a la máquina virtual almacenada en $VirtualMachine. El comando final actualiza el estado de la máquina virtual almacenada en $VirtualMachine en ResourceGroup11.

Parámetros

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Propiedades de parámetro

Tipo:IAzureContextContainer
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:AzContext, AzureRmContext, AzureCredential

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DeleteOption

Especifica la opción de eliminación de interfaz de red después de la eliminación de la máquina virtual. Las opciones son Desasociar, Eliminar

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Id

Especifica el identificador de una interfaz de red que se va a agregar a una máquina virtual. Puede usar el cmdlet Get-AzNetworkInterface para obtener una interfaz de red.

Propiedades de parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:NicId, NetworkInterfaceId

Conjuntos de parámetros

GetNicFromNicId
Posición:1
Obligatorio:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-NetworkInterface

Especifica la interfaz de red.

Propiedades de parámetro

Tipo:

List<T>[INetworkInterfaceReference]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetNicFromNicObject
Posición:1
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Primary

Indica que este cmdlet agrega la interfaz de red como interfaz principal.

Propiedades de parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

GetNicFromNicId
Posición:2
Obligatorio:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-VM

Especifica un objeto de máquina virtual local al que se va a agregar una interfaz de red. Para crear una máquina virtual, use el cmdlet New-AzVMConfig . Para obtener una máquina virtual existente, use el cmdlet Get-AzVM .

Propiedades de parámetro

Tipo:PSVirtualMachine
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:VMProfile

Conjuntos de parámetros

(All)
Posición:0
Obligatorio:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

PSVirtualMachine

String

List<T>

SwitchParameter

Salidas

PSVirtualMachine