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
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
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
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
String[]
PSApplicationGatewayBackendAddressPool[]
Saídas
Observações
- Palavras-chave: azure, azurerm, arm, resource, management, manager, network, networking
Links Relacionados
Azure PowerShell