Partilhar via

New-AzNetworkInterfaceIpConfig

Módulo:
Az.Network Module

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

Sintaxe

SetByResource (Predefinição) 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-PrivateIpAddressVersion <String>]
    [-PrivateIpAddress <String>]
    [-Primary]
    [-Subnet <PSSubnet>]
    [-PublicIpAddress <PSPublicIpAddress>]
    [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
    [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
    [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
    [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
    [-GatewayLoadBalancerId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResourceId 

New-AzNetworkInterfaceIpConfig
    -Name <String>
    [-PrivateIPAddressPrefixLength <Int32>]
    [-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 IP da 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 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.

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 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.

Exemplo 3

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

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

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.

Propriedades dos parâmetros

Tipo:

PSApplicationGatewayBackendAddressPool[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

PSApplicationSecurityGroup[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-GatewayLoadBalancerId

A referência do recurso Gateway LoadBalancer Provider.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

PSBackendAddressPool[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

PSInboundNatRule[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Name

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Primary

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PrivateIpAddress

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PrivateIPAddressPrefixLength

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

Propriedades dos parâmetros

Tipo:

Nullable<T>[Int32]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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

Propriedades dos parâmetros

Tipo:String
Default value:None
Valores aceites:IPv4, IPv6
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:PSPublicIpAddress
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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.

Propriedades dos parâmetros

Tipo:PSSubnet
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResource
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-SubnetId

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

SetByResourceId
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

PSBackendAddressPool

PSInboundNatRule

PSApplicationGatewayBackendAddressPool

PSApplicationSecurityGroup

Saídas

PSNetworkInterfaceIPConfiguration

Notas

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