Zarządzanie witrynami typu wiki za pomocą interfejsu wiersza polecenia

Azure DevOps Services

Zapoznaj się z następującymi poleceniami interfejsu wiersza polecenia do zarządzania witrynami typu wiki.

Warunki wstępne

Polecenia

Tworzenie witryny typu wiki

Aby utworzyć witrynę typu wiki, wprowadź polecenie az devops wiki create.

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

Parametry opcjonalne

• --mapped-path: [Wymagane dla typu codewiki] Mapowana ścieżka nowej witryny typu wiki, na przykład / do publikowania z katalogu głównego repozytorium.
• --name: nazwa nowej witryny typu wiki.
• --project -p: opcjonalne. Nazwa lub identyfikator projektu. Skonfiguruj projekt domyślny przy użyciu az devops configure -d project=NAME_OR_ID. Wymagane, jeśli nie jest skonfigurowane jako domyślne lub przejęte za pośrednictwem git config.
• --repository -r: [Wymagane dla typu codewiki] Nazwa lub identyfikator repozytorium do opublikowania wiki.
• --subscription: opcjonalne. Nazwa lub identyfikator subskrypcji. Skonfiguruj subskrypcję domyślną przy użyciu az account set -s NAME_OR_ID.
• --type --wiki-type: Typ wiki do utworzenia. Zaakceptowane wartości: codewiki, projectwiki. Wartość domyślna: projectwiki.

Przykłady

Utwórz projektową wiki o nazwie.

az devops wiki create --name myprojectwiki

Utwórz witrynę typu wiki kodu z folderu w repozytorium kodu.

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

Usuwanie witryny typu wiki

Aby usunąć witrynę typu wiki, wprowadź polecenie az devops wiki delete.

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

Parametry

• --wiki: wymagane. Nazwa lub identyfikator witryny typu wiki do usunięcia.
• --project -p: opcjonalne. Nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu az devops configure -d project=NAME_OR_ID. Wymagane, jeśli nie jest skonfigurowane jako domyślne lub przejęte za pośrednictwem git config.
• --subscription: opcjonalne. Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.
• --yes -y: opcjonalne. Nie monituj o potwierdzenie.

Przykład

Usuń witrynę typu wiki bez monitu o potwierdzenie.

az devops wiki delete --wiki myprojectwiki --yes

Wyświetlanie listy witryn typu wiki

Aby wyświetlić listę wszystkich witryn typu wiki w projekcie lub organizacji, wprowadź polecenie az devops wiki list.

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

Parametry opcjonalne

• --project -p: opcjonalne. Nazwa lub identyfikator projektu.
• --scope: opcjonalne. Wyświetl listę stron typu wiki na poziomie projektu lub organizacji. Zaakceptowane wartości: organization, project. Wartość domyślna: project.
• --subscription: opcjonalne. Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Przykłady

Wyświetl listę wszystkich witryn typu wiki dla projektu.

az devops wiki list

Wyświetl listę wszystkich witryn typu wiki w organizacji.

az devops wiki list --scope organization

Pokaż witrynę typu wiki

Aby wyświetlić szczegóły witryny typu wiki, wprowadź polecenie az devops wiki show.

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

Parametry

• --wiki: wymagane. Nazwa lub identyfikator witryny typu wiki.
• --open: opcjonalne. Otwórz stronę typu wiki w przeglądarce internetowej.
• --project -p: opcjonalne. Nazwa lub identyfikator projektu.
• --subscription: opcjonalne. Nazwa lub identyfikator subskrypcji. Skonfiguruj subskrypcję domyślną przy użyciu az account set -s NAME_OR_ID.

Przykład

Pokaż witrynę typu wiki o nazwie myprojectwiki i otwórz stronę typu wiki w przeglądarce internetowej.

az devops wiki show --wiki myprojectwiki --open

Tworzenie strony typu wiki

Aby dodać nową stronę typu wiki, wprowadź polecenie 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]

Parametry

• --path: wymagane. Ścieżka strony wiki.
• --wiki: wymagane. Nazwa lub identyfikator witryny typu wiki.
• --comment: opcjonalne. Komentarz w komunikacie zatwierdzenia operacji dodawania pliku. Wartość domyślna: added a new page using Azure DevOps CLI.
• --content: opcjonalne. Zawartość strony typu wiki. Ignorowane, jeśli określono --file-path.
• - kodowanie: opcjonalne. Kodowanie pliku. Używany z parametrem --file-path.
• --file-path: opcjonalne. Ścieżka pliku wejściowego, jeśli zawartość jest określona w pliku.
• --project -p: opcjonalne. Nazwa lub identyfikator projektu.
• --subscription: nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu az account set -s NAME_OR_ID.

Przykłady

Utwórz nową stronę ze ścieżką my page w witrynie typu wiki o nazwie myprojectwiki z zawartością śródliniową.

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

Utwórz nową stronę ze ścieżką "moja strona" w witrynie typu wiki o nazwie "myprojectwiki" z zawartością z pliku.

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