Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
az repos pr work-item
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 repos pr work-item command. Learn more about extensions.
Manage work items associated with pull requests.
Commands
| Name | Description | Type | Status |
|---|---|---|---|
| az repos pr work-item add |
Link one or more work items to a pull request. |
Extension | GA |
| az repos pr work-item list |
List linked work items for a pull request. |
Extension | GA |
| az repos pr work-item remove |
Unlink one or more work items from a pull request. |
Extension | GA |
az repos pr work-item add
Link one or more work items to a pull request.
az repos pr work-item add --id
--work-items
[--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]Required Parameters
ID of the pull request.
IDs of the work items to link. Space separated.
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/.
az repos pr work-item list
List linked work items for a pull request.
az repos pr work-item list --id
[--detect {false, true}]
[--org --organization]Required Parameters
ID of the pull request.
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 repos pr work-item remove
Unlink one or more work items from a pull request.
az repos pr work-item remove --id
--work-items
[--acquire-policy-token]
[--change-reference]
[--detect {false, true}]
[--org --organization]Required Parameters
ID of the pull request.
IDs of the work items to unlink. Space separated.
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?