共用方式為


Add-AzureRmVMNetworkInterface

將網路介面新增至虛擬機。

警告

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

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

語法

Add-AzureRmVMNetworkInterface
   [-VM] <PSVirtualMachine>
   [-Id] <String>
   [-Primary]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Add-AzureRmVMNetworkInterface
   [-VM] <PSVirtualMachine>
   [-NetworkInterface] <System.Collections.Generic.List`1[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference]>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Add-AzureRmVMNetworkInterface Cmdlet 會將網路介面新增至虛擬機。 當您建立虛擬機或將介面新增至現有的虛擬機時,您可以新增介面。

範例

範例 1:將網路介面新增至新的虛擬機

PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
PS C:\> Add-AzureRmVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"

第一個命令會建立虛擬機對象,然後將它儲存在$VirtualMachine變數中。 命令會將名稱和大小指派給虛擬機。 第二個命令會將網路介面新增至儲存在 $VirtualMachine 中的虛擬機。

範例 2:將網路介面新增至現有的虛擬機

PS C:\> $VirtualMachine = Get-AzureRmVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
PS C:\> Add-AzureRmVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
PS C:\> Update-AzureRmVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

第一個命令會使用 Get-AzureRmVM Cmdlet 來取得名為 VirtualMachine07 的虛擬機。 命令會將虛擬機儲存在 $VirtualMachine 變數中。 第二個命令會將網路介面新增至儲存在 $VirtualMachine 中的虛擬機。 最後一個命令會更新儲存在 ResourceGroup11 $VirtualMachine 中的虛擬機狀態。

參數

-DefaultProfile

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

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

-Id

指定要新增至虛擬機之網路介面的標識碼。 您可以使用 Get-AzureRmNetworkInterface Cmdlet 來取得網路介面。

類型:String
別名:NicId, NetworkInterfaceId
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-NetworkInterface

指定網路介面。

類型:List<T>[INetworkInterfaceReference]
Position:1
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Primary

指出此 Cmdlet 會將網路介面新增為主要介面。

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

-VM

指定要新增網路介面的本機虛擬機物件。 若要建立虛擬機,請使用 New-AzureRmVMConfig Cmdlet。 若要取得現有的虛擬機,請使用 Get-AzureRmVM Cmdlet。

類型:PSVirtualMachine
別名:VMProfile
Position:0
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

輸入

PSVirtualMachine

String

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.Commands.Common.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null]]

SwitchParameter

輸出

PSVirtualMachine