Set-AzNetworkInterface

  • Referência
Módulo:
Az.Network

Atualiza uma interface de rede.

Syntax

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

Description

O Set-AzNetworkInterface atualiza uma interface de rede.

Exemplos

Exemplo 1: Configurar uma interface 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 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-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzNetworkInterface

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 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 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-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 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 IP, o quarto comando deve ser feito para todas essas configurações IP antes que o comando final Set-AzNetworkInterface 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-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. Finalmente, o quarto 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 terceiro comando por $null.

Parâmetros

-AsJob

Executar cmdlet em segundo plano

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NetworkInterface

Especifica um objeto de interface de rede que representa o estado para o qual a interface de rede deve ser definida.

Type:PSNetworkInterface
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

PSNetworkInterface

Saídas

PSNetworkInterface