Set-AzNetworkInterfaceIpConfig
Atualiza uma configuração de 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 de IP para uma interface de rede.
Exemplos
1: Alterando 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 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 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 security group 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 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 a um pool de endereços de back-end de 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 desassociado 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 de pool de endereços de back-end de gateway de aplicativo à qual essa configuração IP de interface de rede pertence.
Type: | PSApplicationGatewayBackendAddressPool[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationGatewayBackendAddressPoolId
Especifica uma coleção de referências de pool de endereços de back-end de gateway de aplicativo à qual essa configuração IP de interface de rede pertence.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationSecurityGroup
Especifica uma coleção de referências de grupo de segurança de aplicativo à qual essa configuração IP de interface de rede pertence.
Type: | PSApplicationSecurityGroup[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ApplicationSecurityGroupId
Especifica uma coleção de referências de grupo de segurança de aplicativo à qual essa configuração IP de interface de rede pertence.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-GatewayLoadBalancerId
Especifica a ID da Configuração de Ip Front-end do Provedor de Balanceador de Carga de Gateway.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerBackendAddressPool
Especifica uma coleção de referências de pool de endereços de back-end do balanceador de carga à qual essa configuração IP de interface de rede pertence.
Type: | PSBackendAddressPool[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerBackendAddressPoolId
Especifica uma coleção de referências de pool de endereços de back-end do balanceador de carga à qual essa configuração IP de interface de rede pertence.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LoadBalancerInboundNatRule
Especifica uma coleção de referências de regra NAT (conversão de endereço de rede) de entrada do balanceador de carga à qual essa configuração IP de interface de rede pertence.
Type: | PSInboundNatRule[] |
Position: | Named |
Default value: | None |
Required: | 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 à qual essa configuração de IP de interface de rede pertence.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Especifica o nome da configuração de IP de rede para a qual esse cmdlet se define.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NetworkInterface
Especifica um objeto NetworkInterface . Esse cmdlet adiciona uma configuração IP de interface de rede ao objeto especificado por esse parâmetro.
Type: | PSNetworkInterface |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Primary
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PrivateIpAddressVersion
Especifica a versão do endereço IP de uma configuração IP de interface de rede. Os valores aceitáveis para esse parâmetro são:
- IPv4
- IPv6
Type: | String |
Accepted values: | IPv4, IPv6 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 da interface de rede.
Type: | PSPublicIpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PublicIpAddressId
Esse cmdlet cria uma referência a um endereço IP público a ser associado a essa configuração de IP da interface de rede.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Subnet
Especifica um objeto Sub-rede . Esse cmdlet cria uma referência a uma sub-rede na qual essa configuração IP de interface de rede é criada.
Type: | PSSubnet |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SubnetId
Esse cmdlet cria uma referência a uma sub-rede na qual essa configuração IP de interface de rede é criada.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
String[]
PSApplicationGatewayBackendAddressPool[]
Saídas
Observações
- Palavras-chave: azure, azurerm, arm, resource, management, manager, network, networking
Links Relacionados
Azure PowerShell
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de