Note
Access to this page requires authorization. You can try signing in or .
Access to this page requires authorization. You can try .
az repos policy work-item-linking
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 policy work-item-linking command. Learn more about extensions.
Manage work item linking policy.
Commands
| Name | Description | Type | Status |
|---|---|---|---|
| az repos policy work-item-linking create |
Create work item linking policy. |
Extension | GA |
| az repos policy work-item-linking update |
Update work item linking policy. |
Extension | GA |
az repos policy work-item-linking create
Create work item linking policy.
az repos policy work-item-linking create --blocking {false, true}
--branch
--enabled {false, true}
--repository-id
[--acquire-policy-token]
[--branch-match-type {exact, prefix}]
[--change-reference]
[--detect {false, true}]
[--org --organization]
[--project]Required Parameters
Whether the policy should be blocking or not.
| Property | Value |
|---|---|
| Accepted values: | false, true |
Branch on which this policy should be applied. For example: master.
Whether the policy is enabled or not.
| Property | Value |
|---|---|
| Accepted values: | false, true |
Id of the repository on which to apply the policy.
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 |
Determines how the branch argument is used to apply a policy. If value is 'exact', the policy will be applied on a branch which has an exact match on the --branch argument. If value is 'prefix' the policy is applied across all branch folders that match the prefix provided by the --branch argument.
| Property | Value |
|---|---|
| Default value: | exact |
| Accepted values: | exact, prefix |
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/.
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.
az repos policy work-item-linking update
Update work item linking policy.
az repos policy work-item-linking update --id --policy-id
[--acquire-policy-token]
[--blocking {false, true}]
[--branch]
[--branch-match-type {exact, prefix}]
[--change-reference]
[--detect {false, true}]
[--enabled {false, true}]
[--org --organization]
[--project]
[--repository-id]Required Parameters
ID of the policy.
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 |
Whether the policy should be blocking or not.
| Property | Value |
|---|---|
| Accepted values: | false, true |
Branch on which this policy should be applied. For example: master.
Determines how the branch argument is used to apply a policy. If value is 'exact', the policy will be applied on a branch which has an exact match on the --branch argument. If value is 'prefix' the policy is applied across all branch folders that match the prefix provided by the --branch argument.
| Property | Value |
|---|---|
| Accepted values: | exact, prefix |
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 |
Whether the policy is enabled 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/.
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.
Id of the repository on which to apply the policy.
Feedback
Was this page helpful?