你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az devops migrations

注释

此参考是 Azure CLI 的 azure-devops 扩展的一部分（版本 2.30.0 或更高版本）。该扩展将在首次运行 az devops migrations 命令时自动安装。了解更多关于扩展程序的信息。

管理企业实时迁移。

此命令组是 azure-devops 扩展的一部分。对于 ELM 迁移，--org 应该是 Azure DevOps 组织 URL（例如： https://dev.azure.com/myorg）。

命令

名称	说明	类型	Status
az devops migrations abandon	放弃和删除迁移。	Extension	GA
az devops migrations create	为存储库创建迁移。	Extension	GA
az devops migrations cutover	管理迁移直接转换。	Extension	GA
az devops migrations cutover cancel	取消计划的直接转换。	Extension	GA
az devops migrations cutover set	计划迁移的直接转换。	Extension	GA
az devops migrations list	列出组织中的迁移。	Extension	GA
az devops migrations pause	暂停活动迁移。	Extension	GA
az devops migrations resume	恢复已停止的（已暂停、失败）迁移。	Extension	GA
az devops migrations status	获取存储库的迁移状态。	Extension	GA

az devops migrations abandon

放弃和删除迁移。

az devops migrations abandon [--acquire-policy-token]
                             [--change-reference]
                             [--detect {false, true}]
                             [--org --organization]
                             [--repository-id]
                             [--yes]

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--detect

自动检测组织结构。

属性	值
接受的值:	false, true

--org --organization

Azure DevOps组织 URL。可以使用 az devops configure -d organization=ORG_URL 配置默认组织。如果未配置为默认或未通过 git 配置选取，则为必需。示例：https://dev.azure.com/MyOrganizationName/。

--repository-id

Azure Repos 存储库的 ID（GUID）。

--yes -y

不请求确认。

属性	值
默认值:	False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az devops migrations create

为存储库创建迁移。

az devops migrations create [--acquire-policy-token]
                            [--agent-pool]
                            [--change-reference]
                            [--cutover-date]
                            [--detect {false, true}]
                            [--org --organization]
                            [--repository-id]
                            [--skip-validation]
                            [--target-owner-user-id]
                            [--target-repository]
                            [--validate-only]

示例

创建迁移。

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --target-owner-user-id OwnerUserId --agent-pool MigrationPool

创建仅限验证的迁移。

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --target-owner-user-id OwnerUserId --agent-pool MigrationPool --validate-only --skip-validation ActivePullRequestCount,PullRequestDeltaSize

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--agent-pool

用于迁移工作的代理池名称。

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--cutover-date

计划的直接转换日期/时间（ISO 8601）。

--detect

自动检测组织结构。

属性	值
接受的值:	false, true

--org --organization

--repository-id

Azure Repos 存储库的 ID（GUID）。

--skip-validation

要跳过的验证策略。接受以逗号分隔的策略名称列表（例如 AgentPoolExists、MaxRepoSize）或非负整数位掩码。

--target-owner-user-id

目标存储库所有者用户 ID。

--target-repository

目标存储库 URL（必须以 http:// 或 https:// 开头）。

--validate-only

仅在验证模式下创建（仅迁移前检查）。

属性	值
默认值:	False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az devops migrations list

列出组织中的迁移。

az devops migrations list [--detect {false, true}]
                          [--include-inactive]
                          [--org --organization]
                          [--project]

示例

列出迁移。

az devops migrations list --org https://dev.azure.com/myorg

列出所有迁移，包括非活动迁移。

az devops migrations list --org https://dev.azure.com/myorg --include-inactive

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--detect

自动检测组织结构。

属性	值
接受的值:	false, true

--include-inactive

在结果中包含非活动（已完成、已放弃、失败）迁移。

属性	值
默认值:	False

--org --organization

--project

用于筛选迁移的可选项目名称或 ID。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az devops migrations pause

暂停活动迁移。

az devops migrations pause [--acquire-policy-token]
                           [--change-reference]
                           [--detect {false, true}]
                           [--org --organization]
                           [--repository-id]

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--detect

自动检测组织结构。

属性	值
接受的值:	false, true

--org --organization

--repository-id

Azure Repos 存储库的 ID（GUID）。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az devops migrations resume

恢复已停止的（已暂停、失败）迁移。

az devops migrations resume [--acquire-policy-token]
                            [--change-reference]
                            [--detect {false, true}]
                            [--migration]
                            [--org --organization]
                            [--repository-id]
                            [--validate-only]

示例

继续使用当前模式。

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

在仅验证模式下恢复。

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --validate-only

继续迁移（清除仅验证模式）。

az devops migrations resume --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --migration

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--detect

自动检测组织结构。

属性	值
接受的值:	false, true

--migration

将成功的仅验证迁移提升到完整迁移（设置 validateOnly=false 和 statusRequested=active）。

属性	值
默认值:	False

--org --organization

--repository-id

Azure Repos 存储库的 ID（GUID）。

--validate-only

在仅验证模式下恢复。

属性	值
默认值:	False

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

az devops migrations status

获取存储库的迁移状态。

az devops migrations status [--acquire-policy-token]
                            [--change-reference]
                            [--detect {false, true}]
                            [--org --organization]
                            [--repository-id]

示例

按存储库 ID 获取迁移状态。

az devops migrations status --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000

可选参数

以下参数是可选的，但根据上下文，命令可能需要一个或多个参数才能成功执行。

--acquire-policy-token

为此资源操作自动获取Azure Policy令牌。

属性	值
参数组:	Global Policy Arguments

--change-reference

此资源操作的相关更改引用 ID。

属性	值
参数组:	Global Policy Arguments

--detect

自动检测组织结构。

属性	值
接受的值:	false, true

--org --organization

--repository-id

Azure Repos 存储库的 ID（GUID）。

全局参数

--debug

提高日志记录详细程度以显示所有调试日志。

属性	值
默认值:	False

--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误，取消显示警告。

属性	值
默认值:	False

--output -o

输出格式。

属性	值
默认值:	json
接受的值:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 查询字符串。有关更多信息和示例，请参阅 http://jmespath.org/。

--subscription

订阅的名称或 ID。可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。使用 --debug 获取完整的调试日志。

属性	值
默认值:	False

反馈

此页面是否有帮助？