az devops migrations

Vorschau

Note

Diese Referenz ist Teil der erweiterung azure-devops für die Azure CLI (Version 2.30.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az devops-Migrationsbefehl zum ersten Mal ausführen. Erfahren Sie mehr über Erweiterungen.

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Verwalten von Livemigrationen für Unternehmen.

Diese Befehlsgruppe ist Teil der Azure-devops-Erweiterung und befindet sich in der Vorschau. Die Verfügbarkeit kann eingeschränkt sein (z. B. auf 1P/zugelassene Benutzer). Bei ELM-Migrationen sollte --org Ihre Azure DevOps-Organisations-URL sein (z. B.: https://dev.azure.com/myorg).

Befehle

Name	Beschreibung	Typ	Status
az devops migrations abandon	Abbrechen und Löschen einer Migration.	Extension	Vorschau
az devops migrations create	Erstellen Sie eine Migration für ein Repository.	Extension	Vorschau
az devops migrations cutover	Verwalten des Migrations-Übernahmes.	Extension	Vorschau
az devops migrations cutover approve	Genehmigen Sie die Übernahme, indem Sie eine Anzahl von nicht verarbeiteten Elementen akzeptieren.	Extension	Vorschau
az devops migrations cutover cancel	Abbrechen einer geplanten Übernahme.	Extension	Vorschau
az devops migrations cutover review	Überprüfen Sie die nicht verarbeiteten Migrationselemente vor der Übernahme.	Extension	Vorschau
az devops migrations cutover set	Planen sie die Übernahme für eine Migration.	Extension	Vorschau
az devops migrations list	Auflisten von Migrationen in einer Organisation.	Extension	Vorschau
az devops migrations pause	Anhalten einer aktiven Migration.	Extension	Vorschau
az devops migrations resume	Fortsetzen einer angehaltenen (angehaltenen, fehlgeschlagenen) Migration.	Extension	Vorschau
az devops migrations status	Abrufen des Migrationsstatus für ein Repository.	Extension	Vorschau

az devops migrations abandon

Vorschau

Die Befehlsgruppe "Devops-Migrationen" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Abbrechen und Löschen einer Migration.

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

Beispiele

Lassen Sie das Repository schreibgeschützt auf (Standardeinstellung).

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

Verlassen Sie das Repository, und legen Sie das Repository wieder auf Lese-/Schreibzugriff fest.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--detect

Organisation automatisch erkennen.

Eigenschaft	Wert
Zulässige Werte:	false, true

--org --organization

Azure DevOps Organisations-URL Sie können die Standardorganisation mithilfe von az devops konfigurieren, -d organization=ORG_URL konfigurieren. Erforderlich, wenn nicht als „Standard“ konfiguriert oder über „git config“ übernommen. Beispiel: https://dev.azure.com/MyOrganizationName/.

--remove-read-only

Legen Sie außerdem das Azure Repos Repository wieder auf den Lese-/Schreibstatus fest, indem Sie removeReadOnly=true senden.

Eigenschaft	Wert
Standardwert:	False

--repository-id

ID des Azure Repos-Repositorys (GUID).

--yes -y

Nicht um Bestätigung bitten.

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az devops migrations create

Vorschau

Die Befehlsgruppe "Devops-Migrationen" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie eine Migration für ein Repository.

Wenn --github-token nicht angegeben wird, überprüft die CLI ELM_GITHUB_TOKEN und führt dann GitHub Geräteablauf aus, um ein Token abzurufen.

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]

Beispiele

Erstellen Sie eine Migration.

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>

Erstellen Sie eine nur valid-only-Migration.

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

Erstellen Sie mithilfe eines vorab generierten GitHub-Tokens oder 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>

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--agent-pool

Agentpoolname, der für die Migration verwendet werden soll.

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--cutover-date

Geplantes Übernahmedatum/-uhrzeit (ISO 8601).

--detect

Organisation automatisch erkennen.

Eigenschaft	Wert
Zulässige Werte:	false, true

--github-token

GitHub Token, das für die Migrationsautorisierung verwendet wird. Wird ignoriert, wenn --service-endpoint-id angegeben wird. Wenn dies nicht angegeben wird, überprüft die CLI zunächst ELM_GITHUB_TOKEN und führt dann GitHub Gerätefluss aus.

--org --organization

--repository-id

ID des Azure Repos-Repositorys (GUID).

--service-endpoint-id

Dienstendpunkt-ID (GUID) für die GitHub Enterprise Server-Verbindung. Wenn angegeben, verwendet der Server die Dienstverbindung für GitHub Authentifizierung, und die CLI überspringt GitHub Gerätefluss. Sich gegenseitig ausschließend mit --github-token.

--skip-validation

Überprüfungsrichtlinien, die übersprungen werden sollen. Akzeptiert entweder eine durch Trennzeichen getrennte Liste von Richtliniennamen (z. B. AgentPoolExists,MaxRepoSize) oder eine nicht negative ganzzahlige Bitmaske.

--target-owner-user-id

Benutzer-ID des Ziel-Repositorybesitzers. Veraltet und ignoriert, wenn die serverseitige tokenbasierte Besitzerauflösung aktiviert ist.

--target-repository

Ziel-Repository-URL (muss mit http:// oder https:// beginnen).

--validate-only

Erstellen sie im Modus "Nur überprüfen" (nur Überprüfungen vor der Migration).

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az devops migrations list

Vorschau

Die Befehlsgruppe "Devops-Migrationen" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten von Migrationen in einer Organisation.

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

Beispiele

Migrationen auflisten.

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

Listet alle Migrationen auf, einschließlich inaktiver Migrationen.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--detect

Organisation automatisch erkennen.

Eigenschaft	Wert
Zulässige Werte:	false, true

--include-inactive

Schließen Sie in die Ergebnisse inaktive Migrationen (abgeschlossen, abgebrochen, fehlgeschlagen) ein.

Eigenschaft	Wert
Standardwert:	False

--org --organization

--project

Optionaler Projektname oder die ID zum Filtern von Migrationen.

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az devops migrations pause

Vorschau

Die Befehlsgruppe "Devops-Migrationen" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Anhalten einer aktiven Migration.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--detect

Organisation automatisch erkennen.

Eigenschaft	Wert
Zulässige Werte:	false, true

--org --organization

--repository-id

ID des Azure Repos-Repositorys (GUID).

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az devops migrations resume

Vorschau

Die Befehlsgruppe "Devops-Migrationen" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Fortsetzen einer angehaltenen (angehaltenen, fehlgeschlagenen) Migration.

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

Beispiele

Setzen Sie den aktuellen Modus fort.

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

Fortsetzen im modus "Nur überprüfen".

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

Setzen Sie die Migration fort (löscht den Modus "Nur überprüfen").

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--detect

Organisation automatisch erkennen.

Eigenschaft	Wert
Zulässige Werte:	false, true

--migration

Höherstufen einer erfolgreichen überprüfungsgeschützten Migration zu einer vollständigen Migration (legt "validateOnly=false" und "statusRequested=active" fest).

Eigenschaft	Wert
Standardwert:	False

--org --organization

--repository-id

ID des Azure Repos-Repositorys (GUID).

--validate-only

Fortsetzen im modus "Nur überprüfen".

Eigenschaft	Wert
Standardwert:	False

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

az devops migrations status

Vorschau

Die Befehlsgruppe "Devops-Migrationen" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Abrufen des Migrationsstatus für ein Repository.

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

Beispiele

Abrufen des Migrationsstatus nach Repository-ID.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft	Wert
Parametergruppe:	Global Policy Arguments

--detect

Organisation automatisch erkennen.

Eigenschaft	Wert
Zulässige Werte:	false, true

--org --organization

--repository-id

ID des Azure Repos-Repositorys (GUID).

Globale Parameter

--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft	Wert
Standardwert:	False

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft	Wert
Standardwert:	False

--output -o

Ausgabeformat.

Eigenschaft	Wert
Standardwert:	json
Zulässige Werte:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft	Wert
Standardwert:	False

Feedback

War diese Seite hilfreich?