az devops migrations

  • Préversion

Note

Cette référence fait partie de l’extension azure-devops pour la Azure CLI (version 2.30.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az devops migrations . Apprenez-en davantage sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Gérer les migrations dynamiques d’entreprise.

Le groupe de commandes de migration ELM fait partie de l’extension azure-devops. Pour plus d’informations, consultez https://aka.ms/adoELM.

Commandes

Nom Description Type État
az devops migrations abandon

Abandonner une migration.

 Extension Preview
az devops migrations create

Créez une migration pour un référentiel.

 Extension Preview
az devops migrations cutover

Gérer le basculement de migration.

 Extension Preview
az devops migrations cutover approve

Approuvez le basculement en acceptant des éléments non traités et/ou en vérifiant les pipelines rewired.

 Extension Preview
az devops migrations cutover cancel

Annulez un basculement planifié.

 Extension Preview
az devops migrations cutover review

Passez en revue les éléments de migration non traités avant le basculement.

 Extension Preview
az devops migrations cutover set

Planifiez le basculement pour une migration.

 Extension Preview
az devops migrations list

Répertorier les migrations dans une organisation.

 Extension Preview
az devops migrations pause

Suspendre une migration active.

 Extension Preview
az devops migrations pipelines

Gérer le rewiring de pipeline pour les migrations. (Préversion).

 Extension Preview
az devops migrations pipelines delete

Supprimez les données de rewiring de pipeline pour une migration. (Préversion).

 Extension Preview
az devops migrations pipelines list

Répertorier la configuration du pipeline et l’état par pipeline.

 Extension Preview
az devops migrations pipelines retry

Nouvelle tentative échec des entrées de balayage du pipeline. (Préversion).

 Extension Preview
az devops migrations pipelines submit

Envoyer des pipelines pour le rewiring. (Préversion).

 Extension Preview
az devops migrations pipelines update

Configuration de réexécriture du pipeline de mise à jour en bloc. (Préversion).

 Extension Preview
az devops migrations resume

Reprendre une migration arrêtée (suspendue, ayant échoué).

 Extension Preview
az devops migrations status

Obtenir l’état de migration d’un référentiel.

 Extension Preview

az devops migrations abandon

Préversion

Le groupe de commandes « devops migrations » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Abandonner une migration.

Déplace la migration vers un état abandonné/défaillant ; l’enregistrement de migration n’est pas vidé. Le rewiring de pipeline reste intact afin qu’une migration ultérieure puisse la réutiliser.

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

Exemples

Abandonnez et conservez le référentiel en lecture seule (valeur par défaut).

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

Abandonnez et définissez le référentiel en lecture-écriture.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--org --organization

URL de l'organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--remove-read-only

Définissez également le référentiel Azure Repos en lecture-écriture en envoyant removeReadOnly=true.

Propriété Valeur
Valeur par défaut: False
--repository-id

ID du référentiel Azure Repos (GUID).

--yes -y

Ne pas demander de confirmation.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az devops migrations create

Préversion

Le groupe de commandes « devops migrations » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Créez une migration pour un référentiel.

GitHub l’authentification utilise le flux d’appareil : l’interface CLI imprime une URL et un code à usage unique pour terminer la connexion de manière interactive. Aucun jeton GitHub ou connexion de service n’est nécessaire.

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]
                            [--org --organization]
                            [--pipeline-sc-id --pipeline-service-connection-id]
                            [--repository-id]
                            [--skip-validation]
                            [--target-owner-user-id]
                            [--target-repository]
                            [--validate-only]

Exemples

Créez une 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>

Créez une migration de validation uniquement.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--agent-pool

Nom du pool d’agents à utiliser pour le travail de migration.

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

Optez pour la découverte automatique de pipelines au basculement. Désactivé par défaut. Quand elle est activée, le travail de synchronisation ELM guide le référentiel source et crée des définitions de clone pour chaque pipeline qui le référence. Nécessite --pipeline-service-connection-id ; sans qu’elle s’exécute en tant que no-op et inscrit 0 pipelines. Le rewiring de pipeline lui-même est toujours disponible via az devops migrations pipelines submit/update.

Propriété Valeur
Valeur par défaut: False
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--cutover-date

Date/heure de basculement planifiée (ISO 8601).

--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--enable-boards-gh --enable-boards-github-connection

Optez pour approvisionner la connexion Azure Boards GitHub au basculement. Désactivé par défaut. Nécessite que l’application Azure Boards GitHub soit installée sur l’organisation cible GitHub Entreprise avant l’exécution de la migration.

Propriété Valeur
Valeur par défaut: False
--org --organization

URL de l'organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

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

Project’étendue GitHub ID de connexion de service attaché au moment de la création pour le rewiring du pipeline. Obligatoire pour la découverte automatique complète lorsqu’elle est combinée à --enable-auto-discover-pipelines ; facultatif en mode manuel (pré-attache la connexion afin que les pipelines suivants envoient des appels n’ont besoin que de --pipeline-ids).

--repository-id

ID du référentiel Azure Repos (GUID).

--skip-validation

Stratégies de validation à ignorer. Accepte une liste séparée par des virgules de noms de stratégie (par exemple, AgentPoolExists,MaxFileSize) ou un masque de bits entier non négatif. Noms de stratégie pris en charge (sans respect de la casse) : None, ActivePullRequestCount, PullRequestDeltaSize, AgentPoolExists, MaxFileSize, MaxPullRequestSize, MaxPushPackSize, MaxReferenceNameLength, TargetRepositoryDoesNotExist, SourceRepositoryContainsLfsObjects, SourceRepositoryNotReadOnly, BoardsGitHubConnectionProvisioning, All.

--target-owner-user-id

ID d’utilisateur du propriétaire du référentiel cible. Déconseillé et ignoré lorsque la résolution de propriétaire basée sur un jeton côté serveur est activée.

--target-repository

URL du référentiel cible (doit commencer par http:// ou https://).

--validate-only

Créez en mode validation seule (vérifications préalables à la migration uniquement).

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az devops migrations list

Préversion

Le groupe de commandes « devops migrations » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Répertorier les migrations dans une organisation.

Par défaut, la dernière migration par référentiel est retournée, quel que soit l’état. Utilisez --include-all pour retourner l’historique de migration complet.

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

Exemples

Répertoriez la dernière migration par référentiel.

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

Répertoriez l’historique de migration complet pour chaque référentiel.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--include-all

Retournez l’historique de migration complet (tous les enregistrements par référentiel). Par défaut, seule la dernière migration par référentiel est retournée, quel que soit son état.

Propriété Valeur
Valeur par défaut: False
--include-inactive
Déprécié

L’option « --include-inactive » a été déconseillée et sera supprimée dans une prochaine version. Utilisez plutôt « --include-all ».

Deprecated. Utilisez plutôt --include-all.

Propriété Valeur
Valeur par défaut: False
--org --organization

URL de l'organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--project

Nom ou ID de projet facultatif pour filtrer les migrations.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az devops migrations pause

Préversion

Le groupe de commandes « devops migrations » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Suspendre une migration active.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--org --organization

URL de l'organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--repository-id

ID du référentiel Azure Repos (GUID).

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az devops migrations resume

Préversion

Le groupe de commandes « devops migrations » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Reprendre une migration arrêtée (suspendue, ayant échoué).

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

Exemples

Reprendre à l’aide du mode actuel.

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

Reprendre en mode validation seule.

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

Poursuivre la migration (efface le mode de validation uniquement).

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--migration

Promouvoir une migration de validation uniquement réussie vers une migration complète (définit validateOnly=false et statusRequested=active).

Propriété Valeur
Valeur par défaut: False
--org --organization

URL de l'organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--repository-id

ID du référentiel Azure Repos (GUID).

--validate-only

Reprendre en mode validation seule.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az devops migrations status

Préversion

Le groupe de commandes « devops migrations » est en préversion et en cours de développement. Niveaux de référence et de support : https://aka.ms/CLI_refstatus

Obtenir l’état de migration d’un référentiel.

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

Exemples

Obtenez l’état de la migration par ID de référentiel.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--acquire-policy-token

Acquisition automatique d’un jeton Azure Policy pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--change-reference

ID de référence de modification associé pour cette opération de ressource.

Propriété Valeur
Groupe de paramètres: Global Policy Arguments
--detect

Détectez automatiquement l’organisation.

Propriété Valeur
Valeurs acceptées: false, true
--org --organization

URL de l'organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de az devops configure -d organization=ORG_URL. Obligatoire si la valeur n’est pas configurée par défaut ni récupérée via git config. Exemple : https://dev.azure.com/MyOrganizationName/.

--repository-id

ID du référentiel Azure Repos (GUID).

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False