Compartilhar via

Set-AzNetworkInterface

  • Referência
Módulo:
Az.Network

Atualiza uma interface de rede.

Sintaxe

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

Description

O Set-AzNetworkInterface atualiza um adaptador de rede.

Exemplos

Exemplo 1: Configurar um adaptador de rede

$Nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$Nic.IpConfigurations[0].PrivateIpAddress = "10.0.1.20"
$Nic.IpConfigurations[0].PrivateIpAllocationMethod = "Static"
$Nic.Tag = @{Name = "Name"; Value = "Value"}
Set-AzNetworkInterface -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-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzNetworkInterface

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 o encaminhamento de IP em uma interface de rede

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

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-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$vnet = Get-AzVirtualNetwork -Name VNet1 -ResourceGroupName crosssubcrossversionpeering
$subnet2 = Get-AzVirtualNetworkSubnetConfig -Name Subnet2 -VirtualNetwork $vnet
$nic.IpConfigurations[0].Subnet.Id = $subnet2.Id
$nic | Set-AzNetworkInterface

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 quarto comando deverá ser feito para todas essas configurações de IP antes que o comando Set-AzNetworkInterface 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-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzNetworkInterface

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 terceiro comando atribui o $nsg ao $nic. Por fim, o quarto 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 terceiro comando 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:AzContext, 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 de interface de rede que representa o estado para o qual a interface de rede deve ser definida.

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

Entradas

PSNetworkInterface

Saídas

PSNetworkInterface