Set-AzNetworkInterface

  • Odwołanie
Moduł:
Az.Network

Aktualizacje interfejs sieciowy.

Składnia

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

Opis

Polecenie Set-AzNetworkInterface aktualizuje interfejs sieciowy.

Przykłady

Przykład 1. Konfigurowanie interfejsu sieciowego

$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

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

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 przekazywania adresów IP w interfejsie sieciowym

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

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

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ć czwarte polecenie dla wszystkich tych konfiguracji adresów IP przed wykonaniem końcowego polecenia Set-AzNetworkInterface. Można to zrobić tak, jak w czwartym poleceniu, 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-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nsg = Get-AzNetworkSecurityGroup -ResourceGroupName "ResourceGroup1" -Name "MyNSG"
$nic.NetworkSecurityGroup = $nsg
$nic | Set-AzNetworkInterface

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. Trzecie polecenie przypisuje $nsg do $nic. Na koniec czwarte polecenie stosuje zmiany w interfejsie sieciowym. Aby usunąć skojarzenie sieciowych grup zabezpieczeń z interfejsu sieciowego, zastąp $nsg w trzecim poleceniu $null.

Parametry

-AsJob

Uruchamianie polecenia cmdlet w tle

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

-DefaultProfile

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

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

-NetworkInterface

Określa obiekt interfejsu sieciowego reprezentujący stan, do którego ma być ustawiony interfejs sieciowy.

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

Dane wejściowe

PSNetworkInterface

Dane wyjściowe

PSNetworkInterface