az repos policy merge-strategy
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 merge-strategy command. Learn more about extensions.
Manage merge strategy policy.
Commands
| Name | Description | Type | Status |
|---|---|---|---|
| az repos policy merge-strategy create |
Create merge strategy policy. |
Extension | GA |
| az repos policy merge-strategy update |
Update merge strategy policy. |
Extension | GA |
az repos policy merge-strategy create
Create merge strategy policy.
az repos policy merge-strategy create --blocking {false, true}
--branch
--enabled {false, true}
--repository-id
[--allow-no-fast-forward {false, true}]
[--allow-rebase {false, true}]
[--allow-rebase-merge {false, true}]
[--allow-squash {false, true}]
[--branch-match-type {exact, prefix}]
[--detect {false, true}]
[--org]
[--project]
[--use-squash-merge {false, true}]Required Parameters
Whether the policy should be blocking or not.
Branch on which this policy should be applied. For example: master.
Whether the policy is enabled or not.
Id of the repository on which to apply the policy.
Optional Parameters
Basic merge (no fast-forward) - Preserves nonlinear history exactly as it happened during development.
Rebase and fast-forward - Creates a linear history by replaying the source branch commits onto the target without a merge commit.
Rebase with merge commit - Creates a semi-linear history by replaying the source branch commits onto the target and then creating a merge commit.
Squash merge - Creates a linear history by condensing the source branch commits into a single new commit on the target branch.
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.
Automatically detect 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/.
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.
Option '--use-squash-merge' has been deprecated and will be removed in a future release. Use '--allow-squash' instead.
Whether to squash merge always. This option does not work for allowing other merge types.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
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.
az repos policy merge-strategy update
Update merge strategy policy.
az repos policy merge-strategy update --id
[--allow-no-fast-forward {false, true}]
[--allow-rebase {false, true}]
[--allow-rebase-merge {false, true}]
[--allow-squash {false, true}]
[--blocking {false, true}]
[--branch]
[--branch-match-type {exact, prefix}]
[--detect {false, true}]
[--enabled {false, true}]
[--org]
[--project]
[--repository-id]
[--use-squash-merge {false, true}]Required Parameters
ID of the policy.
Optional Parameters
Basic merge (no fast-forward) - Preserves nonlinear history exactly as it happened during development.
Rebase and fast-forward - Creates a linear history by replaying the source branch commits onto the target without a merge commit.
Rebase with merge commit - Creates a semi-linear history by replaying the source branch commits onto the target and then creating a merge commit.
Squash merge - Creates a linear history by condensing the source branch commits into a single new commit on the target branch.
Whether the policy should be blocking or not.
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.
Automatically detect organization.
Whether the policy is enabled or not.
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.
Option '--use-squash-merge' has been deprecated and will be removed in a future release. Use '--allow-squash' instead.
Whether to squash merge always. This option does not work for allowing other merge types.
Global Parameters
Increase logging verbosity to show all debug logs.
Show this help message and exit.
Only show errors, suppressing warnings.
Output format.
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.
