Udostępnij za pośrednictwem

Set-AzureRmNetworkInterface

  • Odwołanie
Moduł:
AzureRM.Network

Ustawia stan celu dla interfejsu sieciowego.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Ustawienie Set-AzureRmNetworkInterface ustawia stan celu dla interfejsu sieciowego platformy Azure.

Przykłady

Przykład 1. Konfigurowanie interfejsu sieciowego

$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

W tym przykładzie skonfigurowaliśmy interfejs sieciowy. Pierwsze polecenie pobiera interfejs sieciowy o nazwie NetworkInterface1 w grupie zasobów ResourceGroup1. Drugie polecenie ustawia prywatny adres IP konfiguracji adresu IP. Trzecie polecenie ustawia metodę alokacji prywatnego adresu IP na statyczną. Czwarte polecenie ustawia tag w interfejsie sieciowym. Piąte polecenie używa informacji przechowywanych w zmiennej $Nic w celu ustawienia interfejsu sieciowego.

Przykład 2. Zmiana ustawień DNS w interfejsie sieciowym

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

Pierwsze polecenie pobiera interfejs sieciowy o nazwie NetworkInterface1, który istnieje w grupie zasobów ResourceGroup1. Drugie polecenie dodaje do tego interfejsu serwer DNS 192.168.1.100. Trzecie polecenie stosuje te zmiany do interfejsu sieciowego. Aby usunąć serwer DNS, postępuj zgodnie z poleceniami wymienionymi powyżej, ale zastąp ciąg ". Dodaj element " za pomocą polecenia ". Usuń" w drugim poleceniu.

Przykład 3. Włączanie obsługi adresów IP w interfejsie sieciowym

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

Pierwsze polecenie pobiera istniejący interfejs sieciowy o nazwie NetworkInterface1 i przechowuje go w zmiennej $nic. Drugie polecenie zmienia wartość przekazywania adresów IP na true. Na koniec trzecie polecenie stosuje zmiany w interfejsie sieciowym. Aby wyłączyć przekazywanie adresów IP w interfejsie sieciowym, postępuj zgodnie z przykładowym przykładem, ale pamiętaj, aby zmienić drugie polecenie na "$nic. EnableIPForwarding = 0".

Przykład 4. Zmiana podsieci interfejsu sieciowego

$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

Pierwsze polecenie pobiera interfejs sieciowy NetworkInterface1 i przechowuje go w zmiennej $nic. Drugie polecenie pobiera sieć wirtualną skojarzona z podsiecią, z którą interfejs sieciowy będzie skojarzony. Drugie polecenie pobiera podsieć i przechowuje ją w zmiennej $subnet 2. Trzecie polecenie skojarzyło podstawowy prywatny adres IP interfejsu sieciowego z nową podsiecią. Na koniec ostatnie polecenie zastosowało te zmiany w interfejsie sieciowym.

Uwaga

Konfiguracje adresów IP muszą być dynamiczne, zanim będzie można zmienić podsieć. Jeśli masz statyczne konfiguracje adresów IP, przed kontynuowaniem zmień wartość na dynamiczną.

Uwaga

Jeśli interfejs sieciowy ma wiele konfiguracji adresów IP, należy wykonać następujące polecenie dla wszystkich tych konfiguracji adresów IP przed wykonaniem końcowego polecenia Set-AzureRmNetworkInterface. Można to zrobić tak jak w wierszu polecenia, ale zastępując ciąg "0" odpowiednią liczbą. Jeśli interfejs sieciowy ma N konfiguracji adresów IP, to N-1 tych poleceń musi istnieć.

Przykład 5: Kojarzenie/usuwanie skojarzenia sieciowej grupy zabezpieczeń z interfejsem sieciowym

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

Pierwsze polecenie pobiera istniejący interfejs sieciowy o nazwie NetworkInterface1 i przechowuje go w zmiennej $nic. Drugie polecenie pobiera istniejącą sieciową grupę zabezpieczeń o nazwie MyNSG i przechowuje ją w zmiennej $nsg. Polecenie forth przypisuje $nsg do $nic. Na koniec piąte polecenie stosuje zmiany w interfejsie sieciowym. Aby usunąć skojarzenie sieciowych grup zabezpieczeń z interfejsu sieciowego, zastąp $nsg w poleceniu $null.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-NetworkInterface

Określa obiekt NetworkInterface , który reprezentuje stan celu dla interfejsu sieciowego.

Typ:PSNetworkInterface
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

PSNetworkInterface

Parametry: NetworkInterface (ByValue)

Dane wyjściowe

PSNetworkInterface