Partilhar via

Set-AzureRmNetworkInterfaceIpConfig

  • Referência
Módulo:
AzureRM.Network

Define o estado de meta para uma configuração IP da interface de rede do Azure.

Aviso

O módulo AzureRM PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Syntax

Set-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-Subnet <PSSubnet>]
   [-PublicIpAddress <PSPublicIpAddress>]
   [-LoadBalancerBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool]>]
   [-LoadBalancerInboundNatRule <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule]>]
   [-ApplicationGatewayBackendAddressPool <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool]>]
   [-ApplicationSecurityGroup <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Set-AzureRmNetworkInterfaceIpConfig
   -Name <String>
   -NetworkInterface <PSNetworkInterface>
   [-PrivateIpAddressVersion <String>]
   [-PrivateIpAddress <String>]
   [-Primary]
   [-SubnetId <String>]
   [-PublicIpAddressId <String>]
   [-LoadBalancerBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-LoadBalancerInboundNatRuleId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationGatewayBackendAddressPoolId <System.Collections.Generic.List`1[System.String]>]
   [-ApplicationSecurityGroupId <System.Collections.Generic.List`1[System.String]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureRmNetworkInterfaceIpConfig define o estado de meta para uma configuração IP da interface de rede do Azure.

Exemplos

1: Alterar o endereço IP de uma configuração IP

$vnet = Get-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet

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

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

$nic | Set-AzureRmNetworkInterface

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-AzureRmVirtualNetwork -Name myvnet -ResourceGroupName myrg
$subnet = Get-AzureRmVirtualNetworkSubnetConfig -Name mysubnet -VirtualNetwork $vnet
$asg = Get-ApplicationSecurityGroup -Name myasg -ResourceGroupName myrg

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

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

$nic | Set-AzureRmNetworkInterface

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-AzureRmNetworkInterfaceIpConfig 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.

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:List<T>[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:List<T>[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:List<T>[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:List<T>[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:AzureRmContext, AzureCredential
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
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:List<T>[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:List<T>[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:List<T>[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:List<T>[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

PSNetworkInterface

Parâmetros: NetworkInterface (ByValue)

List<T>[[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSInboundNatRule, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationGatewayBackendAddressPool, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

List<T>[[Microsoft.Azure.Commands.Network.Models.PSApplicationSecurityGroup, Microsoft.Azure.Commands.Network, Version=6.4.1.0, Culture=neutral, PublicKeyToken=null]]

Saídas

PSNetworkInterface

Notas

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