az devops user

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). The extension will automatically install the first time you run an az devops user command. Learn more about extensions.

Manage users.

Commands

az devops user add	Add user.
az devops user list	List users in an organization [except for users which are added via AAD groups].
az devops user remove	Remove user from an organization.
az devops user show	Show user details.
az devops user update	Update license type for a user.

az devops user add

Add user.

az devops user add --email-id
                   --license-type {advanced, earlyAdopter, express, professional, stakeholder}
                   [--detect {false, true}]
                   [--org]
                   [--send-email-invite {false, true}]

Required Parameters

--email-id

Email ID of the user.

--license-type

License type for the user.

accepted values: advanced, earlyAdopter, express, professional, stakeholder

Optional Parameters

--detect

Automatically detect organization.

accepted values: false, true

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--send-email-invite

Whether to send email invite for new user or not.

accepted values: false, true

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devops user list

List users in an organization [except for users which are added via AAD groups].

az devops user list [--detect {false, true}]
                    [--org]
                    [--skip]
                    [--top]

Optional Parameters

--detect

Automatically detect organization.

accepted values: false, true

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--skip

Offset: Number of records to skip.

--top

Maximum number of users to return. Max value is 10000.

default value: 100

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devops user remove

Remove user from an organization.

az devops user remove --user
                      [--detect {false, true}]
                      [--org]
                      [--yes]

Required Parameters

--user

Email ID or ID of the user.

Optional Parameters

--detect

Automatically detect organization.

accepted values: false, true

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--yes -y

Do not prompt for confirmation.

default value: False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devops user show

Show user details.

az devops user show --user
                    [--detect {false, true}]
                    [--org]

Required Parameters

--user

Email ID or ID of the user.

Optional Parameters

--detect

Automatically detect organization.

accepted values: false, true

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az devops user update

Update license type for a user.

az devops user update --license-type {advanced, earlyAdopter, express, professional, stakeholder}
                      --user
                      [--detect {false, true}]
                      [--org]

Required Parameters

--license-type

License type for the user.

accepted values: advanced, earlyAdopter, express, professional, stakeholder

--user

Email ID or ID of the user.

Optional Parameters

--detect

Automatically detect organization.

accepted values: false, true

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.