title | description | author | ms.topic | ms.date | ms.author | ms.reviewer | ms.lastreviewed |
---|---|---|---|---|---|---|---|
Deploy a template using PowerShell in Azure Stack Hub |
Deploy a template using PowerShell in Azure Stack Hub. |
sethmanheim |
article |
12/2/2020 |
sethm |
thoroet |
12/2/2020 |
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.
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.
-
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
. -
Open an elevated PowerShell command prompt.
-
Replace
username
andpassword
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. -
Open the Azure Stack Hub portal, select Browse, and then select Virtual machines to find your new virtual machine (myDeployment001).
This example uses AzureRM 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.
-
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
. -
Open an elevated PowerShell command prompt.
-
Replace
username
andpassword
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-AzureRMResourceGroup -Name $RGName -Location $myLocation # Deploy simple IaaS template New-AzureRMResourceGroupDeployment ` -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. -
Open the Azure Stack Hub portal, select Browse, and then select Virtual machines to find your new virtual machine (myDeployment001).
To cancel a running template deployment, use the Stop-AzResourceGroupDeployment
PowerShell cmdlet.