Set-AzureRmNetworkInterface

Riferimento

Modulo:: AzureRM.Network

Imposta lo stato dell'obiettivo per un'interfaccia di rete.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

Descrizione

Set-AzureRmNetworkInterface imposta lo stato dell'obiettivo per un'interfaccia di rete di Azure.

Esempio

Esempio 1: Configurare un'interfaccia di rete

$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

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-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzureRmNetworkInterface

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'ip diwading in un'interfaccia di rete

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

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-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

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 comando forth per tutte queste configurazioni IP prima dell'esecuzione del comando Set-AzureRmNetworkInterface finale. Questa operazione può essere eseguita come nel comando in avanti, 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-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzureRmNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzureRmNetworkInterface

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 comando forth assegna il $nsg al $nic. Infine, il quinto 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 comando forth con $null.

Parametri

-AsJob

Eseguire il cmdlet in background

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

-DefaultProfile

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

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

-NetworkInterface

Specifica un oggetto NetworkInterface che rappresenta lo stato dell'obiettivo per un'interfaccia di rete.

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

Input

PSNetworkInterface

Parametri: NetworkInterface (ByValue)

Output