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

Add-AzVMNetworkInterface

将网络接口添加到虚拟机。

语法

GetNicFromNicId (默认值)

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

GetNicFromNicObject

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 通信的凭据、帐户、租户和订阅。

参数属性

类型:IAzureContextContainer
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DeleteOption

指定 VM 删除后网络接口删除选项。 选项为“分离”、“删除”

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Id

指定要添加到虚拟机的网络接口的 ID。 可以使用 Get-AzNetworkInterface cmdlet 获取网络接口。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:NicId, 网络接口标识符

参数集

GetNicFromNicId
Position:1
必需:True
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-NetworkInterface

指定网络接口。

参数属性

类型:

List<T>[INetworkInterfaceReference]

默认值:None
支持通配符:False
不显示:False

参数集

GetNicFromNicObject
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Primary

指示此 cmdlet 将网络接口添加为主接口。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

GetNicFromNicId
Position:2
必需:False
来自管道的值:False
来自管道的值(按属性名称):True
来自剩余参数的值:False

-VM

指定要向其添加网络接口的本地虚拟机对象。 若要创建虚拟机,请使用 New-AzVMConfig cmdlet。 若要获取现有虚拟机,请使用 Get-AzVM cmdlet。

参数属性

类型:PSVirtualMachine
默认值:None
支持通配符:False
不显示:False
别名:VMProfile

参数集

(All)
Position:0
必需:True
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

PSVirtualMachine

String

List<T>

SwitchParameter

输出

PSVirtualMachine