Set-AzNetworkInterface
更新網路介面。
語法
Default (預設值)
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配置方法設置為靜態。 第四個命令在網路介面上設定標籤。 第五個指令使用儲存在$Nic變數中的資訊來設定網路介面。
範例 2:變更網路介面上的 DNS 設定
$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.DnsSettings.DnsServers.Add("192.168.1.100")
$nic | Set-AzNetworkInterface
第一個命令會取得存在於資源群組 ResourceGroup1 內的名為 NetworkInterface1 的網路介面。 第二個命令將DNS伺服器192.168.1.100新增到此介面。 第三個命令將這些變更套用至網路介面。 若要移除 DNS 伺服器,請遵循上述命令,但將「.將“與”.Remove」。
範例 3:在網路介面上啟用 IP 轉送
$nic = Get-AzNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$nic.EnableIPForwarding = 1
$nic | Set-AzNetworkInterface
第一個命令會取得名為 NetworkInterface1 的現有網路介面,並將它儲存在 $nic 變數中。 第二個命令將IP轉送值更改為true。 最後,第三個命令將更改應用於網絡接口。 若要在網路介面上停用 IP 轉送,請遵循範例範例,但請務必將第二個命令變更為「$nic。啟用 IPForwarding = 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配置,則必須先對所有這些IP配置執行第四個命令,然後才能執行最終 Set-AzNetworkInterface 命令。 這可以像在第四個命令中一樣完成,但只需將“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 |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-DefaultProfile
用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。
參數屬性
| 類型: | IAzureContextContainer |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | AzContext, AzureRmContext, AzureCredential |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NetworkInterface
指定網路介面物件,代表網路介面應該設定為的狀態。
參數屬性
| 類型: | PSNetworkInterface |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 cmdlet 支援常見參數:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。