Compartilhar via

Set-AzNetworkInterfaceIpConfig

  • Referência
Módulo:
Az.Network

Atualiza uma configuração de IP para uma interface 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 a armazenam 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 da configuração de IP primário ipconfig1 como 10.0.0.11. Por fim, o último comando atualiza a interface de rede, garantindo que as alterações tenham sido feitas com sucesso.

Exemplo 2: Associando 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 do 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 da configuração de IP primário ipconfig1 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 sucesso.

Exemplo 3: desassociar uma configuração de IP a 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 da configuração de IP ipconfig1 como nulo e desassociado do adaptador de rede. Por fim, o último comando atualiza a interface de rede, garantindo que as alterações tenham sido feitas com sucesso.

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: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: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: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: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 do Gateway Load Balancer.

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 do adaptador 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 do adaptador 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 à qual essa configuração de IP do adaptador 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 regras 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 é definido.

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

Esse cmdlet cria 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

PSNetworkInterface

String[]

PSBackendAddressPool[]

PSInboundNatRule[]

PSApplicationGatewayBackendAddressPool[]

PSApplicationSecurityGroup[]

Saídas

PSNetworkInterface

Observações

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