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 通信的凭据、帐户、租户和订阅。
参数属性
参数集
(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
指定网络接口。
参数属性
参数集
GetNicFromNicObject
Position: | 1 |
必需: | True |
来自管道的值: | True |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Primary
指示此 cmdlet 将网络接口添加为主接口。
参数属性
参数集
GetNicFromNicId
Position: | 2 |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | True |
来自剩余参数的值: | False |
-VM
指定要向其添加网络接口的本地虚拟机对象。
若要创建虚拟机,请使用 New-AzVMConfig cmdlet。
若要获取现有虚拟机,请使用 Get-AzVM cmdlet。
参数属性
参数集
(All)
Position: | 0 |
必需: | True |
来自管道的值: | True |
来自管道的值(按属性名称): | True |
来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输出