Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
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
| Name | Description | Type | Status |
|---|---|---|---|
| az devops user add |
Add user. |
Extension | GA |
| az devops user list |
List users in an organization [except for users which are added via AAD groups]. |
Extension | GA |
| az devops user remove |
Remove user from an organization. |
Extension | GA |
| az devops user show |
Show user details. |
Extension | GA |
| az devops user update |
Update license type for a user. |
Extension | GA |
az devops user add
Add user.
az devops user add --email-id
--license-type {advanced, earlyAdopter, express, professional, stakeholder}
[--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--send-email-invite {false, true}]Required Parameters
Email ID of the user.
License type for the user.
| Property | Value |
|---|---|
| Accepted values: | advanced, earlyAdopter, express, professional, stakeholder |
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Automatically detect organization.
| Property | Value |
|---|---|
| Accepted values: | false, true |
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/.
Whether to send email invite for new user or not.
| Property | Value |
|---|---|
| Accepted values: | false, true |
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 --organization]
[--skip]
[--top]Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Automatically detect organization.
| Property | Value |
|---|---|
| Accepted values: | false, true |
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/.
Offset: Number of records to skip.
Maximum number of users to return. Max value is 10000.
| Property | Value |
|---|---|
| Default value: | 100 |
az devops user remove
Remove user from an organization.
az devops user remove --user
[--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--yes]Required Parameters
Email ID or ID of the user.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Automatically detect organization.
| Property | Value |
|---|---|
| Accepted values: | false, true |
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/.
Do not prompt for confirmation.
| Property | Value |
|---|---|
| Default value: | False |
az devops user show
Show user details.
az devops user show --user
[--detect {false, true}]
[--org --organization]Required Parameters
Email ID or ID of the user.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Automatically detect organization.
| Property | Value |
|---|---|
| Accepted values: | false, true |
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/.
az devops user update
Update license type for a user.
az devops user update --license-type {advanced, earlyAdopter, express, professional, stakeholder}
--user
[--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]Required Parameters
License type for the user.
| Property | Value |
|---|---|
| Accepted values: | advanced, earlyAdopter, express, professional, stakeholder |
Email ID or ID of the user.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Acquiring an Azure Policy token automatically for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
The related change reference ID for this resource operation.
| Property | Value |
|---|---|
| Parameter group: | Global Policy Arguments |
Automatically detect organization.
| Property | Value |
|---|---|
| Accepted values: | false, true |
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/.
Feedback
Was this page helpful?