Add-AzVMNetworkInterface

參考

模組:: Az.Compute

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

Syntax

Add-AzVMNetworkInterface
   [-VM] <PSVirtualMachine>
   [-Id] <String>
   [-Primary]
   [-DeleteOption <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

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

Description

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

範例

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

$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1"
Add-AzVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"

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

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

$VirtualMachine = Get-AzVM -ResourceGroupName "ResourceGroup11" -Name "VirtualMachine07"
Add-AzVMNetworkInterface -VM $VirtualMachine -Id "/subscriptions/46fc8ea4-2de6-4179-8ab1-365da4121af4/resourceGroups/contoso/providers/Microsoft.Network/networkInterfaces/sshNIC"
Update-AzVM -ResourceGroupName "ResourceGroup11" -VM $VirtualMachine

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

參數

-DefaultProfile

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

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

-DeleteOption

指定 VM 刪除之後的網路介面刪除選項。選項為 Detach、Delete

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

-Id

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

Type:	String
Aliases:	NicId, NetworkInterfaceId
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NetworkInterface

指定網路介面。

Type:	List<T>[INetworkInterfaceReference]
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Primary

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

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

-VM

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

Type:	PSVirtualMachine
Aliases:	VMProfile
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

輸入

PSVirtualMachine

String

List<T>[[Microsoft.Azure.Management.Internal.Network.Common.INetworkInterfaceReference, Microsoft.Azure.PowerShell.Clients.Network, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

SwitchParameter

輸出