az devops migrations

  • Förhandsgranskning

Note

Den här referensen är en del av tillägget azure-devops för Azure CLI (version 2.30.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az devops-migreringskommando . Läs mer om tillägg.

Den här kommandogruppen är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hantera direktmigreringar för företag.

Den här kommandogruppen är en del av azure-devops-tillägget och finns i förhandsversionen. Tillgängligheten kan vara begränsad (till exempel till 1P/tillåtna användare). För ELM-migreringar bör --org vara din URL för Azure DevOps-organisationen (till exempel: https://dev.azure.com/myorg).

Kommandon

Name Description Typ Status
az devops migrations abandon

Avbryt en migrering.

 Extension Preview
az devops migrations create

Skapa en migrering för en lagringsplats.

 Extension Preview
az devops migrations cutover

Hantera snabb migrering.

 Extension Preview
az devops migrations cutover approve

Godkänn snabbkoppling genom att acceptera obearbetade objekt och/eller verifiera omkopplade pipelines.

 Extension Preview
az devops migrations cutover cancel

Avbryt en schemalagd snabb uppdatering.

 Extension Preview
az devops migrations cutover review

Granska obearbetade migreringsobjekt innan du snabbar upp.

 Extension Preview
az devops migrations cutover set

Schemalägg snabb för en migrering.

 Extension Preview
az devops migrations list

Lista migreringar i en organisation.

 Extension Preview
az devops migrations pause

Pausa en aktiv migrering.

 Extension Preview
az devops migrations pipelines

Hantera omkoppling av pipeline för migreringar. (Förhandsversion).

 Extension Preview
az devops migrations pipelines delete

Ta bort pipelinerewiringsdata för en migrering. (Förhandsversion).

 Extension Preview
az devops migrations pipelines list

Visa en lista över konfigurationer för pipelinerewiring och status per pipeline.

 Extension Preview
az devops migrations pipelines retry

Försök att göra om misslyckade pipeline-omkopplingsförsök. (Förhandsversion).

 Extension Preview
az devops migrations pipelines submit

Skicka pipelines för omkoppling. (Förhandsversion).

 Extension Preview
az devops migrations pipelines update

Konfiguration av omkoppling av pipeline för massuppdatering. (Förhandsversion).

 Extension Preview
az devops migrations resume

Återuppta en stoppad (pausad, misslyckad) migrering.

 Extension Preview
az devops migrations status

Hämta migreringsstatus för en lagringsplats.

 Extension Preview

az devops migrations abandon

Förhandsgranskning

Kommandogruppen "devops migrations" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Avbryt en migrering.

Flyttar migreringen till ett övergivet/misslyckat tillstånd. migreringsposten rensas inte. Omkoppling av pipelinedata lämnas intakt så att en efterföljande migrering kan återanvända dem.

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

Exempel

Överge och behåll lagringsplatsen skrivskyddad (standard).

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

Överge och ange lagringsplatsen tillbaka till skrivskyddad.

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--detect

Identifiera organisationen automatiskt.

Egenskap Värde
Godkända värden: false, true
--org --organization

Azure DevOps-organisationens URL. Du kan konfigurera standardorganisationen med az devops configure -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--remove-read-only

Ange också Azure-lagringsplatser lagringsplatsen tillbaka till skrivskyddat tillstånd genom att skicka removeReadOnly=true.

Egenskap Värde
Standardvärde: False
--repository-id

ID för Azure-lagringsplatser-lagringsplatsen (GUID).

--yes -y

Fråga inte efter bekräftelse.

Egenskap Värde
Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az devops migrations create

Förhandsgranskning

Kommandogruppen "devops migrations" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Skapa en migrering för en lagringsplats.

Om --github-token inte tillhandahålls kontrollerar CLI ELM_GITHUB_TOKEN och kör sedan GitHub enhetsflöde för att hämta en token.

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]

Exempel

Skapa en migrering.

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>

Skapa en verifieringsmigrering.

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

Skapa med hjälp av en förgenererad GitHub token eller 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>

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--agent-pool

Agentpoolens namn som ska användas för migreringsarbete.

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

Anmäl dig till automatisk pipelineidentifiering vid snabb användning. Inaktiverad som standard. När det är aktiverat går ELM-synkroniseringsjobbet över källlagringsplatsen och skapar klondefinitioner för varje pipeline som refererar till den. Kräver --pipeline-service-connection-id; utan identifiering körs som en no-op och registrerar 0 pipelines. Själva pipeline-omkopplingen är alltid tillgänglig via az devops-migreringspipelines submit/update.

Egenskap Värde
Standardvärde: False
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--cutover-date

Schemalagt snabbdatum/tid (ISO 8601).

--detect

Identifiera organisationen automatiskt.

Egenskap Värde
Godkända värden: false, true
--enable-boards-gh --enable-boards-github-connection

Välj att etablera Azure-tavlor GitHub anslutning vid snabbkoppling. Inaktiverad som standard. Kräver att Azure-tavlor GitHub-appen installeras på målorganisationen GitHub Enterprise innan migreringen körs.

Egenskap Värde
Standardvärde: False
--github-token

GitHub användartoken som används för verifiering av användaridentitet på målvärden. Oberoende av --service-endpoint-id. Om utelämnat och --service-endpoint-id inte har angetts kontrollerar CLI ELM_GITHUB_TOKEN och kör sedan GitHub enhetsflöde. När --service-endpoint-id tillhandahålls hoppas enhetsflödet över. skicka --github-token eller ange ELM_GITHUB_TOKEN för att ange användartoken.

--org --organization

Azure DevOps-organisationens URL. Du kan konfigurera standardorganisationen med az devops configure -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

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

Project-omfångsbegränsat GitHub tjänstanslutnings-ID (GUID) som är kopplat vid skapandetillfället för omkoppling av pipelinen. Krävs för fullständig automatisk identifiering i kombination med --enable-auto-discover-pipelines; valfritt i manuellt läge (föransluter anslutningen så att efterföljande pipelines skickar anrop behöver bara --pipeline-ids).

--repository-id

ID för Azure-lagringsplatser-lagringsplatsen (GUID).

--service-endpoint-id

Tjänstslutpunkts-ID (GUID) för den GitHub Enterprise Server-anslutning som används för att synkronisera incheckningar till målet. Oberoende av verifiering av användaridentitet: --github-token/ELM_GITHUB_TOKEN kan anges tillsammans med den här flaggan. Enhetsflödet hoppas över när den här flaggan har angetts.

--skip-validation

Valideringsprinciper att hoppa över. Accepterar antingen en kommaavgränsad lista med principnamn (till exempel AgentPoolExists, MaxFileSize) eller en icke-negativ heltalsbitmask. Principnamn som stöds (skiftlägesokänsliga): Ingen, ActivePullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, BoardsGitHubConnectionProvisioning, All.

--target-owner-user-id

Användar-ID för mållagringsplatsens ägare. Inaktuell och ignorerad när tokenbaserad ägarmatchning på serversidan är aktiverad.

--target-repository

Mållagringsplatsens URL (måste börja med http:// eller https://).

--validate-only

Skapa i endast valideringsläge (endast före migreringskontroller).

Egenskap Värde
Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az devops migrations list

Förhandsgranskning

Kommandogruppen "devops migrations" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Lista migreringar i en organisation.

Som standard returneras den senaste migreringen per lagringsplats, oavsett tillstånd. Använd --include-all för att returnera den fullständiga migreringshistoriken.

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

Exempel

Lista den senaste migreringen per lagringsplats.

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

Visa en lista över den fullständiga migreringshistoriken för varje lagringsplats.

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--detect

Identifiera organisationen automatiskt.

Egenskap Värde
Godkända värden: false, true
--include-all

Returnera den fullständiga migreringshistoriken (alla poster per lagringsplats). Som standard returneras endast den senaste migreringen per lagringsplats, oavsett dess tillstånd.

Egenskap Värde
Standardvärde: False
--include-inactive
Inaktuell

Alternativet "--include-inactive" är inaktuellt och tas bort i en framtida version. Använd "--include-all" i stället.

Deprecated. Använd --include-all i stället.

Egenskap Värde
Standardvärde: False
--org --organization

Azure DevOps-organisationens URL. Du kan konfigurera standardorganisationen med az devops configure -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--project

Valfritt projektnamn eller ID för att filtrera migreringar.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az devops migrations pause

Förhandsgranskning

Kommandogruppen "devops migrations" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Pausa en aktiv migrering.

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--detect

Identifiera organisationen automatiskt.

Egenskap Värde
Godkända värden: false, true
--org --organization

Azure DevOps-organisationens URL. Du kan konfigurera standardorganisationen med az devops configure -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID för Azure-lagringsplatser-lagringsplatsen (GUID).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az devops migrations resume

Förhandsgranskning

Kommandogruppen "devops migrations" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Återuppta en stoppad (pausad, misslyckad) migrering.

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

Exempel

Fortsätt med det aktuella läget.

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

Återuppta i valideringsläge.

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

Fortsätt migreringen (rensar valideringsläget).

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--detect

Identifiera organisationen automatiskt.

Egenskap Värde
Godkända värden: false, true
--migration

Befordra en lyckad validering till en fullständig migrering (anger validateOnly=false och statusRequested=active).

Egenskap Värde
Standardvärde: False
--org --organization

Azure DevOps-organisationens URL. Du kan konfigurera standardorganisationen med az devops configure -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID för Azure-lagringsplatser-lagringsplatsen (GUID).

--validate-only

Återuppta i valideringsläge.

Egenskap Värde
Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False

az devops migrations status

Förhandsgranskning

Kommandogruppen "devops migrations" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hämta migreringsstatus för en lagringsplats.

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

Exempel

Hämta migreringsstatus efter lagringsplats-ID.

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

Valfria parametrar

Följande parametrar är valfria, men beroende på sammanhanget kan en eller flera krävas för att kommandot ska kunna köras.

--acquire-policy-token

Hämtar en Azure Policy token automatiskt för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--change-reference

Det relaterade ändringsreferens-ID:t för den här resursåtgärden.

Egenskap Värde
Parametergrupp: Global Policy Arguments
--detect

Identifiera organisationen automatiskt.

Egenskap Värde
Godkända värden: false, true
--org --organization

Azure DevOps-organisationens URL. Du kan konfigurera standardorganisationen med az devops configure -d organization=ORG_URL. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration. Exempel: https://dev.azure.com/MyOrganizationName/.

--repository-id

ID för Azure-lagringsplatser-lagringsplatsen (GUID).

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

Egenskap Värde
Standardvärde: json
Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Egenskap Värde
Standardvärde: False