az devops project
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 project command. Learn more about extensions.
Manage team projects.
Commands
Name | Description | Type | Status |
---|---|---|---|
az devops project create |
Create a team project. |
Extension | GA |
az devops project delete |
Delete team project. |
Extension | GA |
az devops project list |
List team projects. |
Extension | GA |
az devops project show |
Show team project. |
Extension | GA |
az devops project create
Create a team project.
az devops project create --name
[--description]
[--detect {false, true}]
[--open]
[--org --organization]
[--process]
[--source-control {git, tfvc}]
[--visibility {private, public}]
Required Parameters
Name of the new project.
Optional Parameters
The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.
Description for the new project.
Automatically detect organization.
Property | Value |
---|---|
Accepted values: | false, true |
Open the team project in the default web browser.
Property | Value |
---|---|
Default value: | False |
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/
.
Process to use. Default if not specified.
Source control type of the initial code repository created.
Property | Value |
---|---|
Default value: | git |
Accepted values: | git, tfvc |
Project visibility.
Property | Value |
---|---|
Default value: | private |
Accepted values: | private, public |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az devops project delete
Delete team project.
az devops project delete --id
[--detect {false, true}]
[--org --organization]
[--yes]
Required Parameters
The id of the project to delete.
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/
.
Do not prompt for confirmation.
Property | Value |
---|---|
Default value: | False |
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az devops project list
List team projects.
az devops project list [--continuation-token]
[--detect {false, true}]
[--get-default-team-image-url {false, true}]
[--org --organization]
[--skip]
[--state-filter {all, createPending, deleted, deleting, new, unchanged, wellFormed}]
[--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.
Continuation token. This can be retrived from previous run of this command if more results are present.
Automatically detect organization.
Property | Value |
---|---|
Accepted values: | false, true |
Whether to get default team image url or not.
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/
.
Number of results to skip.
State filter.
Property | Value |
---|---|
Default value: | all |
Accepted values: | all, createPending, deleted, deleting, new, unchanged, wellFormed |
Maximum number of results to list.
Global Parameters
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |
az devops project show
Show team project.
az devops project show --project
[--detect {false, true}]
[--open]
[--org --organization]
Required Parameters
Name or ID of the project. You can configure the default project using az devops configure -d project=NAME_OR_ID. Required if not configured as default or picked up via git config.
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 |
Open the team project in the default web browser.
Property | Value |
---|---|
Default value: | False |
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
Increase logging verbosity to show all debug logs.
Property | Value |
---|---|
Default value: | False |
Show this help message and exit.
Only show errors, suppressing warnings.
Property | Value |
---|---|
Default value: | False |
Output format.
Property | Value |
---|---|
Default value: | json |
Accepted values: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath query string. See http://jmespath.org/ for more information and examples.
Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID
.
Increase logging verbosity. Use --debug for full debug logs.
Property | Value |
---|---|
Default value: | False |