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

New-AzStackHCIVMVirtualMachine

模块:

Az.StackHCIVM

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

语法

New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <String>
   -ImageId <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>]

New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <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>]
   -ImageName <String>
   [-ImageResourceGroup <String>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <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>]
   -OSDiskId <String>
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzStackHCIVMVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -Location <String>
   -CustomLocationId <String>
   -OsType <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>]
   -OSDiskName <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
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AdminUsername

AdminUsername - 管理员用户名

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-AsJob

以作业身份运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ComputerName

ComputerName - 计算机的名称

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CustomLocationId

扩展位置的名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DataDiskId

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DataDiskName

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DataDiskResourceGroup

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

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

类型:	PSObject
别名:	AzureRMContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisablePasswordAuthentication

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DynamicMemoryMaximumMemoryInMb

最大动态内存

类型:	Int64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DynamicMemoryMinimumMemoryInMb

最小动态内存

类型:	Int64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DynamicMemoryTargetBuffer

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

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableAutomaticUpdate

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-EnableTpm

用于指示是否启用 TPM

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-IdentityType

标识类型。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ImageId

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ImageName

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ImageResourceGroup

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Location

资源所在的地理位置

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Name

虚拟机的名称

类型:	String
别名:	VirtualMachineName
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-NicId

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NicName

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NicResourceGroup

NetworkInterfaces - 网络接口的资源组。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-NoWait

异步运行命令

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OSDiskId

OS 磁盘的资源 ID

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OSDiskName

OS 磁盘的名称

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-OSDiskResourceGroup

OS 磁盘的资源组

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OsType

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-ProvisionVMAgent

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProvisionVMConfigAgent

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ResourceGroupName

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

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-SecureBootEnabled

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

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SshPublicKey

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

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StoragePathId

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StoragePathName

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-StoragePathResourceGroup

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

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SubscriptionId

目标订阅的 ID。

类型:	String
Position:	Named
默认值:	(Get-AzContext).Subscription.Id
必需:	False
接受管道输入:	False
接受通配符:	False

-TimeZone

虚拟机的时区

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VmMemoryInMB

虚拟机的 RAM（以 MB 为单位）

类型:	Int64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-VmProcessor

虚拟机的处理器数

类型:	Int32
Position:	Named
默认值:	None
必需:	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
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

IVirtualMachineInstance