Set-AzureRmNetworkInterface
Legt den Zielzustand für eine Netzwerkschnittstelle fest.
Warnung
Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.
Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.
Syntax
Set-AzureRmNetworkInterface
-NetworkInterface <PSNetworkInterface>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>] Beschreibung
Das Set-AzureRmNetworkInterface legt den Zielzustand für eine Azure-Netzwerkschnittstelle fest.
Beispiele
Beispiel 1: Konfigurieren einer Netzwerkschnittstelle
$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 $NicIn 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-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzureRmNetworkInterfaceDer 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-Synchronisierung auf einer Netzwerkschnittstelle
$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.EnableIPForwarding = 1
$nic | Set-AzureRmNetworkInterfaceDer 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-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-AzureRmNetworkInterfaceDer 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 Befehl "Set-AzureRmNetworkInterface" 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-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzureRmNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzureRmNetworkInterfaceDer 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 Befehl "Weiter" weist dem $nic die $nsg zu. Schließlich wendet der fünfte Befehl die Änderungen auf die Netzwerkschnittstelle an. Um Netzwerksicherheitsgruppen von einer Netzwerkschnittstelle zu trennen, ersetzen Sie einfach $nsg im folgenden Befehl durch $null.
Parameter
-AsJob
Cmdlet im Hintergrund ausführen
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
| Type: | IAzureContextContainer |
| Aliases: | AzureRmContext, AzureCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NetworkInterface
Gibt ein NetworkInterface -Objekt an, das den Zielzustand für eine Netzwerkschnittstelle darstellt.
| Type: | PSNetworkInterface |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Eingaben
Parameter: NetworkInterface (ByValue)