Gérer les Wikis avec l’interface CLI
Azure DevOps Services
Découvrez les commandes CLI suivantes pour la gestion des wikis.
Remarque
Vous ne pouvez pas supprimer de wikis de projet avec l’interface CLI.
Commandes
| Commandes | description |
|---|---|
| az devops wiki create | Créez un wiki. |
| az devops wiki delete | Supprimez un wiki. |
| az devops wiki list | Répertorier tous les wikis d’un projet ou d’une organisation. |
| az devops wiki page | Gérer les pages Wiki. |
| az devops page wiki create | Ajoutez une nouvelle page. |
| az devops page wiki delete | Supprimez une page. |
| az devops page wiki show | Obtenez le contenu d’une page ou ouvrez une page. |
| az devops page wiki update | Modifiez une page . |
| az devops wiki show | Affichez les détails d’un wiki. |
Créer un wiki
Pour créer un wiki, entrez la az devops wiki create commande.
az devops wiki create [--mapped-path]
[--name]
[--project]
[--repository]
[--subscription]
[--type {codewiki, projectwiki}]
Paramètres facultatifs
- --mappé-path : [Obligatoire pour
codewikile type] Chemin mappé du nouveau wiki, par exemple,/pour publier à partir de la racine du référentiel. - --name : nom du nouveau wiki.
- --project -p : facultatif. Nom ou ID du projet. Configurez le projet par défaut avec
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 : [Obligatoire pour
codewikile type] Nom ou ID du référentiel à partir duquel publier le wiki. - --subscription : facultatif. Nom ou ID de l’abonnement. Configurez l’abonnement par défaut à l’aide
az account set -s NAME_OR_IDde . - --type --wiki-type : type de wiki à créer. Valeurs acceptées :
codewiki,projectwiki. Valeur par défaut :projectwiki.
Exemples
Créez un wiki de projet nommé.
az devops wiki create --name myprojectwiki
Créez un wiki de code à partir d’un dossier dans un référentiel de code.
az devops wiki create --name WIKI_NAME --type codewiki
--repository REPO_NAME --mapped-path PATH_TO_PUBLISH
Supprimer un wiki
Pour supprimer un wiki, entrez la az devops wiki delete commande.
Remarque
Vous ne pouvez utiliser cette commande que pour supprimer un wiki de code, et non pour supprimer un wiki de projet.
az devops wiki delete
[--wiki]
[--project]
[--subscription]
[--yes]
Paramètres
- --wiki : obligatoire. Nom ou ID du wiki à supprimer.
- --project -p : facultatif. Nom ou ID du projet. Vous pouvez configurer le projet par défaut en utilisant
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. - --subscription : facultatif. Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant
az account set -s NAME_OR_ID. - --yes -y : facultatif. Ne demande pas de confirmation.
Exemple
Supprimez un wiki sans invite de confirmation.
az devops wiki delete --wiki myprojectwiki --yes
Répertorier les wikis
Pour répertorier tous les wikis d’un projet ou d’une organisation, entrez la az devops wiki list commande.
az devops wiki list
[--project]
[--scope {organization, project}]
[--subscription]
Paramètres facultatifs
- --project -p : facultatif. Nom ou ID du projet.
- --scope : facultatif. Répertoriez les wikis au niveau du projet ou de l’organisation. Valeurs acceptées :
organization,project. Valeur par défaut :project. - --subscription : facultatif. Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant
az account set -s NAME_OR_ID.
Exemples
Répertoriez tous les wikis d’un projet.
az devops wiki list
Répertorier tous les wikis de l’organisation.
az devops wiki list --scope organization
Afficher le wiki
Pour afficher les détails d’un wiki, entrez la az devops wiki show commande.
az devops wiki show --wiki
[--open]
[--project]
[--subscription]
Paramètres
- --wiki : obligatoire. Nom ou ID du wiki.
- --open : facultatif. Ouvrez la page wiki dans votre navigateur web.
- --project -p : facultatif. Nom ou ID du projet.
- --subscription : facultatif. Nom ou ID de l’abonnement. Configurez l’abonnement par défaut à l’aide
az account set -s NAME_OR_IDde .
Exemple
Affichez le wiki nommé myprojectwiki et ouvrez la page wiki dans votre navigateur web.
az devops wiki show --wiki myprojectwiki --open
Créer une page wiki
Pour ajouter une nouvelle page wiki, entrez la az devops wiki page create commande.
az devops wiki page create --path
--wiki
[--comment]
[--content]
[--encoding {ascii, utf-16be, utf-16le, utf-8}]
[--file-path]
[--project]
[--subscription]
Paramètres
- --path : obligatoire. Chemin d’accès de la page wiki.
- --wiki : Obligatoire. Nom ou ID du wiki.
- --comment : Facultatif. Commentez le message de validation de l’opération d’ajout de fichier. Valeur par défaut :
added a new page using Azure DevOps CLI. - --content : facultatif. Contenu de la page wiki. Ignoré si
--file-pathelle est spécifiée. - --encodage : facultatif. Encodage du fichier. Utilisé avec
--file-pathle paramètre. - --file-path : facultatif. Chemin d’accès de l’entrée de fichier si le contenu est spécifié dans le fichier.
- --project -p : facultatif. Nom ou ID du projet.
- --subscription: nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant
az account set -s NAME_OR_ID.
Exemples
Créez une page avec un chemin d’accès my page dans un wiki nommé myprojectwiki avec du contenu inline.
az devops wiki page create --path 'my page' --wiki myprojectwiki --content "Hello World"
Créez une page avec le chemin « ma page » dans un wiki nommé « myprojectwiki » avec du contenu à partir d’un fichier.
az devops wiki page create --path 'my page' --wiki myprojectwiki --file-path a.txt --encoding utf-8