Compartilhar via

Set-AzureRmNetworkInterface

  • Referência
Módulo:
AzureRM.Network

Define o estado da meta para um adaptador de rede.

Aviso

O módulo PowerShell do AzureRM 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 do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Set-AzureRmNetworkInterface
   -NetworkInterface <PSNetworkInterface>
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O Set-AzureRmNetworkInterface define o estado de meta para um adaptador de rede do Azure.

Exemplos

Exemplo 1: Configurar um adaptador de rede

$Nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$Nic.IpConfigurations[0].PrivateIpAddress = "10.0.1.20"
$Nic.IpConfigurations[0].PrivateIpAllocationMethod = "Static"
$Nic.Tag = @{Name = "Name"; Value = "Value"}
Set-AzureRmNetworkInterface -NetworkInterface $Nic

Este exemplo configura uma interface de rede. O primeiro comando obtém um adaptador de rede chamado NetworkInterface1 no grupo de recursos ResourceGroup1. O segundo comando define o endereço IP privado da configuração de IP. O terceiro comando define o método de alocação de IP privado como Estático. O quarto comando define uma marca na interface de rede. O quinto comando usa as informações armazenadas na variável $Nic para definir a interface de rede.

Exemplo 2: Alterar as configurações de DNS em um adaptador de rede

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzureRmNetworkInterface

O primeiro comando obtém um adaptador de rede chamado NetworkInterface1 que existe no grupo de recursos ResourceGroup1. O segundo comando adiciona o servidor DNS 192.168.1.100 a essa interface. O terceiro comando aplica essas alterações à interface de rede. Para remover um servidor DNS, siga os comandos listados acima, mas substitua ". Adicione" com ". Remover" no segundo comando.

Exemplo 3: Habilitar a suspensão de IP em uma interface de rede

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.EnableIPForwarding = 1
$nic | Set-AzureRmNetworkInterface

O primeiro comando obtém uma interface de rede existente chamada NetworkInterface1 e a armazena na variável $nic. O segundo comando altera o valor de encaminhamento de IP para true. Por fim, o terceiro comando aplica as alterações à interface de rede. Para desabilitar o encaminhamento de IP em uma interface de rede, siga o exemplo de exemplo, mas certifique-se de alterar o segundo comando para "$nic. EnableIPForwarding = 0".

Exemplo 4: Alterar a sub-rede de um adaptador de rede

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$vnet = Get-AzureRmVirtualNetwork -Name VNet1 -ResourceGroupName crosssubcrossversionpeering
$subnet2 = Get-AzureRmVirtualNetworkSubnetConfig -Name Subnet2 -VirtualNetwork $vnet
$nic.IpConfigurations[0].Subnet.Id = $subnet2.Id
$nic | Set-AzureRmNetworkInterface

O primeiro comando obtém a interface de rede NetworkInterface1 e a armazena na variável $nic. O segundo comando obtém a rede virtual associada à sub-rede à qual o adaptador de rede será associado. O segundo comando obtém a sub-rede e a armazena na variável $subnet 2. O terceiro comando associou o endereço IP privado primário da interface de rede à nova sub-rede. Finalmente, o último comando aplicou essas alterações na interface de rede.

Observação

As configurações de IP devem ser dinâmicas antes que você possa alterar a sub-rede. Se você tiver configurações de IP estático, altere-as para dinâmico antes de continuar.

Observação

Se o adaptador de rede tiver várias configurações de IP, o comando forth deverá ser feito para todas essas configurações de IP antes que o comando Set-AzureRmNetworkInterface final seja executado. Isso pode ser feito como no quarto comando, mas substituindo "0" pelo número apropriado. Se uma interface de rede tiver N configurações de IP, então N-1 desses comandos deve existir.

Exemplo 5: Associar/dissociar um grupo de segurança de rede a um adaptador de rede

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzureRmNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzureRmNetworkInterface

O primeiro comando obtém uma interface de rede existente chamada NetworkInterface1 e a armazena na variável $nic. O segundo comando obtém um grupo de segurança de rede existente chamado MyNSG e o armazena na variável $nsg. O quarto comando atribui o $nsg ao $nic. Por fim, o quinto comando aplica as alterações à interface de rede. Para dissociar grupos de segurança de rede de uma interface de rede, basta substituir $nsg no comando forth por $null.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
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:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NetworkInterface

Especifica um objeto NetworkInterface que representa o estado de meta de um adaptador de rede.

Tipo:PSNetworkInterface
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

PSNetworkInterface

Parâmetros: NetworkInterface (ByValue)

Saídas

PSNetworkInterface