Set-AzNetworkInterface

  • Referentie
Module:
Az.Network

Hiermee werkt u een netwerkinterface bij.

Syntax

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

Description

De Set-AzNetworkInterface werkt een netwerkinterface bij.

Voorbeelden

Voorbeeld 1: Een netwerkinterface configureren

$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 dit voorbeeld wordt een netwerkinterface geconfigureerd. Met de eerste opdracht wordt een netwerkinterface met de naam NetworkInterface1 in resourcegroep ResourceGroup1 ophaalt. Met de tweede opdracht wordt het privé-IP-adres van de IP-configuratie ingesteld. Met de derde opdracht wordt de privé-IP-toewijzingsmethode ingesteld op Statisch. Met de vierde opdracht wordt een tag ingesteld op de netwerkinterface. De vijfde opdracht gebruikt de informatie die is opgeslagen in de $Nic variabele om de netwerkinterface in te stellen.

Voorbeeld 2: DNS-instellingen op een netwerkinterface wijzigen

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

Met de eerste opdracht krijgt u een netwerkinterface met de naam NetworkInterface1 die bestaat in resourcegroep ResourceGroup1. Met de tweede opdracht wordt DNS-server 192.168.1.100 aan deze interface toegevoegd. Met de derde opdracht worden deze wijzigingen toegepast op de netwerkinterface. Als u een DNS-server wilt verwijderen, volgt u de bovenstaande opdrachten, maar vervangt u '. Voeg toe met '. Verwijder' in de tweede opdracht.

Voorbeeld 3: Doorsturen via IP inschakelen op een netwerkinterface

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

De eerste opdracht haalt een bestaande netwerkinterface met de naam NetworkInterface1 op en slaat deze op in de variabele $nic. Met de tweede opdracht wordt de waarde voor doorsturen via IP gewijzigd in waar. Ten slotte past de derde opdracht de wijzigingen toe op de netwerkinterface. Als u doorsturen via IP wilt uitschakelen op een netwerkinterface, volgt u het voorbeeldvoorbeeld, maar wijzigt u de tweede opdracht in '$nic. EnableIPForwarding = 0".

Voorbeeld 4: Het subnet van een netwerkinterface wijzigen

$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

De eerste opdracht haalt de netwerkinterface NetworkInterface1 op en slaat deze op in de $nic variabele. Met de tweede opdracht wordt het virtuele netwerk dat is gekoppeld aan het subnet waaraan de netwerkinterface wordt gekoppeld, ophaalt. Met de tweede opdracht wordt het subnet opgeslagen in de variabele $subnet 2. De derde opdracht heeft het primaire privé-IP-adres van de netwerkinterface gekoppeld aan het nieuwe subnet. Ten slotte heeft de laatste opdracht deze wijzigingen toegepast op de netwerkinterface.

Notitie

De IP-configuraties moeten dynamisch zijn voordat u het subnet kunt wijzigen. Als u statische IP-configuraties hebt, wijzigt u deze in dynamisch voordat u doorgaat.

Notitie

Als de netwerkinterface meerdere IP-configuraties heeft, moet de vierde opdracht worden uitgevoerd voor al deze IP-configuraties voordat de laatste set-AzNetworkInterface-opdracht wordt uitgevoerd. Dit kan worden gedaan zoals in de vierde opdracht, maar door '0' te vervangen door het juiste nummer. Als een netwerkinterface N IP-configuraties heeft, moet N-1 van deze opdrachten bestaan.

Voorbeeld 5: Een netwerkbeveiligingsgroep koppelen/ontkoppelen aan een netwerkinterface

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

De eerste opdracht haalt een bestaande netwerkinterface met de naam NetworkInterface1 op en slaat deze op in de variabele $nic. Met de tweede opdracht wordt een bestaande netwerkbeveiligingsgroep met de naam MyNSG opgevraagd en opgeslagen in de variabele $nsg. Met de derde opdracht wordt de $nsg toegewezen aan de $nic. Ten slotte past de vierde opdracht de wijzigingen toe op de netwerkinterface. Als u netwerkbeveiligingsgroepen wilt loskoppelen van een netwerkinterface, vervangt u $nsg in de derde opdracht door $null.

Parameters

-AsJob

Cmdlet op de achtergrond uitvoeren

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

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

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

-NetworkInterface

Hiermee geeft u een netwerkinterfaceobject aan dat de status aangeeft waarop de netwerkinterface moet worden ingesteld.

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

Invoerwaarden

PSNetworkInterface

Uitvoerwaarden

PSNetworkInterface