Partager via

az repos ref

Note

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

Gérer les références Git.

Commandes

Nom Description Type État
az repos ref create

Créez une référence.

 Extension GA
az repos ref delete

Supprimez une référence.

 Extension GA
az repos ref list

Répertoriez les références.

 Extension GA
az repos ref lock

Verrouillez une référence.

 Extension GA
az repos ref unlock

Déverrouillez une référence.

 Extension GA

az repos ref create

Créez une référence.

az repos ref create --name
                    --object-id
                    [--detect {false, true}]
                    [--org --organization]
                    [--project]
                    [--repository]

Paramètres obligatoires

--name

Nom de la référence à créer (exemple : heads/my_branch ou tags/my_tag).

--object-id

ID de l’objet à partir duquel créer la référence.

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

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--repository -r

Nom ou ID du référentiel.

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 à l’aide de 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 repos ref delete

Supprimez une référence.

az repos ref delete --name
                    [--detect {false, true}]
                    [--object-id]
                    [--org --organization]
                    [--project]
                    [--repository]

Paramètres obligatoires

--name

Nom de la référence à supprimer (exemple : têtes/my_branch).

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

ID de la référence à supprimer.

--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--repository -r

Nom ou ID du référentiel.

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 à l’aide de 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 repos ref list

Répertoriez les références.

az repos ref list [--detect {false, true}]
                  [--filter]
                  [--org --organization]
                  [--project]
                  [--repository]

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

Filtre à appliquer aux références (commence par). Exemple : tête ou tête/ pour les branches.

--org --organization

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--repository -r

Nom ou ID du référentiel.

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 à l’aide de 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 repos ref lock

Verrouillez une référence.

az repos ref lock --name
                  [--detect {false, true}]
                  [--org --organization]
                  [--project]
                  [--repository]

Paramètres obligatoires

--name

Nom de la référence à mettre à jour (exemple : heads/my_branch).

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

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--repository -r

Nom ou ID du référentiel.

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 à l’aide de 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 repos ref unlock

Déverrouillez une référence.

az repos ref unlock --name
                    [--detect {false, true}]
                    [--org --organization]
                    [--project]
                    [--repository]

Paramètres obligatoires

--name

Nom de la référence à mettre à jour (exemple : heads/my_branch).

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

URL de organization Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide d’az devops configure -d organization=ORG_URL. Obligatoire s’il n’est pas configuré comme valeur par défaut ou récupéré par le biais de la configuration git. Exemple : https://dev.azure.com/MyOrganizationName/.

--project -p

Nom ou ID du projet. Vous pouvez configurer le projet par défaut à l’aide de az devops configure -d project=NAME_OR_ID. Obligatoire si ce paramètre n’est pas configuré par défaut ou récupéré avec git config.

--repository -r

Nom ou ID du référentiel.

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 à l’aide de 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