Compartilhar via

Set-AzNetworkInterface

  • Referência
Módulo:
Az.Network

Atualiza um adaptador 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 um adaptador 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 no adaptador de rede. O quinto comando usa as informações armazenadas na variável $Nic para definir o adaptador 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 dentro do 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 ao adaptador de rede. Para remover um servidor DNS, siga os comandos listados acima, mas substitua ". Adicionar" com ". Remova" no segundo comando.

Exemplo 3: Habilitar o encaminhamento de IP em um adaptador de rede

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

O primeiro comando obtém um adaptador de rede existente chamado NetworkInterface1 e o 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 ao adaptador de rede. Para desabilitar o encaminhamento de IP em um adaptador de rede, siga o exemplo de exemplo, mas não deixe 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 o adaptador de rede NetworkInterface1 e o 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. Por fim, o último comando aplicou essas alterações no adaptador 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áticas, altere para dinâmico antes de continuar.

Nota

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 um adaptador de rede tiver configurações de N IP, n-1 desses comandos deverão 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 um adaptador de rede existente chamado NetworkInterface1 e o 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 desassociar grupos de segurança de rede de um adaptador de rede, substitua $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 o adaptador de rede deve ser definido.

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