Deploy a template using PowerShell in Azure Stack Hub

  • Article

You can use PowerShell to deploy Azure Resource Manager templates to Azure Stack Hub. This article describes how to use PowerShell to deploy a template.

Run PowerShell cmdlets

This example uses Az PowerShell cmdlets and a template stored on GitHub. The template creates a Windows Server 2012 R2 Datacenter virtual machine.

Note

Before you try this example, make sure that you've configured PowerShell for an Azure Stack Hub user.

  1. Browse the AzureStack-QuickStart-Templates repo and find the 101-simple-windows-vm template. Save the template to this location: C:\templates\azuredeploy-101-simple-windows-vm.json.

  2. Open an elevated PowerShell command prompt.

  3. Replace username and password in the following script with your user name and password, then run the script:

    # Set deployment variables
$myNum = "001" # Modify this per deployment
$RGName = "myRG$myNum"
$myLocation = "yourregion" # local for the ASDK

# Create resource group for template deployment
New-AzResourceGroup -Name $RGName -Location $myLocation

# Deploy simple IaaS template
New-AzResourceGroupDeployment `
    -Name myDeployment$myNum `
    -ResourceGroupName $RGName `
    -TemplateUri <path>\AzureStack-QuickStart-Templates\101-vm-windows-create\azuredeploy.json `
    -AdminUsername <username> `
    -AdminPassword ("<password>" | ConvertTo-SecureString -AsPlainText -Force)

    Important

    Every time you run this script, increment the value of the $myNum parameter to prevent overwriting your deployment.

  4. Open the Azure Stack Hub portal, select Browse, and then select Virtual machines to find your new virtual machine (myDeployment001).

Cancel a running template deployment

To cancel a running template deployment, use the Stop-AzResourceGroupDeployment PowerShell cmdlet.

Next steps