az account

Manage Azure subscription information.

Commands

az account alias

Manage subscription alias.

az account alias create

Create Alias Subscription.

az account alias delete

Delete Alias.

az account alias list

List Alias Subscriptions.

az account alias show

Get Alias Subscription.

az account alias wait

Place the CLI in a waiting state until a condition of the account alias is met.

az account clear

Clear all subscriptions from the CLI's local cache.

az account create

Create a subscription.

az account get-access-token

Get a token for utilities to access Azure.

az account list

Get a list of subscriptions for the logged in account. By default, only 'Enabled' subscriptions from the current cloud is shown.

az account list-locations

List supported regions for the current subscription.

az account lock

Manage Azure subscription level locks.

az account lock create

Create a subscription lock.

az account lock delete

Delete a subscription lock.

az account lock list

List lock information in the subscription.

az account lock show

Show the details of a subscription lock.

az account lock update

Update a subscription lock.

az account management-group

Manage Azure Management Groups.

az account management-group check-name-availability

Check if a Management Group Name is Valid.

az account management-group create

Create a new management group.

az account management-group delete

Delete an existing management group.

az account management-group entities

Entity operations (Management Group and Subscriptions) for Management Groups.

az account management-group entities list

List all entities for the authenticated user.

az account management-group hierarchy-settings

Provide operations for hierarchy settings defined at the management group level. Settings can only be set on the root Management Group of the hierarchy.

az account management-group hierarchy-settings create

Create hierarchy settings defined at the Management Group level.

az account management-group hierarchy-settings delete

Delete the hierarchy settings defined at the Management Group level.

az account management-group hierarchy-settings list

Get all the hierarchy settings defined at the Management Group level.

az account management-group hierarchy-settings update

Update the hierarchy settings defined at the Management Group level.

az account management-group list

List all management groups.

az account management-group show

Get a specific management group.

az account management-group subscription

Subscription operations for Management Groups.

az account management-group subscription add

Add a subscription to a management group.

az account management-group subscription remove

Remove an existing subscription from a management group.

az account management-group subscription show

Show the details of a subscription under a known management group.

az account management-group subscription show-sub-under-mg

Get the subscription under a management group.

az account management-group tenant-backfill

Backfill Tenant Subscription Operations for Management Groups.

az account management-group tenant-backfill get

Get the backfill status for a tenant.

az account management-group tenant-backfill start

Start backfilling subscriptions for a tenant.

az account management-group update

Update an existing management group.

az account set

Set a subscription to be the current active subscription.

az account show

Get the details of a subscription.

az account subscription

Manage subscriptions.

az account subscription cancel

Cancel subscription.

az account subscription enable

Enable subscription.

az account subscription list

Get all subscriptions for a tenant.

az account subscription list-location

This operation provides all the locations that are available for resource providers; however, each resource provider may support a subset of this list.

az account subscription rename

Rename subscription.

az account subscription show

Get details about a specified subscription.

az account tenant

Manage tenant.

az account tenant list

Get the tenants for your account.

az account clear

Clear all subscriptions from the CLI's local cache.

To clear the current subscription, use 'az logout'.

az account clear

az account create

Create a subscription.

az account create --enrollment-account-name
                  --offer-type {MS-AZR-0017P, MS-AZR-0148P, MS-AZR-USGOV-0015P, MS-AZR-USGOV-0017P, MS-AZR-USGOV-0148P}
                  [--display-name]
                  [--owner-object-id]
                  [--owner-spn]
                  [--owner-upn]

Required Parameters

--enrollment-account-name --enrollment-account-object-id

The name of the enrollment account which should be used to create a subscription.

--offer-type

The offer type of the subscription. For example, MS-AZR-0017P (EnterpriseAgreement) and MS-AZR-0148P (EnterpriseAgreement devTest) are available.

accepted values: MS-AZR-0017P, MS-AZR-0148P, MS-AZR-USGOV-0015P, MS-AZR-USGOV-0017P, MS-AZR-USGOV-0148P

Optional Parameters

--display-name

The display name of the subscription.

--owner-object-id

The object id(s) of the owner(s) which should be granted access to the new subscription.

--owner-spn

The service principal name(s) of the owner(s) which should be granted access to the new subscription.

--owner-upn

The user principal name(s) of owner(s) who should be granted access to the new subscription.

az account get-access-token

Get a token for utilities to access Azure.

The token will be valid for at least 5 minutes with the maximum at 60 minutes. If the subscription argument isn't specified, the current account is used.

az account get-access-token [--name]
                            [--resource]
                            [--resource-type {aad-graph, arm, batch, data-lake, media, ms-graph, oss-rdbms}]
                            [--scope]
                            [--tenant]

Examples

Get an access token for the current account

az account get-access-token

Get an access token for a specific subscription

az account get-access-token --subscription 00000000-0000-0000-0000-000000000000

Get an access token for a specific tenant

az account get-access-token --tenant 00000000-0000-0000-0000-000000000000

Get an access token to use with MS Graph API

az account get-access-token --resource-type ms-graph

Optional Parameters

--name --subscription -n -s

Name or ID of subscription.

--resource

Azure resource endpoints in AAD v1.0.

--resource-type

Type of well-known resource.

accepted values: aad-graph, arm, batch, data-lake, media, ms-graph, oss-rdbms
--scope

Space-separated AAD scopes in AAD v2.0. Default to Azure Resource Manager.

--tenant -t

Tenant ID for which the token is acquired. Only available for user and service principal account, not for MSI or Cloud Shell account.

az account list

Get a list of subscriptions for the logged in account. By default, only 'Enabled' subscriptions from the current cloud is shown.

az account list [--all]
                [--refresh]

Optional Parameters

--all

List all subscriptions from all clouds, rather than just 'Enabled' ones.

--refresh

Retrieve up-to-date subscriptions from server.

az account list-locations

List supported regions for the current subscription.

az account list-locations

az account set

Set a subscription to be the current active subscription.

az account set --name

Required Parameters

--name --subscription -n -s

Name or ID of subscription.

az account show

Get the details of a subscription.

If the subscription isn't specified, shows the details of the default subscription.

az account show [--name]

Optional Parameters

--name --subscription -n -s

Name or ID of subscription.