Compartilhar via


Set-AzNetworkInterfaceIpConfig

Atualiza uma configuração de IP para um adaptador de rede.

Sintaxe

Set-AzNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <PSBackendAddressPool[]>]
   [-LoadBalancerInboundNatRule <PSInboundNatRule[]>]
   [-ApplicationGatewayBackendAddressPool <PSApplicationGatewayBackendAddressPool[]>]
   [-ApplicationSecurityGroup <PSApplicationSecurityGroup[]>]
   [-GatewayLoadBalancerId <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <String[]>]
   [-LoadBalancerInboundNatRuleId <String[]>]
   [-ApplicationGatewayBackendAddressPoolId <String[]>]
   [-ApplicationSecurityGroupId <String[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Set-AzNetworkInterfaceIpConfig atualiza uma configuração de IP para um adaptador de rede.

Exemplos

Exemplo 1: alterando o endereço IP de uma configuração de IP

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -Primary

$nic | Set-AzNetworkInterface

Os dois primeiros comandos obtêm uma rede virtual chamada myvnet e uma sub-rede chamada mysubnet e armazenam-na nas variáveis $vnet e $subnet respectivamente. O terceiro comando obtém a interface de rede nic1 associada à configuração de IP que precisa ser atualizada. O terceiro comando define o endereço IP privado do ipconfig1 de configuração de IP primário como 10.0.0.11. Por fim, o último comando atualiza a interface de rede garantindo que as alterações tenham sido feitas com êxito.

Exemplo 2: associar uma configuração de IP a um grupo de segurança de aplicativo

$vnet = Get-AzVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-AzApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -PrivateIpAddress 10.0.0.11 -Subnet $subnet -ApplicationSecurityGroup $asg -Primary

$nic | Set-AzNetworkInterface

Neste exemplo, a variável $asg contém uma referência a um grupo de segurança de aplicativo. O quarto comando obtém a interface de rede nic1 associada à configuração de IP que precisa ser atualizada. O Set-AzNetworkInterfaceIpConfig define o endereço IP privado do ipconfig1 de configuração de IP primário como 10.0.0.11 e cria uma associação com o grupo de segurança do aplicativo recuperado. Por fim, o último comando atualiza a interface de rede garantindo que as alterações tenham sido feitas com êxito.

Exemplo 3: Desassociando uma configuração de IP com um pool de endereços de back-end do gateway de aplicativo

$nic = Get-AzNetworkInterface -Name nic1 -ResourceGroupName myrg

$nic | Set-AzNetworkInterfaceIpConfig -Name ipconfig1 -ApplicationGatewayBackendAddressPool $null

$nic | Set-AzNetworkInterface

O Set-AzNetworkInterfaceIpConfig define o pool de endereços de back-end do gateway de aplicativo do ipconfig1 como nulo e desassociado com o adaptador de rede. Por fim, o último comando atualiza a interface de rede garantindo que as alterações tenham sido feitas com êxito.

Parâmetros

-ApplicationGatewayBackendAddressPool

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

Tipo: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 do pool de endereços de back-end do gateway de aplicativo à qual essa configuração de IP da interface de rede pertence.

Tipo: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 do grupo de segurança do aplicativo à qual essa configuração de IP da interface de rede pertence.

Tipo: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 do grupo de segurança do aplicativo à qual essa configuração de IP da interface de rede pertence.

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

-GatewayLoadBalancerId

Especifica a ID da configuração de ip de front-end do provedor de load balancer de gateway.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
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 da interface de rede pertence.

Tipo: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 da interface de rede pertence.

Tipo: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 (conversão de endereços de rede) de entrada do balanceador de carga às quais essa configuração de IP da interface de rede pertence.

Tipo: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 de entrada do balanceador de carga às quais essa configuração de IP da interface de rede pertence.

Tipo: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 de rede para a qual esse cmdlet define.

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

-NetworkInterface

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

Tipo:PSNetworkInterface
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
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 de IP da interface de rede. Os valores aceitáveis para este 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 para associar a essa configuração de IP da interface 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 para associar a essa 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

-Subnet

Especifica um objeto de sub-rede . Esse cmdlet cria uma referência a uma sub-rede na qual essa configuração de IP da interface 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

Esse cmdlet cria uma referência a uma sub-rede na qual essa configuração de IP da interface 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

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Saídas

PSNetworkInterface

Observações

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