Compartir a través de

Set-AzureRmNetworkInterfaceIpConfig

  • Referencia
Módulo:
AzureRM.Network

Establece el estado objetivo de una configuración ip de interfaz de red de Azure.

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-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
   [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
   [-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
   [-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

El cmdlet Set-AzureRmNetworkInterfaceIpConfig establece el estado objetivo de una configuración ip de interfaz de red de Azure.

Ejemplos

1: Cambiar la dirección IP de una configuración de IP

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet
    -Primary

$nic | Set-AzureRmNetworkInterface

Los dos primeros comandos obtienen una red virtual denominada myvnet y una subred denominada mysubnet y la almacenan en las variables $vnet y $subnet respectivamente. El tercer comando obtiene la interfaz de red nic1 asociada a la configuración de IP que debe actualizarse. El tercer comando establece la dirección IP privada de la configuración ipconfig1 principal en 10.0.0.11. Por último, el último comando actualiza la interfaz de red para asegurarse de que los cambios se han realizado correctamente.

2: Asociación de una configuración de IP con un grupo de seguridad de aplicaciones

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-ApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

$nic = Get-AzureRmNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzureRmNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg
    -Primary

$nic | Set-AzureRmNetworkInterface

En este ejemplo, la variable $asg contiene una referencia a un grupo de seguridad de aplicaciones. El cuarto comando obtiene la interfaz de red nic1 asociada a la configuración de IP que debe actualizarse. Set-AzureRmNetworkInterfaceIpConfig establece la dirección IP privada de la configuración de IP principal ipconfig1 en 10.0.0.11 y crea una asociación con el grupo de seguridad de aplicaciones recuperado. Por último, el último comando actualiza la interfaz de red para asegurarse de que los cambios se han realizado correctamente.

Parámetros

-ApplicationGatewayBackendAddressPool

Especifica una colección de referencias del grupo de direcciones de back-end de application gateway a las que pertenece esta configuración ip de interfaz de red.

Tipo:List<T>[PSApplicationGatewayBackendAddressPool]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationGatewayBackendAddressPoolId

Especifica una colección de referencias del grupo de direcciones de back-end de application gateway a las que pertenece esta configuración ip de interfaz de red.

Tipo:List<T>[String]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationSecurityGroup

Especifica una colección de referencias de grupo de seguridad de aplicaciones a las que pertenece esta configuración ip de interfaz de red.

Tipo:List<T>[PSApplicationSecurityGroup]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationSecurityGroupId

Especifica una colección de referencias de grupo de seguridad de aplicaciones a las que pertenece esta configuración ip de interfaz de red.

Tipo:List<T>[String]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
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

-LoadBalancerBackendAddressPool

Especifica una colección de referencias del grupo de direcciones de back-end del equilibrador de carga al que pertenece esta configuración ip de interfaz de red.

Tipo:List<T>[PSBackendAddressPool]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerBackendAddressPoolId

Especifica una colección de referencias del grupo de direcciones de back-end del equilibrador de carga al que pertenece esta configuración ip de interfaz de red.

Tipo:List<T>[String]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerInboundNatRule

Especifica una colección de referencias de reglas de traducción de direcciones de red (NAT) entrantes del equilibrador de carga a las que pertenece esta configuración ip de interfaz de red.

Tipo:List<T>[PSInboundNatRule]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerInboundNatRuleId

Especifica una colección de referencias de reglas NAT entrantes del equilibrador de carga a las que pertenece esta configuración ip de interfaz de red.

Tipo:List<T>[String]
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica el nombre de la configuración ip de red para la que establece este cmdlet.

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

-NetworkInterface

Especifica un objeto NetworkInterface . Este cmdlet agrega una configuración ip de interfaz de red al objeto que especifica este parámetro.

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

-Primary

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

-PrivateIpAddress

Especifica la dirección IP estática de la configuración ip de la interfaz de red.

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

-PrivateIpAddressVersion

Especifica la versión de dirección IP de una configuración ip de interfaz de red. Los valores permitidos para este parámetro son los siguientes:

  • IPv4
  • IPv6
Tipo:String
valores aceptados:IPv4, IPv6
Position:Named
valor predeterminado:None
Requerido:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddress

Especifica un objeto PublicIPAddress . Este cmdlet crea una referencia a una dirección IP pública para asociarla a esta configuración de IP de interfaz de red.

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

-PublicIpAddressId

Este cmdlet crea una referencia a una dirección IP pública para asociarla a esta configuración de IP de interfaz de red.

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

-Subnet

Especifica un objeto Subnet . Este cmdlet crea una referencia a una subred en la que se crea esta configuración ip de interfaz de red.

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

-SubnetId

Este cmdlet crea una referencia a una subred en la que se crea esta configuración ip de interfaz de red.

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

Entradas

PSNetworkInterface

Parámetros: NetworkInterface (ByValue)

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Salidas

PSNetworkInterface

Notas

  • Palabras clave: azure, azurerm, arm, resource, management, manager, network, networking