你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Add-AzVMNetworkInterface

  • 参考
模块:
Az.Compute

向虚拟机添加网络接口。

语法

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>]

说明

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 删除后网络接口删除选项。 选项为“分离”、“删除”

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

-Id

指定要添加到虚拟机的网络接口的 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

输出

PSVirtualMachine