Compartir a través de


Add-AzureRmNetworkInterfaceIpConfig

Agrega una configuración IP de interfaz de red a 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.

Sintaxis

Add-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>]
Add-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 Add-AzureRmNetworkInterfaceIpConfig agrega una configuración ip de interfaz de red a una interfaz de red de Azure.

Ejemplos

Ejemplo 1: Adición de una nueva configuración de IP con un grupo de seguridad de aplicaciones

$subnet = New-AzureRmVirtualNetworkSubnetConfig -Name MySubnet -AddressPrefix 10.0.1.0/24
$vnet = New-AzureRmvirtualNetwork -Name MyVNET -ResourceGroupName MyResourceGroup -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $subnet

$nic = New-AzureRmNetworkInterface -Name MyNetworkInterface -ResourceGroupName MyResourceGroup -Location "West US"  -Subnet $vnet.Subnets[0]

$asg = New-AzureRmApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name MyASG -Location "West US"

$nic | Set-AzureRmNetworkInterfaceIpConfig -Name $nic.IpConfigurations[0].Name -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzureRmNetworkInterface

$nic | Add-AzureRmNetworkInterfaceIpConfig -Name MyNewIpConfig -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg  | Set-AzureRmNetworkInterface

En este ejemplo, creamos una nueva interfaz de red MyNetworkInterface que pertenece a una subred de la nueva red virtual MyVNET. También se crea un grupo de seguridad de aplicaciones vacío MyASG para asociar con las configuraciones de IP en la interfaz de red. Una vez creados ambos objetos, vinculamos la configuración ip predeterminada al objeto MyASG. Por último, creamos una nueva configuración ip en la interfaz de red también vinculada al objeto del grupo de seguridad de aplicaciones.

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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre de la configuración ip de la interfaz de red.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Primary

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PrivateIpAddress

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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