New-AzNetworkInterfaceIpConfig

Cria uma configuração IP de interface de rede.

Syntax

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

O cmdlet New-AzNetworkInterfaceIpConfig cria uma configuração de IP de interface de rede do Azure para uma interface de rede.

Exemplos

Exemplo 1: Criar uma configuração IP com um endereço IP público para uma interface de rede

$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

Os dois primeiros comandos obtêm uma rede virtual chamada myvnet e uma sub-rede chamada mysubnet, respectivamente, que foram criadas anteriormente. Estes são armazenados em $vnet e $Subnet respectivamente. O terceiro comando obtém um endereço IP público criado anteriormente chamado PIP1. O quarto comando cria uma nova configuração IP chamada "IPConfig-1" como a configuração IP primária com um endereço IP público associado a ela. O último comando, em seguida, cria uma interface de rede chamada mynic1 usando essa configuração de IP.

Exemplo 2: Criar uma configuração IP com um endereço IP privado

$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

Os dois primeiros comandos obtêm uma rede virtual chamada myvnet e uma sub-rede chamada mysubnet, respectivamente, que foram criadas anteriormente. Estes são armazenados em $vnet e $Subnet respectivamente. O terceiro comando cria uma nova configuração de IP chamada "IPConfig-2" com um endereço IP privado 10.0.0.5 associado a ele. O último comando, em seguida, cria uma interface de rede chamada mynic1 usando essa configuração de IP.

Exemplo 3

Cria uma configuração IP de interface de rede. (gerado automaticamente)

New-AzNetworkInterfaceIpConfig -Name 'IP-Config2' -PrivateIpAddress '10.0.1.10' -PrivateIpAddressVersion IPv4 -SubnetId <String>

Parâmetros

-ApplicationGatewayBackendAddressPool

Especifica uma coleção de referências de pool de endereços de back-end de gateway de aplicativo à qual essa configuração IP de interface de rede pertence.

Type:PSApplicationGatewayBackendAddressPool[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationGatewayBackendAddressPoolId

Especifica uma coleção de referências de pool de endereços de back-end de gateway de aplicativo à qual essa configuração IP de interface de rede pertence.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationSecurityGroup

Especifica uma coleção de referências de grupo de segurança de aplicativo à qual essa configuração IP de interface de rede pertence.

Type:PSApplicationSecurityGroup[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ApplicationSecurityGroupId

Especifica uma coleção de referências de grupo de segurança de aplicativo à qual essa configuração IP de interface de rede pertence.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GatewayLoadBalancerId

A referência do recurso Provedor LoadBalancer de Gateway.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerBackendAddressPool

Especifica uma coleção de referências de pool de endereços de back-end do balanceador de carga à qual essa configuração IP de interface de rede pertence.

Type:PSBackendAddressPool[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerBackendAddressPoolId

Especifica uma coleção de referências de pool de endereços de back-end do balanceador de carga à qual essa configuração IP de interface de rede pertence.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerInboundNatRule

Especifica uma coleção de referências de Regra Nat de entrada do balanceador de carga à qual essa interface de rede IPConfiguration pertence.

Type:PSInboundNatRule[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-LoadBalancerInboundNatRuleId

Especifica uma coleção de referências de regra NAT (conversão de endereço de rede) de entrada do balanceador de carga à qual essa configuração IP de interface de rede pertence.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome da configuração IP da interface de rede.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Primary

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateIpAddress

Especifica o endereço IP estático da configuração IP da interface de rede.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PrivateIpAddressVersion

Especifica a versão do endereço IP de uma configuração IP de interface de rede. Os valores aceitáveis para esse parâmetro são:

  • IPv4
  • IPv6
Type:String
Accepted values:IPv4, IPv6
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddress

Especifica um objeto PublicIPAddress . Esse cmdlet cria uma referência a um endereço IP público a ser associado a essa configuração de IP da interface de rede.

Type:PSPublicIpAddress
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIpAddressId

Esse cmdlet cria uma referência a um endereço IP público a ser associado a essa configuração de IP da interface de rede.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Subnet

Especifica um objeto Sub-rede . Esse cmdlet cria uma referência a uma sub-rede na qual essa configuração IP de interface de rede é criada.

Type:PSSubnet
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SubnetId

Especifica uma referência a uma sub-rede na qual essa configuração IP de interface de rede é criada.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Saídas

PSNetworkInterfaceIPConfiguration

Observações

  • Palavras-chave: azure, azurerm, arm, resource, management, manager, network, networking