Partilhar via

Set-AzureRmNetworkInterface

  • Referência
Módulo:
AzureRM.Network

Define o estado de meta para uma interface de rede.

Aviso

O módulo AzureRM do 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.

Sintaxe

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

Description

O Set-AzureRmNetworkInterface define o estado de meta para uma interface de rede do Azure.

Exemplos

Exemplo 1: Configurar uma interface 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 uma interface de rede chamada NetworkInterface1 no grupo de recursos ResourceGroup1. O segundo comando define o endereço IP privado da configuração IP. O terceiro comando define o método de alocação de IP privado como Estático. O quarto comando define uma tag 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 uma interface 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 uma interface de rede chamada NetworkInterface1 que existe dentro do grupo de recursos ResourceGroup1. O segundo comando adiciona o servidor DNS 192.168.1.100 a esta 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 o perwading 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 IP para true. Finalmente, o terceiro comando aplica as alterações à interface de rede. Para desativar 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 uma interface 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 armazena-a na variável $nic. O segundo comando obtém a rede virtual associada à sub-rede à qual a interface de rede será associada. O segundo comando obtém a sub-rede e armazena-a 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.

Nota

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 para dinâmico antes de continuar.

Nota

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

Exemplo 5: Associar/dissociar um grupo de segurança de rede a uma interface 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. Finalmente, o quinto comando aplica as alterações à interface de rede. Para dissociar os grupos de segurança de rede de uma interface de rede, basta substituir $nsg no quarto comando por $null.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NetworkInterface

Especifica um objeto NetworkInterface que representa o estado de meta para uma interface de rede.

Tipo:PSNetworkInterface
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

PSNetworkInterface

Parâmetros: NetworkInterface (ByValue)

Saídas

PSNetworkInterface