Add-AzureRmVMNetworkInterface
Agrega una interfaz de red a una máquina virtual.
Advertencia
El módulo de PowerShell de AzureRM ha quedado en desuso oficialmente a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.
Aunque el módulo AzureRM puede seguir funcionando, ya no se mantiene ni se admite, colocando cualquier uso continuado a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.
Syntax
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
El cmdlet Add-AzureRmVMNetworkInterface 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
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"
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
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
El primer comando obtiene la máquina virtual denominada VirtualMachine07 mediante el cmdlet Get-AzureRmVM . 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.
Tipo: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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-AzureRmNetworkInterface para obtener una interfaz de red.
Tipo: | String |
Aliases: | NicId, NetworkInterfaceId |
Position: | 1 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-NetworkInterface
Especifica la interfaz de red.
Tipo: | List<T>[INetworkInterfaceReference] |
Position: | 1 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Primary
Indica que este cmdlet agrega la interfaz de red como interfaz principal.
Tipo: | SwitchParameter |
Position: | 2 |
valor predeterminado: | None |
Requerido: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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-AzureRmVMConfig . Para obtener una máquina virtual existente, use el cmdlet Get-AzureRmVM .
Tipo: | PSVirtualMachine |
Aliases: | VMProfile |
Position: | 0 |
valor predeterminado: | None |
Requerido: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Entradas
List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.Commands.Common.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]