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)이어야 합니다.

명령

Name Description 형식 상태
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 resume

중지된(일시 중지됨, 실패) 마이그레이션을 다시 시작합니다.

Extension Preview
az devops migrations status

리포지토리에 대한 마이그레이션 상태를 가져옵니다.

Extension Preview

az devops migrations abandon

미리 보기

명령 그룹 'devops 마이그레이션'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: 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 리포지토리를 다시 읽기-쓰기 상태로 설정합니다.

속성
Default value: False
--repository-id

Azure Repos 리포지토리(GUID)의 ID입니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

속성
Default value: False
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az devops migrations create

미리 보기

명령 그룹 'devops 마이그레이션'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

리포지토리에 대한 마이그레이션을 만듭니다.

--github 토큰이 제공되지 않으면 CLI는 ELM_GITHUB_TOKEN 확인한 다음 GitHub 디바이스 흐름을 실행하여 토큰을 획득합니다.

az devops migrations create [--acquire-policy-token]
                            [--agent-pool]
                            [--change-reference]
                            [--cutover-date]
                            [--detect {false, true}]
                            [--github-token]
                            [--org --organization]
                            [--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

마이그레이션 작업에 사용할 에이전트 풀 이름입니다.

--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성
매개 변수 그룹: Global Policy Arguments
--cutover-date

예약된 단독형 날짜/시간(ISO 8601).

--detect

조직을 자동으로 검색합니다.

속성
허용되는 값: false, true
--github-token

마이그레이션 권한 부여에 사용되는 GitHub 토큰입니다. --service-endpoint-id를 지정하면 무시됩니다. 생략하면 CLI는 먼저 ELM_GITHUB_TOKEN 확인한 다음 GitHub 디바이스 흐름을 실행합니다.

--org --organization

Azure DevOps 조직 URL입니다. az devops configure -d organization=ORG_URL 사용하여 기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git 구성을 통해 선택되는 경우 필수입니다. 예: https://dev.azure.com/MyOrganizationName/.

--repository-id

Azure Repos 리포지토리(GUID)의 ID입니다.

--service-endpoint-id

GitHub Enterprise Server 연결에 대한 서비스 엔드포인트 ID(GUID)입니다. 지정된 경우 서버는 GitHub 인증에 서비스 연결을 사용하고 CLI는 GitHub 디바이스 흐름을 건너뜁니다. --github-token과 함께 사용할 수 없습니다.

--skip-validation

건너뛸 유효성 검사 정책입니다. 쉼표로 구분된 정책 이름 목록(예: AgentPoolExists,MaxRepoSize) 또는 음수가 아닌 정수 비트 마스크를 허용합니다.

--target-owner-user-id

대상 리포지토리 소유자 사용자 ID입니다. 서버 쪽 토큰 기반 소유자 확인을 사용하도록 설정하면 더 이상 사용되지 않으며 무시됩니다.

--target-repository

대상 리포지토리 URL(http:// 또는 https:// 시작해야 합니다).

--validate-only

유효성 검사 전용 모드로 만듭니다(마이그레이션 전 검사만 해당).

속성
Default value: False
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az devops migrations list

미리 보기

명령 그룹 'devops 마이그레이션'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

조직의 마이그레이션을 나열합니다.

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

결과에 비활성(완료됨, 중단됨, 실패한) 마이그레이션을 포함합니다.

속성
Default value: False
--org --organization

Azure DevOps 조직 URL입니다. az devops configure -d organization=ORG_URL 사용하여 기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git 구성을 통해 선택되는 경우 필수입니다. 예: https://dev.azure.com/MyOrganizationName/.

--project

마이그레이션을 필터링하는 선택적 프로젝트 이름 또는 ID입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az devops migrations pause

미리 보기

명령 그룹 'devops 마이그레이션'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: 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

Azure DevOps 조직 URL입니다. az devops configure -d organization=ORG_URL 사용하여 기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git 구성을 통해 선택되는 경우 필수입니다. 예: https://dev.azure.com/MyOrganizationName/.

--repository-id

Azure Repos 리포지토리(GUID)의 ID입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az devops migrations resume

미리 보기

명령 그룹 'devops 마이그레이션'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: 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 설정).

속성
Default value: False
--org --organization

Azure DevOps 조직 URL입니다. az devops configure -d organization=ORG_URL 사용하여 기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git 구성을 통해 선택되는 경우 필수입니다. 예: https://dev.azure.com/MyOrganizationName/.

--repository-id

Azure Repos 리포지토리(GUID)의 ID입니다.

--validate-only

유효성 검사 전용 모드에서 다시 시작합니다.

속성
Default value: False
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False

az devops migrations status

미리 보기

명령 그룹 'devops 마이그레이션'은 미리 보기로 제공되며 개발 중입니다. 참조 및 지원 수준: 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

Azure DevOps 조직 URL입니다. az devops configure -d organization=ORG_URL 사용하여 기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git 구성을 통해 선택되는 경우 필수입니다. 예: https://dev.azure.com/MyOrganizationName/.

--repository-id

Azure Repos 리포지토리(GUID)의 ID입니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성
Default value: False
--output -o

출력 형식

속성
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성
Default value: False