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