Set-AzNetworkInterfaceIpConfig
Atualiza uma configuração IP para uma interface de rede.
Syntax
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 IP para uma interface de rede.
Exemplos
1: Alterar o endereço IP de uma configuração 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 IP que precisa ser atualizada. O terceiro comando define o endereço IP privado da configuração IP primária ipconfig1 como 10.0.0.11. Finalmente, o último comando atualiza a interface de rede garantindo que as alterações tenham sido feitas com êxito.
2: Associando uma configuração 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 IP que precisa ser atualizada. O Set-AzNetworkInterfaceIpConfig define o endereço IP privado da configuração IP primária ipconfig1 como 10.0.0.11 e cria uma associação com o grupo de segurança do aplicativo recuperado. Finalmente, o último comando atualiza a interface de rede garantindo que as alterações tenham sido feitas com êxito.
3: Desassociando uma configuração 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 da configuração IP ipconfig1 como null e desassocia com a interface de rede. Finalmente, 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 ao qual essa configuração IP da interface de rede pertence.
Tipo: | PSApplicationGatewayBackendAddressPool[] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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: | String[] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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: | PSApplicationSecurityGroup[] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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: | String[] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GatewayLoadBalancerId
Especifica a ID da configuração de IP frontend do provedor do Balanceador de Carga de Gateway.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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: | PSBackendAddressPool[] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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: | String[] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 IP da interface de rede pertence.
Tipo: | PSInboundNatRule[] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerInboundNatRuleId
Especifica uma coleção de referências de regra NAT de entrada do balanceador de carga às quais essa configuração IP da interface de rede pertence.
Tipo: | String[] |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica o nome da configuração IP de rede para a qual este cmdlet é definido.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NetworkInterface
Especifica um objeto NetworkInterface . Este cmdlet adiciona uma configuração IP da interface de rede ao objeto especificado por esse parâmetro.
Tipo: | PSNetworkInterface |
Position: | Named |
valor predefinido: | None |
Necessário: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Primary
Tipo: | SwitchParameter |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateIpAddress
Especifica o endereço IP estático da configuração IP da interface de rede.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubnetId
Este cmdlet cria uma referência a uma sub-rede na qual essa configuração IP da interface de rede é criada.
Tipo: | String |
Position: | Named |
valor predefinido: | None |
Necessário: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
String[]
PSApplicationGatewayBackendAddressPool[]
Saídas
Notas
- Palavras-chave: azure, azurerm, arm, resource, management, manager, network, networking
Ligações Relacionadas
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários