Set-AzNetworkInterface

  • Referenz
Modul:
Az.Network

Aktualisiert eine Netzwerkschnittstelle.

Syntax

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

Beschreibung

Das Set-AzNetworkInterface aktualisiert eine Netzwerkschnittstelle.

Beispiele

Beispiel 1: Konfigurieren einer Netzwerkschnittstelle

$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 diesem Beispiel wird eine Netzwerkschnittstelle konfiguriert. Der erste Befehl ruft eine Netzwerkschnittstelle namens NetworkInterface1 in der Ressourcengruppe ResourceGroup1 ab. Der zweite Befehl legt die private IP-Adresse der IP-Konfiguration fest. Der dritte Befehl legt die private IP-Zuordnungsmethode auf Static fest. Der vierte Befehl legt ein Tag auf der Netzwerkschnittstelle fest. Der fünfte Befehl verwendet die in der $Nic Variablen gespeicherten Informationen, um die Netzwerkschnittstelle festzulegen.

Beispiel 2: Ändern von DNS-Einstellungen auf einer Netzwerkschnittstelle

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

Der erste Befehl ruft eine Netzwerkschnittstelle mit dem Namen NetworkInterface1 ab, die innerhalb der Ressourcengruppe ResourceGroup1 vorhanden ist. Der zweite Befehl fügt dieser Schnittstelle DNS-Server 192.168.1.100 hinzu. Der dritte Befehl wendet diese Änderungen auf die Netzwerkschnittstelle an. Um einen DNS-Server zu entfernen, folgen Sie den oben aufgeführten Befehlen, ersetzen ". Hinzufügen" mit ". Entfernen" im zweiten Befehl.

Beispiel 3: Aktivieren der IP-Weiterleitung auf einer Netzwerkschnittstelle

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

Der erste Befehl ruft eine vorhandene Netzwerkschnittstelle namens NetworkInterface1 ab und speichert sie in der $nic Variablen. Der zweite Befehl ändert den IP-Weiterleitungswert auf "true". Schließlich wendet der dritte Befehl die Änderungen auf die Netzwerkschnittstelle an. Um die IP-Weiterleitung auf einer Netzwerkschnittstelle zu deaktivieren, folgen Sie dem Beispiel, aber achten Sie darauf, den zweiten Befehl in "$nic" zu ändern. EnableIPForwarding = 0".

Beispiel 4: Ändern des Subnetzes einer Netzwerkschnittstelle

$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

Der erste Befehl ruft die Netzwerkschnittstelle NetworkInterface1 ab und speichert sie in der $nic Variablen. Der zweite Befehl ruft das virtuelle Netzwerk ab, das dem Subnetz zugeordnet ist, dem die Netzwerkschnittstelle zugeordnet wird. Der zweite Befehl ruft das Subnetz ab und speichert es in der variablen $subnet 2. Der dritte Befehl hat die primäre private IP-Adresse der Netzwerkschnittstelle mit dem neuen Subnetz verknüpft. Schließlich hat der letzte Befehl diese Änderungen auf die Netzwerkschnittstelle angewendet.

Hinweis

Die IP-Konfigurationen müssen dynamisch sein, bevor Sie das Subnetz ändern können. Wenn Sie über statische IP-Konfigurationen verfügen, ändern Sie sie dann in "dynamisch", bevor Sie fortfahren.

Hinweis

Wenn die Netzwerkschnittstelle über mehrere IP-Konfigurationen verfügt, muss der vierte Befehl für alle diese IP-Konfigurationen ausgeführt werden, bevor der endgültige Set-AzNetworkInterface-Befehl ausgeführt wird. Dies kann wie im vierten Befehl erfolgen, aber durch Ersetzen von "0" durch die entsprechende Zahl. Wenn eine Netzwerkschnittstelle N-IP-Konfigurationen aufweist, müssen N-1 dieser Befehle vorhanden sein.

Beispiel 5: Zuordnen/Aufheben der Zuordnung einer Netzwerksicherheitsgruppe zu einer Netzwerkschnittstelle

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

Der erste Befehl ruft eine vorhandene Netzwerkschnittstelle namens NetworkInterface1 ab und speichert sie in der $nic Variablen. Der zweite Befehl ruft eine vorhandene Netzwerksicherheitsgruppe namens MyNSG ab und speichert sie in der variablen $nsg. Der dritte Befehl weist dem $nic die $nsg zu. Schließlich wendet der vierte Befehl die Änderungen auf die Netzwerkschnittstelle an. Um Netzwerksicherheitsgruppen von einer Netzwerkschnittstelle zu trennen, ersetzen Sie einfach $nsg im dritten Befehl durch $null.

Parameter

-AsJob

Cmdlet im Hintergrund ausführen

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NetworkInterface

Gibt ein Netzwerkschnittstellenobjekt an, das den Zustand darstellt, auf den die Netzwerkschnittstelle festgelegt werden soll.

Typ:PSNetworkInterface
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

PSNetworkInterface

Ausgaben

PSNetworkInterface