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.

Ce groupe de commandes fait partie de l’extension azure-devops et est en préversion. La disponibilité peut être limitée (par exemple, à 1P/utilisateurs autorisés). Pour les migrations ELM, --org doit être votre URL d’organisation Azure DevOps (par exemple : https://dev.azure.com/myorg).

Commandes

Nom	Description	Type	État
az devops migrations abandon	Abandonner et supprimer 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 un nombre d’éléments non traités.	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 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 et supprimer une migration.

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.

Si --github-token n’est pas fourni, l’interface CLI vérifie ELM_GITHUB_TOKEN, puis exécute GitHub flux d’appareil pour acquérir un jeton.

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]

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

Créez à l’aide d’un jeton de GitHub prégéné ou d’un jeton 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>

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.

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

--github-token

GitHub jeton utilisé pour l’autorisation de migration. Ignoré lorsque --service-endpoint-id est spécifié. En cas d’omission, l’interface CLI vérifie d’abord ELM_GITHUB_TOKEN, puis s’exécute GitHub flux d’appareil.

--org --organization

--repository-id

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

--service-endpoint-id

ID de point de terminaison de service (GUID) pour la connexion GitHub Enterprise Server. Quand il est spécifié, le serveur utilise la connexion de service pour l’authentification GitHub et l’interface CLI ignore GitHub flux d’appareil. Mutuellement exclusif avec --github-token.

--skip-validation

Stratégies de validation à ignorer. Accepte une liste séparée par des virgules de noms de stratégie (par exemple, AgentPoolExists,MaxRepoSize) ou un masque de bits entier non négatif.

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

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

Exemples

Répertorier les migrations.

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

Répertorier toutes les migrations, y compris les migrations inactives.

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

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

Incluez les migrations inactives (terminées, abandonnées, ayant échoué) dans les résultats.

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

--org --organization

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

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

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

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

Commentaires

Cette page a-t-elle été utile ?