Set-AzNetworkInterface

  • Riferimento
Modulo:
Az.Network

Aggiorna un'interfaccia di rete.

Sintassi

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

Descrizione

Set-AzNetworkInterface aggiorna un'interfaccia di rete.

Esempio

Esempio 1: Configurare un'interfaccia di rete

$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

In questo esempio viene configurata un'interfaccia di rete. Il primo comando ottiene un'interfaccia di rete denominata NetworkInterface1 nel gruppo di risorse ResourceGroup1. Il secondo comando imposta l'indirizzo IP privato della configurazione IP. Il terzo comando imposta il metodo di allocazione IP privato su Statico. Il quarto comando imposta un tag nell'interfaccia di rete. Il quinto comando usa le informazioni archiviate nella variabile $Nic per impostare l'interfaccia di rete.

Esempio 2: Modificare le impostazioni DNS in un'interfaccia di rete

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

Il primo comando ottiene un'interfaccia di rete denominata NetworkInterface1 esistente all'interno del gruppo di risorse ResourceGroup1. Il secondo comando aggiunge il server DNS 192.168.1.100 a questa interfaccia. Il terzo comando applica queste modifiche all'interfaccia di rete. Per rimuovere un server DNS, seguire i comandi elencati in precedenza, ma sostituire ". Aggiungere " con ". Rimuovi" nel secondo comando.

Esempio 3: Abilitare l'inoltro IP in un'interfaccia di rete

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

Il primo comando ottiene un'interfaccia di rete esistente denominata NetworkInterface1 e la archivia nella variabile $nic. Il secondo comando modifica il valore dell'inoltro IP su true. Infine, il terzo comando applica le modifiche all'interfaccia di rete. Per disabilitare l'inoltro IP in un'interfaccia di rete, seguire l'esempio, ma assicurarsi di modificare il secondo comando in "$nic. EnableIPForwarding = 0".

Esempio 4: Modificare la subnet di un'interfaccia di rete

$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

Il primo comando ottiene l'interfaccia di rete NetworkInterface1 e la archivia nella variabile $nic. Il secondo comando ottiene la rete virtuale associata alla subnet a cui verrà associata l'interfaccia di rete. Il secondo comando ottiene la subnet e la archivia nella variabile $subnet 2. Il terzo comando ha associato l'indirizzo IP privato primario dell'interfaccia di rete alla nuova subnet. Infine, l'ultimo comando ha applicato queste modifiche nell'interfaccia di rete.

Nota

Le configurazioni IP devono essere dinamiche prima di poter modificare la subnet. Se sono presenti configurazioni IP statiche, passare a dinamica prima di procedere.

Nota

Se l'interfaccia di rete ha più configurazioni IP, è necessario eseguire il quarto comando per tutte queste configurazioni IP prima dell'esecuzione del comando Set-AzNetworkInterface finale. Questa operazione può essere eseguita come nel quarto comando, ma sostituendo "0" con il numero appropriato. Se un'interfaccia di rete ha configurazioni IP N, n-1 di questi comandi deve esistere.

Esempio 5: Associare/annullare l'associazione di un gruppo di sicurezza di rete a un'interfaccia di rete

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

Il primo comando ottiene un'interfaccia di rete esistente denominata NetworkInterface1 e la archivia nella variabile $nic. Il secondo comando ottiene un gruppo di sicurezza di rete esistente denominato MyNSG e lo archivia nella variabile $nsg. Il terzo comando assegna il $nsg al $nic. Infine, il quarto comando applica le modifiche all'interfaccia di rete. Per annullare l'associazione dei gruppi di sicurezza di rete da un'interfaccia di rete, sostituire in modo semplice $nsg nel terzo comando con $null.

Parametri

-AsJob

Eseguire il cmdlet in background

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-NetworkInterface

Specifica un oggetto interfaccia di rete che rappresenta lo stato in cui deve essere impostata l'interfaccia di rete.

Tipo:PSNetworkInterface
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

PSNetworkInterface

Output

PSNetworkInterface