Compartilhar via

New-AzureRmNetworkInterfaceIpConfig

  • Referência
Módulo:
AzureRM.Network

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

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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

O cmdlet New-AzureRmNetworkInterfaceIpConfig cria uma configuração de IP do adaptador de rede do Azure para um adaptador de rede.

Exemplos

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

$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

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 comando forth cria uma nova configuração de IP chamada "IPConfig-1" como a configuração de IP primária com um endereço IP público associado a ela. O último comando cria uma interface de rede chamada mynic1 usando essa configuração de IP.

2: Crie uma configuração de IP com um endereço IP privado

$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

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 cria uma interface de rede chamada mynic1 usando essa configuração de IP.

Parâmetros

-ApplicationGatewayBackendAddressPool

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

Tipo:List<T>[PSApplicationGatewayBackendAddressPool]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ApplicationGatewayBackendAddressPoolId

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

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ApplicationSecurityGroup

Especifica uma coleção de referências de grupo de segurança de aplicativo às quais essa configuração de IP do adaptador de rede pertence.

Tipo:List<T>[PSApplicationSecurityGroup]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ApplicationSecurityGroupId

Especifica uma coleção de referências de grupo de segurança de aplicativo às quais essa configuração de IP do adaptador de rede pertence.

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-LoadBalancerBackendAddressPool

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

Tipo:List<T>[PSBackendAddressPool]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LoadBalancerBackendAddressPoolId

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

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LoadBalancerInboundNatRule

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

Tipo:List<T>[PSInboundNatRule]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LoadBalancerInboundNatRuleId

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

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Primary

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrivateIpAddress

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6
Tipo:String
Valores aceitos:IPv4, IPv6
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 do adaptador de rede.

Tipo:PSPublicIpAddress
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublicIpAddressId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Subnet

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

Tipo:PSSubnet
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubnetId

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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]]

Saídas

PSNetworkInterfaceIPConfiguration

Observações

  • Palavras-chave: azure, azurerm, arm, recurso, gerenciamento, gerente, rede, rede