Condividi tramite


Gestire wiki con l'interfaccia della riga di comando

Servizi di Azure DevOps

Informazioni sui comandi dell'interfaccia della riga di comando seguenti per la gestione dei wiki.

Nota

Non è possibile eliminare wiki di progetto con l'interfaccia della riga di comando.

Comandi

Comandi description
az devops wiki create Creare un wiki.
az devops wiki delete Eliminare un wiki.
az devops wiki list Elencare tutti i wiki in un progetto o in un'organizzazione.
az devops wiki page Gestire le pagine wiki.
az devops wiki page create Aggiungere una nuova pagina.
az devops wiki page delete Eliminare una pagina.
az devops wiki page show Ottenere il contenuto di una pagina o aprire una pagina.
az devops wiki page update Modificare una pagina .
az devops wiki show Mostra i dettagli di un wiki.

Creare un wiki

Per creare un wiki, immettere il az devops wiki create comando .

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

Parametri facoltativi

  • --mapped-path: [Obbligatorio per codewiki il tipo] Percorso mappato del nuovo wiki, / ad esempio per pubblicare dalla radice del repository.
  • --name: nome del nuovo wiki.
  • --project -p: Facoltativo. Nome o ID del progetto. Configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.
  • --repository -r: [Obbligatorio per codewiki il tipo] Nome o ID del repository da cui pubblicare il wiki.
  • --subscription: facoltativo. Nome o ID della sottoscrizione. Configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
  • --type --wiki-type: tipo di wiki da creare. Valori accettati: codewiki, projectwiki. Valore predefinito: projectwiki

Esempi

Creare un wiki del progetto denominato.

az devops wiki create --name myprojectwiki

Creare un wiki di codice da una cartella in un repository di codice.

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

Eliminare un wiki

Per eliminare un wiki, immettere il az devops wiki delete comando .

Nota

È possibile usare questo comando solo per eliminare un wiki di codice, non per eliminare un wiki di progetto.

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

Parametri

  • --wiki: obbligatorio. Nome o ID del wiki da eliminare.
  • --project -p: Facoltativo. Nome o ID del progetto. È possibile configurare il progetto predefinito usando az devops configure -d project=NAME_OR_ID. Obbligatorio se non è configurato come predefinito o selezionato tramite git config.
  • --subscription: facoltativo. Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
  • --yes -y: facoltativo. Non richiedere conferma.

Esempio

Eliminare un wiki senza una richiesta di conferma.

az devops wiki delete --wiki myprojectwiki --yes

Elencare wiki

Per elencare tutti i wiki in un progetto o in un'organizzazione, immettere il az devops wiki list comando .

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

Parametri facoltativi

  • --project -p: Facoltativo. Nome o ID del progetto.
  • --scope: facoltativo. Elencare i wiki a livello di progetto o organizzazione. Valori accettati: organization, project. Valore predefinito: project
  • --subscription: facoltativo. Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Esempi

Elencare tutti i wiki per un progetto.

az devops wiki list

Elencare tutti i wiki nell'organizzazione.

az devops wiki list --scope organization

Mostra wiki

Per visualizzare i dettagli di un wiki, immettere il az devops wiki show comando .

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

Parametri

  • --wiki: obbligatorio. Nome o ID del wiki.
  • --open: facoltativo. Aprire la pagina wiki nel Web browser.
  • --project -p: Facoltativo. Nome o ID del progetto.
  • --subscription: facoltativo. Nome o ID della sottoscrizione. Configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Esempio

Visualizzare il wiki denominato myprojectwiki e aprire la pagina wiki nel Web browser.

az devops wiki show --wiki myprojectwiki --open

Creare una pagina wiki

Per aggiungere una nuova pagina wiki, immettere il az devops wiki page create comando .

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

Parametri

  • --path: obbligatorio. Percorso della pagina wiki.
  • --wiki: obbligatorio. Nome o ID del wiki.
  • --comment: facoltativo. Aggiungere commenti nel messaggio di commit dell'operazione di aggiunta file. Valore predefinito: added a new page using Azure DevOps CLI
  • --content: facoltativo. Contenuto della pagina wiki. Ignorato se --file-path è specificato.
  • --encoding: facoltativo. Codifica del file. Usato con --file-path il parametro .
  • --file-path: facoltativo. Percorso dell'input del file se il contenuto è specificato nel file.
  • --project -p: Facoltativo. Nome o ID del progetto.
  • --subscription: nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

Esempi

Creare una nuova pagina con percorso my page in un wiki denominato myprojectwiki con contenuto inline.

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

Creare una nuova pagina con il percorso 'my page' in un wiki denominato "myprojectwiki" con contenuto da un file.

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