New-AzureRmNetworkInterfaceIpConfig
Cria uma configuração IP de interface de rede.
Aviso
O módulo AzureRM do 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
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 IP da interface de rede do Azure para uma interface de rede.
Exemplos
1: Criar uma configuração 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 respetivamente. 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 cria uma interface de rede chamada mynic1 usando essa configuração IP.
2: Crie uma configuração 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 respetivamente. O terceiro comando cria uma nova configuração 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 IP.
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 de entrada do balanceador de carga às quais esta interface de rede IPConfiguration 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 (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>[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 |
-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
Especifica 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
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
Notas
- Palavras-chave: azure, azurerm, arm, resource, management, manager, network, networking