共用方式為

Set-AzureRmNetworkInterface

  • 參考
模組:
AzureRM.Network

設定網路介面的目標狀態。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

語法

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

Description

Set-AzureRmNetworkInterface 會設定 Azure 網路介面的目標狀態。

範例

範例 1：設定網路介面

$Nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$Nic.IpConfigurations[0].PrivateIpAddress = "10.0.1.20"
$Nic.IpConfigurations[0].PrivateIpAllocationMethod = "Static"
$Nic.Tag = @{Name = "Name"; Value = "Value"}
Set-AzureRmNetworkInterface -NetworkInterface $Nic

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

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

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

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

範例 3：在網路介面上啟用 IP 原封

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

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

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

$nic = Get-AzureRmNetworkInterface -ResourceGroupName "ResourceGroup1" -Name "NetworkInterface1"
$vnet = Get-AzureRmVirtualNetwork -Name VNet1 -ResourceGroupName crosssubcrossversionpeering
$subnet2 = Get-AzureRmVirtualNetworkSubnetConfig -Name Subnet2 -VirtualNetwork $vnet
$nic.IpConfigurations[0].Subnet.Id = $subnet2.Id
$nic | Set-AzureRmNetworkInterface

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

注意

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

注意

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

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

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

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

參數

-AsJob

在背景執行 Cmdlet

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

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

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-NetworkInterface

指定 NetworkInterface 物件，代表網路介面的目標狀態。

類型:PSNetworkInterface
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸入

PSNetworkInterface

參數：NetworkInterface （ByValue）

輸出

PSNetworkInterface