New-AzureQuickVM

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

New-AzureQuickVM

Creates and provisions a new Windows Azure virtual machine.

Parameter Set: Windows
New-AzureQuickVM -AdminUsername <String> -ImageName <String> -Password <String> -ServiceName <String> -Windows [-AffinityGroup <String> ] [-AvailabilitySetName <String> ] [-Certificates <CertificateSettingList> ] [-DisableWinRMHttps] [-DnsSettings <DnsServer[]> ] [-EnableWinRMHttp] [-HostCaching <String> ] [-InstanceSize <String> ] [-Location <String> ] [-MediaLocation <String> ] [-Name <String> ] [-NoExportPrivateKey] [-NoWinRMEndpoint] [-SubnetNames <String[]> ] [-VNetName <String> ] [-WaitForBoot] [-WinRMCertificate <X509Certificate2> ] [-X509Certificates <X509Certificate2[]> ] [ <CommonParameters>]

Parameter Set: Linux
New-AzureQuickVM -ImageName <String> -Linux -LinuxUser <String> -Password <String> -ServiceName <String> [-AffinityGroup <String> ] [-AvailabilitySetName <String> ] [-DnsSettings <DnsServer[]> ] [-HostCaching <String> ] [-InstanceSize <String> ] [-Location <String> ] [-MediaLocation <String> ] [-Name <String> ] [-SSHKeyPairs <SSHKeyPairList> ] [-SSHPublicKeys <SSHPublicKeyList> ] [-SubnetNames <String[]> ] [-VNetName <String> ] [ <CommonParameters>]

This topic describes the cmdlet in the .6.19 version of the Windows Azure PowerShell module. To find out the version of the module you're using, from the Windows Azure PowerShell console, type (get-module azure).version.

The New-AzureQuickVM cmdlet sets the configuration for a new virtual machine and creates the virtual machine. You can create a new Windows Azure service for the virtual machine by specifying either the Location or AffinityGroup parameters, or deploy the new virtual machine into an existing service.

-AdminUsername<String>

Specifies the name for the administrative account to create.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-AffinityGroup<String>

Specifies the Windows Azure affinity group the virtual machine will reside in. Only valid for a new cloud service.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-AvailabilitySetName<String>

Specify the availability set to use.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Certificates<CertificateSettingList>

Specifies a certificate list to use for creating the service.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DisableWinRMHttps

Disables the Windows Remote Management (WinRM) service on https, instead of enabling it by default.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-DnsSettings<DnsServer[]>

Specifies a DNS Server object that defines the DNS settings for the new deployment. Use New-AzureDNS to create the DNS server object.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-EnableWinRMHttp

Enables the Windows Remote Management (WinRM) service on http.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-HostCaching<String>

Specifies the host caching mode to use. Supported options are: "ReadOnly" and "ReadWrite".

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ImageName<String>

Specifies the name of the operating system image to use to create the operating system disk.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-InstanceSize<String>

Specifies the size of the instance. For a list of virtual machine sizes, see Virtual Machine and Cloud Service Sizes for Windows Azure.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Linux

Creates a Linux virtual machine.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-LinuxUser<String>

Specifies the Linux administrative account name to create.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Location<String>

Specifies the Windows Azure data center location that will host the virtual machine. When specified, New-AzureQuickVM creates a new Windows Azure service in the specified location. Only valid for a new cloud service.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-MediaLocation<String>

Specifies the Windows Azure storage location to use for the virtual machine’s disks.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Name<String>

Specifies the name of the virtual machine.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-NoExportPrivateKey

Prevents the private key from being uploaded.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-NoWinRMEndpoint

Prevents the WinRM endpoint from being added.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Password<String>

Specifies the password for the administrative account.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-ServiceName<String>

Specifies the new or existing service name.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SSHKeyPairs<SSHKeyPairList>

Specifies a list of SSH key pairs already deployed in the subscription to deploy in the virtual machine.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SSHPublicKeys<SSHPublicKeyList>

Specifies a list of SSH public keys already deployed in the subscription to deploy in the virtual machine.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-SubnetNames<String[]>

Specifies a list of subnet names the virtual machine will use.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-VNetName<String>

Specifies the name of the virtual network that you want the virtual machine to use.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WaitForBoot

Waits for the virtual machine to reach the ReadyRole state. The command fails if a virtual machine enters one of the following states while the command waits:"FailedStartingVM," "ProvisioningFailed," or "ProvisioningTimeout".

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-Windows

Creates a Windows virtual machine.

Aliases	none
Required?	true
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-WinRMCertificate<X509Certificate2>

Specifies a certificate that will be associated with WinRM endpoint.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

-X509Certificates<X509Certificate2[]>

Specifies X509 certificates that will be deployed to the cloud service.

Aliases	none
Required?	false
Position?	named
Default Value	none
Accept Pipeline Input?	false
Accept Wildcard Characters?	false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see  about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

Example 1

This example creates a new Windows virtual machine in an existing service from an image. (Use Get-AzureVMImage to get a list of images.)

C:\PS>New-AzureQuickVM –Windows –ServiceName "MySvc1" –name "MyWinVM1" –ImageName $image –Password $adminPasswd 

Example 2

This example creates a new Linux virtual machine from an image, and creates a new service to host it.

C:\PS> New-AzureQuickVM –Linux –ServiceName "MySvc2" –name "MyLxVM1" –ImageName $image –LinuxUser $user –Password $adminPasswd –Location $dclocation 

Example 3

This example gets a list of data center locations and a list of virtual machine images, and then creates a new large Windows virtual machine and a new service.

C:\PS> $dclocations = Get-AzureLocationC:\PC> $images = Get-AzureVMImageC:\PS> New-AzureQuickVM –Windows –InstanceSize "Large" –ServiceName "MySvc3" –name "MyWinVM1" –ImageName $images[4].imagename –Password $adminPasswd –location $dclocations[0].name 

Related topics

Get-AzureVM

New-AzureVMConfig

Remove-AzureVM

New-AzureVM

Create or Delete Virtual Machines Using Windows Azure Cmdlets

Set Up and Manage Virtual Networks Using Windows Azure Cmdlets