Set-AzNetworkInterface
更新網路介面。
語法
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
類型: | SwitchParameter |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
類型: | IAzureContextContainer |
別名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
預設值: | None |
必要: | False |
接受管線輸入: | False |
接受萬用字元: | False |
-NetworkInterface
指定網路介面物件,表示應該設定網路介面的狀態。
類型: | PSNetworkInterface |
Position: | Named |
預設值: | None |
必要: | True |
接受管線輸入: | True |
接受萬用字元: | False |