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.

Notatka

Nie można usuwać stron typu wiki projektu za pomocą interfejsu wiersza polecenia.

Warunki wstępne

Kategoria	Wymagania
programu Project access	Członek projektu, w którym znajduje się witryna typu wiki. Jeśli nie masz dostępu, poproś go od administratora projektu.
uprawnienia	Członek grupy współautorów .
poziomy dostępu	Co najmniej dostęp podstawowy .

Polecenia

Polecenia	opis
az devops wiki create	Utwórz witrynę typu wiki.
az devops wiki delete	Usuń witrynę typu wiki.
az devops wiki list	Wyświetl listę wszystkich stron typu wiki w projekcie lub organizacji.
strona wiki Az DevOps	Zarządzanie stronami typu wiki.
az devops wiki page create	Dodaj nową stronę.
az devops wiki page delete	Usuń stronę.
az devops wiki page show	Pobierz zawartość strony lub otwórz stronę.
az devops aktualizacja strony wiki	Edytuj stronę.
az devops wiki show	Pokaż szczegóły witryny typu wiki.

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.

Notatka

Tego polecenia można użyć tylko do usunięcia witryny typu wiki kodu, a nie do usunięcia witryny typu wiki projektu.

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 pobrane przez 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