Compartir a través de

New-AzNetworkInterfaceIpConfig

  • Referencia
Módulo:
Az.Network

Crea una configuración ip de interfaz de red.

Sintaxis

New-AzNetworkInterfaceIpConfig
   -Name <String>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
   [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
   [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
   [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzNetworkInterfaceIpConfig
   -Name <String>
   [-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. (generado automáticamente)

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.

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

-GatewayLoadBalancerId

Referencia del recurso proveedor LoadBalancer de puerta de enlace.

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

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Salidas

PSNetworkInterfaceIPConfiguration

Notas

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