Compartir a través de

Set-AzureRmNetworkInterface

  • Referencia
Módulo:
AzureRM.Network

Establece el estado objetivo de una interfaz de red.

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

Set-AzureRmNetworkInterface
   -NetworkInterface <PSNetworkInterface>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzureRmNetworkInterface establece el estado objetivo de una interfaz de red de Azure.

Ejemplos

Ejemplo 1: Configuración de una interfaz de red

$Nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$Nic.IpConfigurations[0].PrivateIpAddress = "10.0.1.20"
$Nic.IpConfigurations[0].PrivateIpAllocationMethod = "Static"
$Nic.Tag = @{Name = "Name"; Value = "Value"}
Set-AzureRmNetworkInterface -NetworkInterface $Nic

En este ejemplo se configura una interfaz de red. El primer comando obtiene una interfaz de red denominada NetworkInterface1 en el grupo de recursos ResourceGroup1. El segundo comando establece la dirección IP privada de la configuración de IP. El tercer comando establece el método de asignación de IP privada en Static. El cuarto comando establece una etiqueta en la interfaz de red. El quinto comando usa la información almacenada en la variable $Nic para establecer la interfaz de red.

Ejemplo 2: Cambiar la configuración de DNS en una interfaz de red

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzureRmNetworkInterface

El primer comando obtiene una interfaz de red denominada NetworkInterface1 que existe en el grupo de recursos ResourceGroup1. El segundo comando agrega el servidor DNS 192.168.1.100 a esta interfaz. El tercer comando aplica estos cambios a la interfaz de red. Para quitar un servidor DNS, siga los comandos enumerados anteriormente, pero reemplace ". Agregue" con ". Remove" en el segundo comando.

Ejemplo 3: Habilitación de la configuración de IP en una interfaz de red

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.EnableIPForwarding = 1
$nic | Set-AzureRmNetworkInterface

El primer comando obtiene una interfaz de red existente denominada NetworkInterface1 y la almacena en la variable $nic. El segundo comando cambia el valor de reenvío IP a true. Por último, el tercer comando aplica los cambios a la interfaz de red. Para deshabilitar el reenvío IP en una interfaz de red, siga el ejemplo de ejemplo, pero asegúrese de cambiar el segundo comando a "$nic. EnableIPForwarding = 0".

Ejemplo 4: Cambiar la subred de una interfaz de red

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$vnet = Get-AzureRmVirtualNetwork -Name VNet1 -ResourceGroupName crosssubcrossversionpeering
$subnet2 = Get-AzureRmVirtualNetworkSubnetConfig -Name Subnet2 -VirtualNetwork $vnet
$nic.IpConfigurations[0].Subnet.Id = $subnet2.Id
$nic | Set-AzureRmNetworkInterface

El primer comando obtiene la interfaz de red NetworkInterface1 y la almacena en la variable $nic. El segundo comando obtiene la red virtual asociada a la subred a la que se va a asociar la interfaz de red. El segundo comando obtiene la subred y la almacena en la variable $subnet 2. El tercer comando asociaba la dirección IP privada principal de la interfaz de red con la nueva subred. Por último, el último comando aplicó estos cambios en la interfaz de red.

Nota:

Las configuraciones de IP deben ser dinámicas para poder cambiar la subred. Si tiene configuraciones de IP estáticas, cambie a dinámica antes de continuar.

Nota:

Si la interfaz de red tiene varias configuraciones IP, el comando forth debe realizarse para todas estas configuraciones IP antes de ejecutar el comando Set-AzureRmNetworkInterface final. Esto se puede hacer como en el comando de la salida, pero reemplazando "0" por el número adecuado. Si una interfaz de red tiene configuraciones de N IP, debe existir N-1 de estos comandos.

Ejemplo 5: Asociar o desasociar un grupo de seguridad de red a una interfaz de red

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzureRmNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzureRmNetworkInterface

El primer comando obtiene una interfaz de red existente denominada NetworkInterface1 y la almacena en la variable $nic. El segundo comando obtiene un grupo de seguridad de red existente denominado MyNSG y lo almacena en la variable $nsg. El comando forth asigna el $nsg al $nic. Por último, el quinto comando aplica los cambios a la interfaz de red. Para desasociar grupos de seguridad de red de una interfaz de red, reemplace $nsg simple en el comando forth por $null.

Parámetros

-AsJob

Ejecución del cmdlet en segundo plano

Tipo:SwitchParameter
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-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

-NetworkInterface

Especifica un objeto NetworkInterface que representa el estado objetivo de una interfaz de red.

Tipo:PSNetworkInterface
Position:Named
valor predeterminado:None
Requerido:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

PSNetworkInterface

Parámetros: NetworkInterface (ByValue)

Salidas

PSNetworkInterface