Partilhar via

Add-AzureRmNetworkInterfaceIpConfig

  • Referência
Módulo:
AzureRM.Network

Adiciona uma configuração IP de interface de rede a uma interface de rede.

Aviso

O módulo AzureRM PowerShell 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 Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

Add-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-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>]
Add-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-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 Add-AzureRmNetworkInterfaceIpConfig adiciona uma configuração IP de interface de rede a uma interface de rede do Azure.

Exemplos

Exemplo 1: Adicionar uma nova configuração de IP com um grupo de segurança de aplicativo

$subnet = New-AzureRmVirtualNetworkSubnetConfig -Name MySubnet -AddressPrefix 10.0.1.0/24
$vnet = New-AzureRmvirtualNetwork -Name MyVNET -ResourceGroupName MyResourceGroup -Location "West US" -AddressPrefix 10.0.0.0/16 -Subnet $subnet

$nic = New-AzureRmNetworkInterface -Name MyNetworkInterface -ResourceGroupName MyResourceGroup -Location "West US"  -Subnet $vnet.Subnets[0]

$asg = New-AzureRmApplicationSecurityGroup -ResourceGroupName MyResourceGroup -Name MyASG -Location "West US"

$nic | Set-AzureRmNetworkInterfaceIpConfig -Name $nic.IpConfigurations[0].Name -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg | Set-AzureRmNetworkInterface

$nic | Add-AzureRmNetworkInterfaceIpConfig -Name MyNewIpConfig -Subnet $vnet.Subnets[0] -ApplicationSecurityGroup $asg  | Set-AzureRmNetworkInterface

Neste exemplo, criamos uma nova interface de rede MyNetworkInterface que pertence a uma sub-rede na nova rede virtual MyVNET. Também criamos um grupo de segurança de aplicativo vazio MyASG para associar às configurações de IP na interface de rede. Depois que ambos os objetos são criados, vinculamos a configuração IP padrão ao objeto MyASG. Por fim, criamos uma nova configuração IP na interface de rede também vinculada ao objeto do grupo de segurança do aplicativo.

Parâmetros

-ApplicationGatewayBackendAddressPool

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

Tipo:List<T>[PSApplicationGatewayBackendAddressPool]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ApplicationGatewayBackendAddressPoolId

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

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ApplicationSecurityGroup

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

Tipo:List<T>[PSApplicationSecurityGroup]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ApplicationSecurityGroupId

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

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LoadBalancerBackendAddressPool

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

Tipo:List<T>[PSBackendAddressPool]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LoadBalancerBackendAddressPoolId

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

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LoadBalancerInboundNatRule

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

Tipo:List<T>[PSInboundNatRule]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-LoadBalancerInboundNatRuleId

Especifica uma coleção de referências de regra NAT de entrada do balanceador de carga às quais essa configuração IP da interface de rede pertence.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NetworkInterface

Especifica um objeto NetworkInterface . Este cmdlet adiciona uma configuração IP da interface de rede ao objeto especificado por esse parâmetro.

Tipo:PSNetworkInterface
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Primary

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PrivateIpAddress

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PrivateIpAddressVersion

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

  • IPv4
  • IPv6
Tipo:String
Valores aceites:IPv4, IPv6
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublicIpAddress

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

Tipo:PSPublicIpAddress
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublicIpAddressId

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Subnet

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

Tipo:PSSubnet
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SubnetId

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

PSNetworkInterface

Parâmetros: NetworkInterface (ByValue)

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

PSNetworkInterface

Notas

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