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

New-AzStackHCIVMVirtualMachine

用于创建或更新虚拟机的作。 请注意,某些属性只能在虚拟机创建期间设置。

语法

ByImageId (默认值)

New-AzStackHCIVMVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -CustomLocationId <String>
    -OsType <String>
    -ImageId <String>
    [-SubscriptionId <String>]
    [-DynamicMemoryMaximumMemoryInMb <Int64>]
    [-DynamicMemoryMinimumMemoryInMb <Int64>]
    [-DynamicMemoryTargetBuffer <Int32>]
    [-VmMemoryInMB <Int64>]
    [-VmProcessor <Int32>]
    [-VmSize <String>]
    [-IdentityType <String>]
    [-DisablePasswordAuthentication]
    [-ProvisionVMAgent]
    [-ProvisionVMConfigAgent]
    [-NicId <String[]>]
    [-NicName <String[]>]
    [-NicResourceGroup <String>]
    [-DataDiskId <String[]>]
    [-DataDiskName <String[]>]
    [-DataDiskResourceGroup <String>]
    [-AdminPassword <String>]
    [-AdminUsername <String>]
    [-ComputerName <String>]
    [-EnableTpm]
    [-SshPublicKey <String[]>]
    [-StoragePathId <String>]
    [-StoragePathName <String>]
    [-StoragePathResourceGroup <String>]
    [-SecureBootEnabled]
    [-EnableAutomaticUpdate]
    [-TimeZone <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByImageName

New-AzStackHCIVMVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -CustomLocationId <String>
    -OsType <String>
    -ImageName <String>
    [-SubscriptionId <String>]
    [-DynamicMemoryMaximumMemoryInMb <Int64>]
    [-DynamicMemoryMinimumMemoryInMb <Int64>]
    [-DynamicMemoryTargetBuffer <Int32>]
    [-VmMemoryInMB <Int64>]
    [-VmProcessor <Int32>]
    [-VmSize <String>]
    [-IdentityType <String>]
    [-DisablePasswordAuthentication]
    [-ProvisionVMAgent]
    [-ProvisionVMConfigAgent]
    [-NicId <String[]>]
    [-NicName <String[]>]
    [-NicResourceGroup <String>]
    [-DataDiskId <String[]>]
    [-DataDiskName <String[]>]
    [-DataDiskResourceGroup <String>]
    [-AdminPassword <String>]
    [-AdminUsername <String>]
    [-ComputerName <String>]
    [-EnableTpm]
    [-SshPublicKey <String[]>]
    [-StoragePathId <String>]
    [-StoragePathName <String>]
    [-StoragePathResourceGroup <String>]
    [-SecureBootEnabled]
    [-EnableAutomaticUpdate]
    [-TimeZone <String>]
    [-ImageResourceGroup <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByOsDiskId

New-AzStackHCIVMVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -CustomLocationId <String>
    -OsType <String>
    -OSDiskId <String>
    [-SubscriptionId <String>]
    [-DynamicMemoryMaximumMemoryInMb <Int64>]
    [-DynamicMemoryMinimumMemoryInMb <Int64>]
    [-DynamicMemoryTargetBuffer <Int32>]
    [-VmMemoryInMB <Int64>]
    [-VmProcessor <Int32>]
    [-VmSize <String>]
    [-IdentityType <String>]
    [-DisablePasswordAuthentication]
    [-ProvisionVMAgent]
    [-ProvisionVMConfigAgent]
    [-NicId <String[]>]
    [-NicName <String[]>]
    [-NicResourceGroup <String>]
    [-DataDiskId <String[]>]
    [-DataDiskName <String[]>]
    [-DataDiskResourceGroup <String>]
    [-AdminPassword <String>]
    [-AdminUsername <String>]
    [-ComputerName <String>]
    [-EnableTpm]
    [-SshPublicKey <String[]>]
    [-StoragePathId <String>]
    [-StoragePathName <String>]
    [-StoragePathResourceGroup <String>]
    [-SecureBootEnabled]
    [-EnableAutomaticUpdate]
    [-TimeZone <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ByOsDiskName

New-AzStackHCIVMVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -Location <String>
    -CustomLocationId <String>
    -OsType <String>
    -OSDiskName <String>
    [-SubscriptionId <String>]
    [-DynamicMemoryMaximumMemoryInMb <Int64>]
    [-DynamicMemoryMinimumMemoryInMb <Int64>]
    [-DynamicMemoryTargetBuffer <Int32>]
    [-VmMemoryInMB <Int64>]
    [-VmProcessor <Int32>]
    [-VmSize <String>]
    [-IdentityType <String>]
    [-DisablePasswordAuthentication]
    [-ProvisionVMAgent]
    [-ProvisionVMConfigAgent]
    [-NicId <String[]>]
    [-NicName <String[]>]
    [-NicResourceGroup <String>]
    [-DataDiskId <String[]>]
    [-DataDiskName <String[]>]
    [-DataDiskResourceGroup <String>]
    [-AdminPassword <String>]
    [-AdminUsername <String>]
    [-ComputerName <String>]
    [-EnableTpm]
    [-SshPublicKey <String[]>]
    [-StoragePathId <String>]
    [-StoragePathName <String>]
    [-StoragePathResourceGroup <String>]
    [-SecureBootEnabled]
    [-EnableAutomaticUpdate]
    [-TimeZone <String>]
    [-OSDiskResourceGroup <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

用于创建或更新虚拟机的作。 请注意,某些属性只能在虚拟机创建期间设置。

示例

示例 1:创建包含映像的虚拟机。

New-AzStackHCIVMVirtualMachine -Name "testVm" -OsType "Linux"  -ImageName "testImage" -VmSize "Standard_K8S_v1"  -AdminUsername "localadmin" -ComputerName "testVm"  -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}"  -Location "eastus"
Name            ResourceGroupName
----            -----------------
testVm          test-rg

此命令从库映像创建虚拟机。

示例 2:使用磁盘创建虚拟机。

New-AzStackHCIVMVirtualMachine -Name "testVm" -OsType "Linux" -OsDiskName "testOsDisk10" -VmSize "Standard_K8S_v1"  -AdminUsername "localadmin" -ComputerName "testVm" -ResourceGroupName "test-rg" -CustomLocationId "/subscriptions/{subscriptionID}/resourcegroups/{resourceGroupName}/providers/microsoft.extendedlocation/customlocations/{customLocationName}" -Location "eastus"
Name            ResourceGroupName
----            -----------------
testVm          test-rg

此命令从磁盘创建虚拟机。

参数

-AdminPassword

AdminPassword - 管理员密码

参数属性

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

参数集

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

-AdminUsername

AdminUsername - 管理员用户名

参数属性

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

参数集

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

-AsJob

以作业身份运行命令

参数属性

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

参数集

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

-ComputerName

ComputerName - 计算机的名称

参数属性

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

参数集

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

-Confirm

在运行 cmdlet 之前,提示你进行确认。

参数属性

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

参数集

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

-CustomLocationId

扩展位置的名称。

参数属性

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

参数集

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

-DataDiskId

数据磁盘 - 要以 ID 格式附加到虚拟机的数据磁盘列表。

参数属性

类型:

String[]

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

参数集

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

-DataDiskName

数据磁盘 - 要以名称格式附加到虚拟机的数据磁盘列表。

参数属性

类型:

String[]

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

参数集

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

-DataDiskResourceGroup

数据磁盘 - 数据磁盘的资源组。

参数属性

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

参数集

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

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

参数集

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

-DisablePasswordAuthentication

DisablePasswordAuthentication - 是否应禁用密码身份验证

参数属性

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

参数集

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

-DynamicMemoryMaximumMemoryInMb

最大动态内存

参数属性

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

参数集

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

-DynamicMemoryMinimumMemoryInMb

最小动态内存

参数属性

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

参数集

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

-DynamicMemoryTargetBuffer

将应在运行时为虚拟机保留的额外内存量定义为虚拟机所需的总内存的百分比。 这仅适用于启用了动态内存的虚拟系统。 此属性的范围可以是 5 到 2000。

参数属性

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

参数集

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

-EnableAutomaticUpdate

指定是否在计算机上启用 EnableAutomaticUpdates。

参数属性

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

参数集

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

-EnableTpm

用于指示是否启用 TPM

参数属性

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

参数集

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

-IdentityType

标识类型。

参数属性

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

参数集

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

-ImageId

用于创建 VM 的映像的资源 ID。

参数属性

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

参数集

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

-ImageName

要在其中创建 VM 的映像的名称。

参数属性

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

参数集

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

-ImageResourceGroup

要从中创建 VM 的映像的资源组。

参数属性

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

参数集

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

-Location

资源所在的地理位置

参数属性

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

参数集

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

-Name

虚拟机的名称

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:虚拟机名称

参数集

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

-NicId

NetworkInterfaces - 要以 ARM ID 格式附加到虚拟机的网络接口列表。

参数属性

类型:

String[]

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

参数集

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

-NicName

NetworkInterfaces - 要以名称格式附加到虚拟机的网络接口列表。

参数属性

类型:

String[]

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

参数集

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

-NicResourceGroup

NetworkInterfaces - 网络接口的资源组。

参数属性

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

参数集

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

-NoWait

异步运行命令

参数属性

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

参数集

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

-OSDiskId

OS 磁盘的资源 ID

参数属性

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

参数集

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

-OSDiskName

OS 磁盘的名称

参数属性

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

参数集

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

-OSDiskResourceGroup

OS 磁盘的资源组

参数属性

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

参数集

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

-OsType

OsType - 指定 OS 是 Linux 还是 Windows 的字符串

参数属性

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

参数集

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

-ProvisionVMAgent

用于指示是否应在虚拟机创建过程中触发 Arc for Servers 代理载入。 VM 代理默认预配。 请传递 -ProvisionVMAgent:$false 以禁用。

参数属性

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

参数集

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

-ProvisionVMConfigAgent

指示是否应在虚拟机上预配虚拟机配置代理。 如果未指定此属性,默认行为是将其设置为 true。 VM 配置代理默认预配。 请传递 -ProvisionVMConfigAgent:$false 以禁用。

参数属性

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

参数集

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

-ResourceGroupName

资源组的名称。 此名称不区分大小写。

参数属性

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

参数集

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

-SecureBootEnabled

指定是否应在虚拟机上启用安全启动。

参数属性

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

参数集

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

-SshPublicKey

PublicKeys - 用于通过 VM 进行身份验证的 SSH 公钥列表

参数属性

类型:

String[]

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

参数集

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

-StoragePathId

托管 VM 配置文件的存储容器的 ID

参数属性

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

参数集

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

-StoragePathName

托管 VM 配置文件的存储容器的名称

参数属性

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

参数集

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

-StoragePathResourceGroup

存储容器资源组。 如果未提供此值,将使用虚拟机的资源组。

参数属性

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

参数集

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

-SubscriptionId

目标订阅的 ID。

参数属性

类型:String
默认值:(Get-AzContext).Subscription.Id
支持通配符:False
不显示:False

参数集

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

-TimeZone

虚拟机的时区

参数属性

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

参数集

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

-VmMemoryInMB

虚拟机的 RAM(以 MB 为单位)

参数属性

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

参数集

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

-VmProcessor

虚拟机的处理器数

参数属性

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

参数集

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

-VmSize

VM 的大小。 可以是预定义大小或自定义。 可能的预定义大小包括 - 自定义、Standard_A2_v2、Standard_A4_v2、Standard_D16s_v3、Standard_D2s_v3、Standard_D32s_v3、Standard_D4s_v3、Standard_D8s_v3、Standard_DS13_v2、Standard_DS2_v2、Standard_DS3_v2、Standard_DS4_v2、Standard_DS5_v2、Standard_K8S2_v1、Standard_K8S3_v1、Standard_K8S4_v1、Standard_K8S5_v1、Standard_K8S_v1、Standard_NK12,Standard_NK6,Standard_NV12,StandardNv6

参数属性

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

参数集

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

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

参数集

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

CommonParameters

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

输出

IVirtualMachineInstance