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

az devops migrations

预览

注释

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

此命令组处于预览状态，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

管理企业实时迁移。

此命令组是 azure-devops 扩展的一部分，目前为预览版。可用性可能受限（例如，1P/允许列表的用户）。对于 ELM 迁移，--org 应该是 Azure DevOps 组织 URL（例如： https://dev.azure.com/myorg）。

命令

名称	说明	类型	Status
az devops migrations abandon	放弃迁移。	Extension	Preview
az devops migrations create	为存储库创建迁移。	Extension	Preview
az devops migrations cutover	管理迁移直接转换。	Extension	Preview
az devops migrations cutover approve	通过接受未处理的项和/或验证重新连接管道来批准直接转换。	Extension	Preview
az devops migrations cutover cancel	取消计划的直接转换。	Extension	Preview
az devops migrations cutover review	在直接转换之前查看未处理的迁移项。	Extension	Preview
az devops migrations cutover set	计划迁移的直接转换。	Extension	Preview
az devops migrations list	列出组织中的迁移。	Extension	Preview
az devops migrations pause	暂停活动迁移。	Extension	Preview
az devops migrations pipelines	管理迁移的管道重排。（预览版）。	Extension	Preview
az devops migrations pipelines delete	删除用于迁移的管道重新重排数据。（预览版）。	Extension	Preview
az devops migrations pipelines list	列出管道重新重排配置和每管道状态。	Extension	Preview
az devops migrations pipelines retry	重试失败的管道重新重排条目。（预览版）。	Extension	Preview
az devops migrations pipelines submit	提交用于重排的管道。（预览版）。	Extension	Preview
az devops migrations pipelines update	批量更新管道重新重排配置。（预览版）。	Extension	Preview
az devops migrations resume	恢复已停止的（已暂停、失败）迁移。	Extension	Preview
az devops migrations status	获取存储库的迁移状态。	Extension	Preview

az devops migrations abandon

预览

命令组“devops migrations”处于预览状态，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

放弃迁移。

将迁移移动到已放弃/失败状态;迁移记录未清除。管道重新重排数据保持不变，因此后续迁移可以重复使用它。

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

示例

放弃并保留存储库只读（默认值）。

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

放弃存储库并将存储库重新设置为读写。

az devops migrations abandon --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --remove-read-only

可选参数

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

--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/。

--remove-read-only

此外，通过发送 removeReadOnly=true 将Azure Repos存储库重新设置为读写状态。

属性	值
默认值:	False

--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

预览

命令组“devops migrations”处于预览状态，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

为存储库创建迁移。

如果未提供 --github 令牌，CLI 会检查ELM_GITHUB_TOKEN，然后运行GitHub设备流来获取令牌。

az devops migrations create [--acquire-policy-token]
                            [--agent-pool]
                            [--auto-discover --enable-auto-discover-pipelines]
                            [--change-reference]
                            [--cutover-date]
                            [--detect {false, true}]
                            [--enable-boards-gh --enable-boards-github-connection]
                            [--github-token]
                            [--org --organization]
                            [--pipeline-sc-id --pipeline-service-connection-id]
                            [--repository-id]
                            [--service-endpoint-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 --agent-pool <your-agent-pool>

创建仅限验证的迁移。

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

使用预生成的GitHub令牌或 PAT 创建。

az devops migrations create --org https://dev.azure.com/myorg --repository-id 00000000-0000-0000-0000-000000000000 --target-repository https://github.com/OrgName/RepoName --github-token <token>

可选参数

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

--acquire-policy-token

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

属性	值
参数组:	Global Policy Arguments

--agent-pool

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

--auto-discover --enable-auto-discover-pipelines

选择在直接转换时自动发现管道。默认情况下关闭。启用后，ELM 同步作业将演练源存储库，并为引用它的每个管道创建克隆定义。需要 --pipeline-service-connection-id;如果没有发现，则将其作为 no-op 运行并注册 0 个管道。管道重新重排本身始终可通过 az devops migrations pipelines submit/update 获得。

属性	值
默认值:	False

--change-reference

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

属性	值
参数组:	Global Policy Arguments

--cutover-date

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

--detect

自动检测组织结构。

属性	值
接受的值:	false, true

--enable-boards-gh --enable-boards-github-connection

选择在直接转换时预配Azure Boards GitHub连接。默认情况下关闭。在迁移运行之前，需要在目标 GitHub Enterprise 组织上安装Azure Boards GitHub应用。

属性	值
默认值:	False

--github-token

GitHub用于目标主机上的用户身份验证的用户令牌。独立于 --service-endpoint-id。如果未省略 --service-endpoint-id，CLI 会检查ELM_GITHUB_TOKEN，然后运行GitHub设备流。提供 --service-endpoint-id 时，将跳过设备流;传递 --github-token 或设置ELM_GITHUB_TOKEN以提供用户令牌。

--org --organization

--pipeline-sc-id --pipeline-service-connection-id

Project范围的GitHub服务连接 ID（GUID）在创建时为管道重新连接。与 --enable-auto-discover-pipelines 结合使用时，需要完全自动发现;在手动模式下可选（预先附加连接，以便后续管道提交调用只需要 --pipeline-ids）。

--repository-id

Azure Repos 存储库的 ID（GUID）。

--service-endpoint-id

用于将提交同步到目标的 GitHub Enterprise Server 连接的服务终结点 ID （GUID）。独立于用户身份验证：--github-token/ELM_GITHUB_TOKEN可以随此标志一起提供。设置此标志时会跳过设备流。

--skip-validation

要跳过的验证策略。接受以逗号分隔的策略名称列表（例如 AgentPoolExists、MaxFileSize）或非负整数位掩码。支持的策略名称（不区分大小写）：无， ActivePullRequestCount、PullRequestDeltaSize、AgentPoolExists、MaxFileSize、MaxPullRequestSize、MaxPushPackSize、MaxReferenceNameLength、TargetRepositoryDoesNotExist、SourceRepositoryContainsLfsObjects、SourceRepositoryNotReadOnly、BoardsGitHubConnectionProvisioning、All。

--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

预览

命令组“devops migrations”处于预览状态，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

列出组织中的迁移。

默认情况下，将返回每个存储库的最新迁移，而不考虑状态。使用 --include-all 返回完整的迁移历史记录。

az devops migrations list [--detect {false, true}]
                          [--include-all]
                          [--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-all

可选参数

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

--detect

自动检测组织结构。

属性	值
接受的值:	false, true

--include-all

返回完整迁移历史记录（每个存储库的所有记录）。默认情况下，仅返回每个存储库的最新迁移，而不考虑其状态。

属性	值
默认值:	False

--include-inactive

已放弃

选项“--include-inactive”已弃用，将在将来的版本中删除。请改用“--include-all”。

Deprecated. 请改用 --include-all。

属性	值
默认值:	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

预览

命令组“devops migrations”处于预览状态，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

暂停活动迁移。

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

预览

命令组“devops migrations”处于预览状态，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

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

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

预览

命令组“devops migrations”处于预览状态，正在开发中。参考和支持级别：https://aka.ms/CLI_refstatus

获取存储库的迁移状态。

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

反馈

此页面是否有帮助？