Dela via

Hantera wikis med CLI

  • Artikel

Azure DevOps Services

Lär dig följande CLI-kommandon för att hantera wikis.

Anteckning

Du kan inte ta bort projekt-wikis med CLI.

Förutsättningar

Kategori Krav
Projektåtkomst Medlem i projektet där wikin finns. Om du inte har åtkomst kan du begära det från projektadministratören.
Behörigheter Medlem av gruppen Contributors.
Åtkomstnivåer Minst Grundläggande åtkomst.

Kommandon

Kommandon beskrivning
az devops wiki create Skapa en wiki.
az devops wiki delete Ta bort en wiki.
az devops wiki list Visa en lista över alla wikis i ett projekt eller en organisation.
az DevOps wiki-sida Hantera wiki-sidor.
az devops wiki page create Lägg till en ny sida.
az devops wiki page delete Ta bort en sida.
az devops wiki page show Hämta innehållet på en sida eller öppna en sida.
az devops wiki-sida uppdatering Redigera en sida.
az devops wiki show Visa detaljer om en wiki.

Skapa en wiki

Om du vill skapa en wiki anger du kommandot az devops wiki create.

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

Valfria parametrar

  • --mapped-path: [Krävs för typ codewiki] Mappad sökväg för den nya wikin, till exempel / för att publicera från lagringsplatsens rot.
  • --name: Namn på den nya wikin.
  • --project -p: Valfritt. Projektets namn eller ID. Konfigurera standardprojektet med hjälp av az devops configure -d project=NAME_OR_ID. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration.
  • --repository -r: [Krävs för codewiki typ] Namn eller ID för lagringsplatsen som wikin ska publiceras från.
  • --subscription: Valfritt. Namn eller ID för prenumeration. Konfigurera standardprenumerationen med az account set -s NAME_OR_ID.
  • --type --wiki-type: Typ av wiki att skapa. Godkända värden: codewiki, projectwiki. Standardvärde: projectwiki.

Exempel

Skapa en namngiven projekt-wiki.

az devops wiki create --name myprojectwiki

Skapa en kod-wiki från en mapp på en kodlagringsplats.

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

Ta bort en wiki

Om du vill ta bort en wiki anger du kommandot az devops wiki delete.

Notera

Du kan bara använda det här kommandot för att ta bort en kod-wiki, inte för att ta bort en projekt-wiki.

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

Parametrar

  • --wiki: Krävs. Namn eller ID för wikin som ska tas bort.
  • --project -p: Valfritt. Projektets namn eller ID. Du kan konfigurera standardprojektet med hjälp av az devops configure -d project=NAME_OR_ID. Krävs om det inte har konfigurerats som standard eller hämtats via git-konfiguration.
  • --subscription: Valfritt. Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.
  • --yes -y: Valfritt. Fråga inte efter bekräftelse.

Exempel

Ta bort en wiki utan att fråga efter bekräftelse.

az devops wiki delete --wiki myprojectwiki --yes

Lista wikis

Ange kommandot az devops wiki list om du vill visa en lista över alla wiki-objekt i ett projekt eller en organisation.

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

Valfria parametrar

  • --project -p: Valfritt. Projektets namn eller ID.
  • --scope: Valfritt. Lista wikis på projekt- eller organisationsnivå. Godkända värden: organization, project. Standardvärde: project.
  • --subscription: Valfritt. Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Exempel

Visa en lista över alla wikis för ett projekt.

az devops wiki list

Visa en lista över alla wikis i organisationen.

az devops wiki list --scope organization

Visa wiki

Om du vill visa information om en wiki anger du kommandot az devops wiki show.

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

Parametrar

  • --wiki: Krävs. Namn eller ID för wikin.
  • – öppna: Valfritt. Öppna wiki-sidan i webbläsaren.
  • --project -p: Valfritt. Projektets namn eller ID.
  • --subscription: Valfritt. Namn eller ID för prenumeration. Konfigurera standardprenumerationen med az account set -s NAME_OR_ID.

Exempel

Visa wikin med namnet myprojectwiki och öppna wiki-sidan i webbläsaren.

az devops wiki show --wiki myprojectwiki --open

Skapa en wiki-sida

Om du vill lägga till en ny wiki-sida anger du kommandot az devops wiki page create.

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

Parametrar

  • --path: Krävs. Sökväg till wiki-sidan.
  • --wiki: Krävs. Namn eller ID för wikin.
  • --kommentar: Valfritt. Kommentera i incheckningsmeddelandet för filtilläggsåtgärden. Standardvärde: added a new page using Azure DevOps CLI.
  • --content: Valfritt. Innehållet på wiki-sidan. Ignoreras om --file-path har angetts.
  • --encoding: Valfritt. Kodning av filen. Används med --file-path-parametern.
  • --file-path: Valfritt. Sökväg till filindata om innehåll anges i filen.
  • --project -p: Valfritt. Projektets namn eller ID.
  • --subscription: Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Exempel

Skapa en ny sida med sökvägen my page i en wiki med namnet myprojectwiki med infogat innehåll.

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

Skapa en ny sida med sökvägen "min sida" i en wiki med namnet "myprojectwiki" med innehåll från en fil.

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