New-AzNetworkInterfaceIpConfig
Crea una configuración ip de interfaz de red.
Sintaxis
SetByResource (valor predeterminado)
New-AzNetworkInterfaceIpConfig
-Name <String>
[-PrivateIPAddressPrefixLength <Int32>]
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-Subnet <PSSubnet>]
[-PublicIpAddress <PSPublicIpAddress>]
[-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
[-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
[-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
[-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
[-GatewayLoadBalancerId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
SetByResourceId
New-AzNetworkInterfaceIpConfig
-Name <String>
[-PrivateIPAddressPrefixLength <Int32>]
[-PrivateIpAddressVersion <String>]
[-PrivateIpAddress <String>]
[-Primary]
[-SubnetId <String>]
[-PublicIpAddressId <String>]
[-LoadBalancerBackendAddressPoolId <String[]>]
[-LoadBalancerInboundNatRuleId <String[]>]
[-ApplicationGatewayBackendAddressPoolId <String[]>]
[-ApplicationSecurityGroupId <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
El cmdlet New-AzNetworkInterfaceIpConfig crea una configuración ip de interfaz de red de Azure para una interfaz de red.
Ejemplos
Ejemplo 1: Creación de una configuración de IP con una dirección IP pública para una interfaz de red
$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$PIP1 = Get-AzPublicIpAddress -Name "PIP1" -ResourceGroupName "RG1"
$IPConfig1 = New-AzNetworkInterfaceIpConfig -Name "IPConfig-1" -Subnet $Subnet -PublicIpAddress $PIP1 -Primary
$nic = New-AzNetworkInterface -Name mynic1 -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.
Ejemplo 2: Creación de una configuración de IP con una dirección IP privada
$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$Subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$IPConfig2 = New-AzNetworkInterfaceIpConfig -Name "IP-Config2" -Subnet $Subnet -PrivateIpAddress 10.0.0.5
$nic = New-AzNetworkInterface -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.
Ejemplo 3
Crea una configuración ip de interfaz de red. (autogenerated)
New-AzNetworkInterfaceIpConfig -Name 'IP-Config2' -PrivateIpAddress '10.0.1.10' -PrivateIpAddressVersion IPv4 -SubnetId <String>
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.
Propiedades de parámetro
Conjuntos de parámetros
SetByResource
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResourceId
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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.
Propiedades de parámetro
Conjuntos de parámetros
SetByResource
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResourceId
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-DefaultProfile
Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.
Propiedades de parámetro
Tipo: IAzureContextContainer
Valor predeterminado: None Admite caracteres comodín: False DontShow: False Alias: AzContext, AzureRmContext, AzureCredential
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-GatewayLoadBalancerId
Referencia del recurso proveedor LoadBalancer de puerta de enlace.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResource
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: PSBackendAddressPool [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResource
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResourceId
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-LoadBalancerInboundNatRule
Especifica una colección de referencias nat de entrada del equilibrador de carga a las que pertenece esta interfaz de red IPConfiguration.
Propiedades de parámetro
Tipo: PSInboundNatRule [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResource
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String [ ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResourceId
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: True Valor de los argumentos restantes: False
-Name
Especifica el nombre de la configuración ip de la interfaz de red.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: True Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-Primary
El cmdlet New-AzNetworkInterfaceIpConfig crea una configuración ip de interfaz de red de Azure para una interfaz de red.
Propiedades de parámetro
Tipo: SwitchParameter
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-PrivateIpAddress
Especifica la dirección IP estática de la configuración ip de la interfaz de red.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-PrivateIPAddressPrefixLength
Especifica la longitud del prefijo de dirección IP estática de la configuración ip de la interfaz de red.
Propiedades de parámetro
Tipo: Nullable<T> [ Int32 ]
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-PrivateIpAddressVersion
Especifica la versión de dirección IP de una configuración ip de interfaz de red.
Los valores aceptables para este parámetro son:
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Valores aceptados: IPv4, IPv6 Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
(All)
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: PSPublicIpAddress
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResource
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResourceId
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: 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.
Propiedades de parámetro
Tipo: PSSubnet
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResource
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
-SubnetId
Especifica una referencia a una subred en la que se crea esta configuración ip de interfaz de red.
Propiedades de parámetro
Tipo: String
Valor predeterminado: None Admite caracteres comodín: False DontShow: False
Conjuntos de parámetros
SetByResourceId
Posición: Named Obligatorio: False Valor de la canalización: False Valor de la canalización por nombre de propiedad: False Valor de los argumentos restantes: False
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters .
Salidas
Notas
Palabras clave: azure, azurerm, arm, resource, management, manager, network, networking
