Set-AzNetworkInterface

Uppdateringar ett nätverksgränssnitt.

Syntax

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

Description

Set-AzNetworkInterface uppdaterar ett nätverksgränssnitt.

Exempel

Exempel 1: Konfigurera ett nätverksgränssnitt

$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

Det här exemplet konfigurerar ett nätverksgränssnitt. Det första kommandot hämtar ett nätverksgränssnitt med namnet NetworkInterface1 i resursgruppen ResourceGroup1. Det andra kommandot anger IP-konfigurationens privata IP-adress. Det tredje kommandot anger den privata IP-allokeringsmetoden till Statisk. Det fjärde kommandot anger en tagg i nätverksgränssnittet. Det femte kommandot använder informationen som lagras i variabeln $Nic för att ange nätverksgränssnittet.

Exempel 2: Ändra DNS-inställningar i ett nätverksgränssnitt

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

Det första kommandot hämtar ett nätverksgränssnitt med namnet NetworkInterface1 som finns i resursgruppen ResourceGroup1. Det andra kommandot lägger till DNS-servern 192.168.1.100 i det här gränssnittet. Det tredje kommandot tillämpar dessa ändringar på nätverksgränssnittet. Om du vill ta bort en DNS-server följer du kommandona ovan, men ersätter ". Lägg till med ". Ta bort" i det andra kommandot.

Exempel 3: Aktivera IP-vidarebefordran i ett nätverksgränssnitt

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

Det första kommandot hämtar ett befintligt nätverksgränssnitt med namnet NetworkInterface1 och lagrar det i variabeln $nic. Det andra kommandot ändrar VÄRDET för IP-vidarebefordring till true. Slutligen tillämpar det tredje kommandot ändringarna i nätverksgränssnittet. Om du vill inaktivera IP-vidarebefordran i ett nätverksgränssnitt följer du exempelexemplet, men se till att ändra det andra kommandot till "$nic. EnableIPForwarding = 0".

Exempel 4: Ändra undernätet för ett nätverksgränssnitt

$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

Det första kommandot hämtar nätverksgränssnittet NetworkInterface1 och lagrar det i variabeln $nic. Det andra kommandot hämtar det virtuella nätverket som är associerat med det undernät som nätverksgränssnittet ska associeras med. Det andra kommandot hämtar undernätet och lagrar det i variabeln $subnet 2. Det tredje kommandot associerade nätverksgränssnittets primära privata IP-adress med det nya undernätet. Slutligen tillämpade det senaste kommandot dessa ändringar i nätverksgränssnittet.

Kommentar

IP-konfigurationerna måste vara dynamiska innan du kan ändra undernätet. Om du har statiska IP-konfigurationer ändrar du sedan till dynamisk innan du fortsätter.

Kommentar

Om nätverksgränssnittet har flera IP-konfigurationer måste det fjärde kommandot utföras för alla dessa IP-konfigurationer innan det slutliga Set-AzNetworkInterface-kommandot körs. Detta kan göras som i det fjärde kommandot men genom att ersätta "0" med lämpligt tal. Om ett nätverksgränssnitt har N IP-konfigurationer måste N-1 av dessa kommandon finnas.

Exempel 5: Associera/koppla en nätverkssäkerhetsgrupp till ett nätverksgränssnitt

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

Det första kommandot hämtar ett befintligt nätverksgränssnitt med namnet NetworkInterface1 och lagrar det i variabeln $nic. Det andra kommandot hämtar en befintlig nätverkssäkerhetsgrupp med namnet MyNSG och lagrar den i variabeln $nsg. Det tredje kommandot tilldelar $nsg till $nic. Slutligen tillämpar det fjärde kommandot ändringarna i nätverksgränssnittet. Om du vill koppla bort nätverkssäkerhetsgrupper från ett nätverksgränssnitt ersätter du enkelt $nsg i det tredje kommandot med $null.

Parametrar

-AsJob

Kör cmdlet i bakgrunden

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

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

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

-NetworkInterface

Anger ett nätverksgränssnittsobjekt som representerar det tillstånd som nätverksgränssnittet ska anges till.

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

Indata

PSNetworkInterface

Utdata

PSNetworkInterface