Wiki's beheren met de CLI

Azure DevOps Services

Meer informatie over de volgende CLI-opdrachten voor het beheren van wiki's.

Notitie

U kunt projectwiki's niet verwijderen met de CLI.

Opdrachten

Opdrachten	beschrijving
az devops wiki create	Een wiki maken.
az devops wiki delete	Een wiki verwijderen.
az devops wiki list	Alle wiki's in een project of organisatie weergeven.
az devops wiki page	Wikipagina's beheren.
az devops wiki page create	Voeg een nieuwe pagina toe.
az devops wiki page delete	Een pagina verwijderen.
az devops wiki page show	De inhoud van een pagina ophalen of een pagina openen.
az devops wiki page update	Een pagina bewerken.
az devops wiki show	De details van een wiki weergeven.

Een wiki maken

Voer de az devops wiki create opdracht in om een wiki te maken.

az devops wiki create [--mapped-path]
                      [--name]
                      [--project]
                      [--repository]
                      [--subscription]
                      [--type {codewiki, projectwiki}]

Optionele parameters

• --mapped-path: [Vereist voor codewiki type] Toegewezen pad van de nieuwe wiki, bijvoorbeeld / om te publiceren vanuit de hoofdmap van de opslagplaats.
• --name: naam van de nieuwe wiki.
• --project -p: Optioneel. Naam of id van het project. Configureer het standaardproject met behulp van az devops configure -d project=NAME_OR_ID. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie.
• --repository -r: [Vereist voor codewiki type] Naam of id van de opslagplaats waaruit de wiki moet worden gepubliceerd.
• --subscription: Optioneel. Naam of id van het abonnement. Configureer het standaardabonnement met behulp van az account set -s NAME_OR_ID.
• --type --wiki-type: Type wiki dat moet worden gemaakt. Geaccepteerde waarden: codewiki, projectwiki. Standaardwaarde: projectwiki.

Voorbeelden

Maak een benoemde projectwiki.

az devops wiki create --name myprojectwiki

Een codewiki maken op basis van een map in een codeopslagplaats.

az devops wiki create --name WIKI_NAME --type codewiki
--repository REPO_NAME --mapped-path PATH_TO_PUBLISH

Een wiki verwijderen

Als u een wiki wilt verwijderen, voert u de az devops wiki delete opdracht in.

Notitie

U kunt deze opdracht alleen gebruiken om een codewiki te verwijderen, niet om een projectwiki te verwijderen.

az devops wiki delete 
                      [--wiki]
                      [--project]
                      [--subscription]
                      [--yes]

Parameters

• --wiki: vereist. Naam of id van de wiki die u wilt verwijderen.
• --project -p: Optioneel. Naam of id van het project. U kunt het standaardproject configureren met behulp van az devops configure -d project=NAME_OR_ID. Vereist indien niet geconfigureerd als standaard of opgehaald via git-configuratie.
• --subscription: Optioneel. Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.
• --ja -y: Optioneel. Vraag niet om bevestiging.

Opmerking

Verwijder een wiki zonder een bevestigingsprompt.

az devops wiki delete --wiki myprojectwiki --yes

Wiki's weergeven

Als u alle wiki's in een project of organisatie wilt weergeven, voert u de az devops wiki list opdracht in.

az devops wiki list 
                    [--project]
                    [--scope {organization, project}]
                    [--subscription]

Optionele parameters

• --project -p: Optioneel. Naam of id van het project.
• --scope: optioneel. Vermeld de wiki's op project- of organisatieniveau. Geaccepteerde waarden: organization, project. Standaardwaarde: project.
• --subscription: Optioneel. Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Voorbeelden

Geef alle wiki's voor een project weer.

az devops wiki list

Geef alle wiki's in de organisatie weer.

az devops wiki list --scope organization

Wiki weergeven

Als u details van een wiki wilt weergeven, voert u de az devops wiki show opdracht in.

az devops wiki show --wiki
                    [--open]
                    [--project]
                    [--subscription]

Parameters

• --wiki: vereist. Naam of id van de wiki.
• --open: optioneel. Open de wikipagina in uw webbrowser.
• --project -p: Optioneel. Naam of id van het project.
• --subscription: Optioneel. Naam of id van het abonnement. Configureer het standaardabonnement met behulp van az account set -s NAME_OR_ID.

Opmerking

De wiki met de naam myprojectwiki weergeven en de wikipagina openen in uw webbrowser.

az devops wiki show --wiki myprojectwiki --open

Een wikipagina maken

Als u een nieuwe wikipagina wilt toevoegen, voert u de az devops wiki page create opdracht in.

az devops wiki page create --path
                           --wiki
                           [--comment]
                           [--content]
                           [--encoding {ascii, utf-16be, utf-16le, utf-8}]
                           [--file-path]
                           [--project]
                           [--subscription]

Parameters

• --path: vereist. Pad van de wikipagina.
• --wiki: vereist. Naam of id van de wiki.
• --comment: Optioneel. Opmerking in het doorvoerbericht van de bewerking voor het toevoegen van bestanden. Standaardwaarde: added a new page using Azure DevOps CLI.
• --content: optioneel. Inhoud van de wikipagina. Genegeerd als --file-path is opgegeven.
• --encoding: Optioneel. Codering van het bestand. Wordt gebruikt met --file-path parameter.
• --file-path: Optioneel. Pad van de bestandsinvoer als inhoud is opgegeven in het bestand.
• --project -p: Optioneel. Naam of id van het project.
• --subscription: naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Voorbeelden

Maak een nieuwe pagina met een pad my page in een wiki met de naam myprojectwiki inline-inhoud.

az devops wiki page create --path 'my page' --wiki myprojectwiki --content "Hello World"

Maak een nieuwe pagina met het pad 'mijn pagina' in een wiki met de naam 'myprojectwiki' met inhoud uit een bestand.

az devops wiki page create --path 'my page' --wiki myprojectwiki --file-path a.txt --encoding utf-8