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

New-AzureQuickVM

参考

模块:: Azure

配置和创建 Azure 虚拟机。

注意

本文档中引用的 cmdlet 用于管理使用服务管理 API 的旧式 Azure 资源。若要了解用于管理 Azure 资源管理器资源的 cmdlet，请参阅 Az PowerShell 模块。

语法

New-AzureQuickVM
   [-Windows]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-AdminUsername <String>]
   [-Certificates <CertificateSettingList>]
   [-WaitForBoot]
   [-DisableWinRMHttps]
   [-EnableWinRMHttp]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

New-AzureQuickVM
   [-Linux]
   -ServiceName <String>
   [-Name <String>]
   -ImageName <String>
   [-Password <String>]
   [-ReverseDnsFqdn <String>]
   [-Location <String>]
   [-AffinityGroup <String>]
   [-LinuxUser <String>]
   [-WaitForBoot]
   [-SSHPublicKeys <SSHPublicKeyList>]
   [-SSHKeyPairs <SSHKeyPairList>]
   [-VNetName <String>]
   [-SubnetNames <String[]>]
   [-DnsSettings <DnsServer[]>]
   [-HostCaching <String>]
   [-AvailabilitySetName <String>]
   [-InstanceSize <String>]
   [-MediaLocation <String>]
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-ReservedIPName <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

说明

New-AzureQuickVM cmdlet 配置并创建 Azure 虚拟机。此 cmdlet 可以将虚拟机部署到现有的 Azure 服务中。此 cmdlet 还可以创建托管新虚拟机的 Azure 服务。

示例

示例 1：创建虚拟机

PS C:\> New-AzureQuickVM -Windows -ServiceName "ContosoService17" -Name "VirutalMachine01" -ImageName "Image07" -Password "password" -AdminUsername "AdminMain" -WaitForBoot

此命令创建在现有服务中运行 Windows 操作系统的虚拟机。该 cmdlet 基于指定的映像上的虚拟机。该命令指定 WaitForBoot 参数。因此，cmdlet 等待虚拟机启动。

示例 2：使用证书创建虚拟机

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
PS C:\> New-AzureQuickVM -Windows -ServiceName "MySvc1" -name "MyWinVM1" -ImageName "Image07" -Password "password" -AdminUserName "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] -WaitForBoot

第一个命令从存储区获取证书，并将其存储在$certs变量中。

第二个命令创建从映像在现有服务中运行 Windows 操作系统的虚拟机。默认情况下，WinRM Https 侦听器在虚拟机上启用。该命令指定 WaitForBoot 参数。因此，cmdlet 等待虚拟机启动。该命令将 WinRM 证书和 X509Certificates 上传到托管服务。

示例 3：创建运行 Linux 操作系统的虚拟机

PS C:\> New-AzureQuickVM -Linux -ServiceName "ContosoServiceLinux01" -Name "LinuxVirtualMachine01" -ImageName "LinuxImage01" -LinuxUser "RootMain" -Password "password" -Location "Central US"

此命令创建从映像运行 Linux 操作系统的虚拟机。此命令创建用于托管新虚拟机的服务。该命令指定服务的位置。

示例 4：创建虚拟机并创建用于托管新虚拟机的服务

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService03" -Name " VirtualMachine25" -ImageName $images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name

第一个命令使用 Get-AzureLocation cmdlet 获取位置，然后将其存储在$Locations数组变量中。

第二个命令使用 Get-AzureVMImage cmdlet 获取可用映像，然后将其存储在$Images数组变量中。

最后一个命令创建名为 VirtualMachine25 的大型虚拟机。虚拟机运行 Windows 操作系统。它基于$Images中的其中一个图像。该命令为新虚拟机创建名为 ContosoService03 的服务。该服务位于$Locations的位置。

示例 5：创建具有保留 IP 名称的虚拟机

PS C:\> $Locations = Get-AzureLocation
PS C:\> $Images = Get-AzureVMImage
PS C:\> New-AzureQuickVM -Windows -InstanceSize "Large" -ServiceName "ContosoService04" -Name "VirtualMachine27" -ImageName $Images[4].imagename -Password "password" -AdminUsername "AdminMain" -Location $Locations[0].name -ReservedIPName $ipName

第一个命令获取位置，然后将其存储在$Locations数组变量中。

第二个命令获取可用的图像，然后将其存储在$Images数组变量中。

最后一个命令基于$Images中的映像之一创建名为 VirtualMachine27 的虚拟机。该命令在$Locations的某个位置创建服务。虚拟机具有保留的 IP 名称，以前存储在$ipName变量中。

参数

-AdminUsername

指定此 cmdlet 在虚拟机上创建的管理员帐户的用户名。

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

-AffinityGroup

指定虚拟机的地缘组。仅当此 cmdlet 为虚拟机创建 Azure 服务时，才指定此参数或 Location 参数。

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

-AvailabilitySetName

指定此 cmdlet 在其中创建虚拟机的可用性集的名称。

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

-Certificates

指定此 cmdlet 用于创建服务的证书列表。

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

-CustomDataFile

指定虚拟机的数据文件。此 cmdlet 将文件的内容编码为 Base64。该文件的长度必须小于 64 KB。

如果来宾操作系统是 Windows 操作系统，则此 cmdlet 将此数据保存为名为 %SYSTEMDRIVE%\AzureData\CustomData.bin 的二进制文件。

如果来宾操作系统是 Linux，则此 cmdlet 使用 ovf-env.xml 文件传递数据。安装会将该文件复制到 /var/lib/waagent 目录。代理还会将 Base64 编码的数据存储在 /var/lib/waagent/CustomData 中。

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

-DisableGuestAgent

指示此 cmdlet 禁用基础结构即服务（IaaS）预配来宾代理。

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

-DisableWinRMHttps

指示此 cmdlet 在 HTTPS 上禁用 Windows 远程管理（WinRM）。默认情况下，WinRM 通过 HTTPS 启用。

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

-DnsSettings

指定定义新部署的 DNS 设置的 DNS 服务器对象的数组。若要创建 DnsServer 对象，请使用 New-AzureDns cmdlet。

Type:	DnsServer[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnableWinRMHttp

指示此 cmdlet 通过 HTTP 启用 WinRM。

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

-HostCaching

指定操作系统磁盘的主机缓存模式。有效值是：

只读
ReadWrite

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

-ImageName

指定此 cmdlet 用于创建操作系统磁盘的磁盘映像的名称。

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

-InformationAction

指定此 cmdlet 如何响应信息事件。

此参数的可接受值为：

继续
忽略
询问
SilentlyContinue
停止
暂停

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

指定信息变量。

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

-InstanceSize

指定实例的大小。有效值是：

特小型
小型
中等
大型
超大型
A5
A6
A7
A8
A9
Basic_A0
Basic_A1
Basic_A2
Basic_A3
Basic_A4
Standard_D1
Standard_D2
Standard_D3
Standard_D4
Standard_D11
Standard_D12
Standard_D13
Standard_D14

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

-Linux

指示此 cmdlet 创建基于 Linux 的虚拟机。

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

-LinuxUser

指定此 cmdlet 在虚拟机上创建的 Linux 管理帐户的用户名。

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

-Location

指定托管虚拟机的 Azure 数据中心。如果指定此参数，cmdlet 将在指定位置创建 Azure 服务。仅当此 cmdlet 为虚拟机创建 Azure 服务时，才指定此参数或 AffinityGroup 参数。

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

-MediaLocation

指定此 cmdlet 在其中创建虚拟机磁盘的 Azure 存储位置。

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

-Name

指定此 cmdlet 创建的虚拟机的名称。

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

-NoExportPrivateKey

指示此配置不会上传私钥。

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

-NoWinRMEndpoint

指示此 cmdlet 不会为虚拟机添加 WinRM 终结点。

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

-Password

指定管理帐户的密码。

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

-Profile

指定此 cmdlet 从中读取的 Azure 配置文件。如果未指定配置文件，此 cmdlet 将从本地默认配置文件中读取。

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

-ReservedIPName

指定保留 IP 名称。

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

-ReverseDnsFqdn

指定反向 DNS 查找的完全限定域名。

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

-ServiceName

指定此 cmdlet 向其添加新虚拟机或现有 Azure 服务的名称。

如果指定新服务，则此 cmdlet 会创建它。若要创建新服务，必须指定 Location 或 AffinityGroup 参数。

如果指定现有服务，请不要指定 Location 或 AffinityGroup。

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

-SSHKeyPairs

指定 SSH 密钥对。

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

-SSHPublicKeys

指定 SSH 公钥。

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

-SubnetNames

指定虚拟机子网名称的数组。

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

-VNetName

指定虚拟机的虚拟网络的名称。

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

-WaitForBoot

指示此 cmdlet 等待虚拟机到达 ReadyRole 状态。如果虚拟机达到以下状态之一，cmdlet 将失败：FailedStartingVM、ProvisioningFailed 或 ProvisioningTimeout。

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

-Windows

指示此 cmdlet 创建 Windows 虚拟机。

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

-WinRMCertificate

指定此 cmdlet 关联到 WinRM 终结点的证书。

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

-X509Certificates

指定部署到托管服务的 X509 证书数组。

Type:	X509Certificate2[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False