Azure AZ CLI


Your use of this download is governed by Stonebranch’s Terms of Use, which are available at


The Azure command-line interface (Azure CLI) is a set of commands used to create and manage Azure resources. The Azure CLI is available across Azure services and is designed to get you working quickly with Azure, with an emphasis on automation.

The Universal Task for Azure AZ CLI allows calling a single or a set of Azure CLI commands. 

Version Information

Template NameVersion
Azure AZ CLI1.0.0

Refer to Changelog for version history information.

Software Requirements

Software Requirements for Universal Agent

  • Universal Agent for Linux or Windows Version 7.2.x or later is required, including SAP Connector license (USAP).
  • Requires Python 3.7.0 or higher. Tested with the Universal Agent bundled Python distribution.

  • Python modules required:

    • azure-cli (v2.44.1 or higher)

Software Requirements for Universal Controller

  • Universal Controller 7.2.x or later is required.

Software Requirements for the Application to be Scheduled

  • This task has been tested with the Azure CLI Versions:
    • azure-cli-core==2.32.0
    • azure-core==1.26.2
    • azure-cli==2.44.1
    • pyOpenSSL==22.0.0

Key Features

This Universal Task provides the following key features:

The Universal Task for Azure AZ CLI allows you to schedule and Invoke Azure CLI commands.

Either a single command or a list of commands can be invoked.

No Azure CLI needs to be installed. This Universal Task uses Microsoft-maintained Python modules azure-cli.

The following functionalities can be performed:

  • Authentication
    • Authenticate with Azure using your Azure user credentials.

    • Authenticate with Azure with a service principal.
  • Actions
    • Invoke a single Azure CLI commands.
    • Invoke a list of Azure CLI commands provides via a Universal Controller Script file.
  • Logging
    • Chooses different log-levels.
  • Other
    • The Universal Task can run on any Windows or Linux Agent, without the need to install the Azure CLI.

Import Universal Template

To use the Universal Template, you first must perform the following steps.

  1. This Universal Task requires the Resolvable Credentials feature. Check that the Resolvable Credentials Permitted system property has been set to true.

  2. To import the Universal Template into your Controller, follow the instructions here.

  3. When the files have been imported successfully, refresh the Universal Templates list; the Universal Template will appear on the list.

Modifications of this integration, applied by users or customers, before or after import, might affect the support of this integration. For more information, refer to Integration Modifications.

Configure Universal Task

For the new Universal Task type, create a new task, and enter the task-specific details that were created in the Universal Template.

Input Fields

The Azure AZ CLI Universal Task contains the following input fields.

FieldInput typeValueTypeDescription

Authentication Method

RequiredAzure user credentials | Service-principalChoice

Choose how to authenticate to Azure.

  • Authenticate with Azure using your Azure user credentials.

  • Authenticate with Azure with a Service-principal.
Azure CredentialsRequired

Runtime User

Runtime Password


In Case of Azure user credentials Authentication:

Credential FieldValue in Azure

Runtime User

Azure user

Runtime Password

Azure user password

In case of Azure Service-principal Authentication:

(Azure App Registration)

Credential FieldValue in Azure

Runtime User


Runtime Password

app password
Tenant IDOptionalAzure Tenant IDTextField is only visible in case of Authentication Method "Service-principal"
Command or ScriptRequired

Command | Script

The command is provided without the key word az.


In Microsoft Azure AZ: az version

Command or Script: version

  • Command, to invoke a single Azure CLI commands.
  • Script, to invoke a list of Azure CLI commands provided via a Script in the field AZ Script.
AZ CommandOptionalSingle Azure CLI command.TextSingle Azure CLI command.
AZ ScriptOptionalScript with a list of Azure CLI commands.ScriptThe listed Azure CLI commands will be executed one after the other.
Log LevelRequiredINFO | DEBUG | WARNING | ERRORChoicePython Log Level

Task Examples 

Single Azure CLI Command

The following example invokes a single Azure CLI Command. 

The Azure CLI to be invoke is:

az version

Task Output:

Multiple Azure CLI Commands

The following example invokes two Azure CLI Commands. 

az version
az account list

Assigned Script:

Integration Modifications

Modifications applied by users or customers, before or after import, might affect the support of this integration. The following modifications are discouraged to retain the support level as applied for this integration.

  • Python code modifications should not be done.
  • Template Modifications
    • General Section
      • "Name", "Extension", "Variable Prefix", "Icon" should not be changed.
    • Universal Template Details Section
      • "Template Type", "Agent Type", "Send Extension Variables", "Always Cancel on Force Finish" should not be changed.
    • Result Processing Defaults Section
      • Success and Failure Exit codes should not be changed.
      • Success and Failure Output processing should not be changed.
    • Fields Restriction Section
      The setup of the template does not impose any restrictions. However, with respect to "Exit Code Processing Fields" section.
      • Success/Failure exit codes need to be respected.
      • In principle, as STDERR and STDOUT outputs can change in follow-up releases of this integration, they should not be considered as a reliable source for determining success or failure of a task.

Users and customers are encouraged to report defects, or feature requests at Stonebranch Support Desk.

Document References

This document references the following documents.

Document LinkDescription
Universal TemplatesUser documentation for creating, working with and understanding Universal Templates and Integrations.
Universal TasksUser documentation for creating Universal Tasks in the Universal Controller user interface.
CredentialsUser documentation for creating and working with credentials.
Resolvable Credentials Permitted PropertyUser documentation for Resolvable Credentials Permitted Property.


ut-azure-az-cli-1.0.0 (2023-02-10)

Initial Version