Deploy a template using PowerShell in Azure Stack Hub

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