Edit

Share via

Download Azure Stack Hub tools from GitHub

  • Article

AzureStack-Tools is a GitHub repository that hosts PowerShell modules for managing and deploying resources to Azure Stack Hub. If you're planning to establish VPN connectivity, you can download these PowerShell modules to the Azure Stack Development Kit (ASDK), or to a Windows-based external client.

Note

You can also use the The Operator Access Workstation (OAW) to access the privileged endpoint (PEP), the Administrator portal for support scenarios, and Azure Stack Hub GitHub Tools. For more information see Azure Stack Hub Operator Access Workstation.

Get the tools

You use the tools using the Az PowerShell modules, or the AzureRM modules.

To get these tools, clone the GitHub repository from the az branch or download the AzureStack-Tools folder by running the following script:

# Change directory to the root directory.
cd \

# Download the tools archive.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12 
invoke-webrequest `
  https://github.com/Azure/AzureStack-Tools/archive/az.zip `
  -OutFile az.zip

# Expand the downloaded files.
expand-archive az.zip `
  -DestinationPath . `
  -Force

# Change to the tools directory.
cd AzureStack-Tools-az

Functionality provided by the modules

The AzureStack-Tools repository has PowerShell modules that support the following functionalities for Azure Stack Hub:

Functionality Description Who can use this module?
CapacityManagement Use this module to generate Performance and Capacity Dashboard of storage volumes. Cloud operators
Cloud capabilities Use this module to get the cloud capabilities of a cloud. For example, you can get cloud capabilities like API version and Azure Resource Manager resources. You can also get the VM extensions for Azure Stack Hub and Azure clouds. Cloud operators and users
Resource Manager policy for Azure Stack Hub Use this module to configure an Azure subscription or an Azure resource group with the same versioning and service availability as Azure Stack Hub. Cloud operators and users
Register with Azure Use this module to register your ASDK instance with Azure. After registering, you can download Azure Marketplace items use them in Azure Stack Hub. Cloud operators
Azure Stack Hub deployment Use this module to prepare the Azure Stack Hub host computer to deploy and redeploy by using the Azure Stack Hub virtual hard disk (VHD) image. Cloud operators
Connecting to Azure Stack Hub Use this module to configure VPN connectivity to Azure Stack Hub. Cloud operators and users
Template validator Use this module to verify if an existing or a new template can be deployed to Azure Stack Hub. Cloud operators and users

Next steps