Set-AzNetworkInterface

  • 參考
模組:
Az.Network

更新 網路介面。

Syntax

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

Description

Set-AzNetworkInterface 會更新網路介面。

範例

範例 1：設定網路介面

$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

此範例會設定網路介面。 第一個命令會取得資源群組 ResourceGroup1 中名為 NetworkInterface1 的網路介面。 第二個命令會設定IP組態的私人IP位址。 第三個命令會將私人IP配置方法設定為 Static。 第四個命令會在網路介面上設定標記。 第五個命令會使用儲存在 $Nic 變數中的資訊來設定網路介面。

範例 2：變更網路介面上的 DNS 設定

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

第一個命令會取得名為 NetworkInterface1 的網路介面，其存在於資源群組 ResourceGroup1 內。 第二個命令會將 DNS 伺服器 192.168.1.100 新增至這個介面。 第三個命令會將這些變更套用至網路介面。 若要移除 DNS 伺服器，請遵循上面所列的命令，但取代 ”使用 “.移除第二個指令中的 「 。

範例 3：在網路介面上啟用 IP 轉送

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

第一個命令會取得名為 NetworkInterface1 的現有網路介面，並將其儲存在$nic變數中。 第二個命令會將IP轉送值變更為 true。 最後，第三個命令會將變更套用至網路介面。 若要停用網路介面上的IP轉送，請遵循範例範例，但請務必將第二個命令變更為 “$nic。EnableIPForwarding = 0”。

範例 4：變更網路介面的子網

$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

第一個命令會取得網路介面 NetworkInterface1，並將它儲存在 $nic 變數中。 第二個命令會取得與網路介面要關聯之子網相關聯的虛擬網路。 第二個命令會取得子網，並將其儲存在 $subnet 2 變數中。 第三個命令會將網路介面的主要私人IP位址與新的子網相關聯。 最後，最後一個命令會在網路介面上套用這些變更。

注意

IP 組態必須是動態的，才能變更子網。 如果您有靜態 IP 組態，請變更為動態，再繼續進行。

注意

如果網路介面有多個IP組態，則執行最後一個Set-AzNetworkInterface命令之前，必須先針對所有這些IP組態執行第四個命令。 這可以做為第四個命令，但將 「0」 取代為適當的數位。 如果網路介面具有 N 個 IP 組態，則這些命令中的 N-1 必須存在。

範例 5：將網路安全組關聯/解除關聯至網路介面

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

第一個命令會取得名為 NetworkInterface1 的現有網路介面，並將其儲存在$nic變數中。 第二個命令會取得名為 MyNSG 的現有網路安全組，並將它儲存在$nsg變數中。 第三個命令會將$nsg指派給$nic。 最後，第四個命令會將變更套用至網路介面。 若要將網路安全組與網路介面解除關聯，請將第三個命令中的$nsg簡單取代為 $null。

參數

-AsJob

在背景執行 Cmdlet

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

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

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

-NetworkInterface

指定網路介面物件，表示應該設定網路介面的狀態。

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

輸入

PSNetworkInterface

輸出

PSNetworkInterface