New-AzureRmNetworkInterfaceIpConfig
Crea una configuración ip de 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
New-AzureRmNetworkInterfaceIpConfig
-Name <String>
[-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>]
New-AzureRmNetworkInterfaceIpConfig
-Name <String>
[-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 New-AzureRmNetworkInterfaceIpConfig crea una configuración ip de interfaz de red de Azure para una interfaz de red.
Ejemplos
1: Creación de una configuración de IP con una dirección IP pública para una interfaz de red
$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzureRmPublicIPAddress -Name "PIP1" -ResourceGroupName "RG1"
$IPConfig1 = New-AzureRmNetworkInterfaceIpConfig -Name "IPConfig-1" -Subnet $Subnet -PublicIpAddress $PIP1
-Primary
$nic = New-AzureRmNetworkInterface -Name $NicName -ResourceGroupName myrg -Location westus
-IpConfiguration $IpConfig1
Los dos primeros comandos obtienen una red virtual denominada myvnet y una subred denominada mysubnet respectivamente que se crearon anteriormente. Estos se almacenan en $vnet y $Subnet respectivamente. El tercer comando obtiene una dirección IP pública creada anteriormente denominada PIP1. El comando forth crea una nueva configuración de IP denominada "IPConfig-1" como configuración de IP principal con una dirección IP pública asociada. A continuación, el último comando crea una interfaz de red denominada mynic1 con esta configuración de IP.
2: Creación de una configuración de IP con una dirección IP privada
$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$IPConfig2 = New-AzureRmNetworkInterfaceIpConfig -Name "IP-Config2" -Subnet $Subnet -PrivateIpAddress
10.0.0.5
$nic = New-AzureRmNetworkInterface -Name mynic1 -ResourceGroupName myrg -Location westus -IpConfiguration
$IpConfig2
Los dos primeros comandos obtienen una red virtual denominada myvnet y una subred denominada mysubnet respectivamente que se crearon anteriormente. Estos se almacenan en $vnet y $Subnet respectivamente. El tercer comando crea una nueva configuración de IP denominada "IPConfig-2" con una dirección IP privada 10.0.0.5 asociada. A continuación, el último comando crea una interfaz de red denominada mynic1 con esta configuración de IP.
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 nat de entrada del equilibrador de carga a las que pertenece esta interfaz de red IPConfiguration.
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 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>[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 |
-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
Especifica 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
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
PSNetworkInterfaceIPConfiguration
Notas
- Palabras clave: azure, azurerm, arm, resource, management, manager, network, networking