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.
Uwaga
Nie można usuwać stron typu wiki projektu za pomocą interfejsu wiersza polecenia.
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. |
az devops wiki page | 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 wiki page update | Edytowanie strony . |
az devops wiki show | Pokaż szczegóły witryny typu wiki. |
Tworzenie witryny typu wiki
Aby utworzyć witrynę typu wiki, wprowadź az devops wiki create
polecenie .
az devops wiki create [--mapped-path]
[--name]
[--project]
[--repository]
[--subscription]
[--type {codewiki, projectwiki}]
Parametry opcjonalne
- --mapped-path: [Wymagane dla
codewiki
typu] 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 polecenia
az devops configure -d project=NAME_OR_ID
. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git. - --repository -r: [Wymagane dla
codewiki
typu] Nazwa lub identyfikator repozytorium do opublikowania witryny typu wiki. - --subscription: opcjonalne. Nazwa lub identyfikator subskrypcji. Skonfiguruj subskrypcję domyślną przy użyciu polecenia
az account set -s NAME_OR_ID
. - --type --wiki-type: typ strony typu wiki do utworzenia. Zaakceptowane wartości:
codewiki
,projectwiki
. Wartość domyślna:projectwiki
.
Przykłady
Utwórz nazwaną witrynę typu wiki projektu.
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ź az devops wiki delete
polecenie .
Uwaga
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 polecenia
az devops configure -d project=NAME_OR_ID
. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git. - --subscription: opcjonalne. Nazwa lub identyfikator subskrypcji. Subskrypcję domyślną można skonfigurować przy użyciu polecenia
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 stron typu wiki w projekcie lub organizacji, wprowadź az devops wiki list
polecenie .
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 polecenia
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ółowe informacje o witrynie typu wiki, wprowadź az devops wiki show
polecenie .
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 polecenia
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ź az devops wiki page create
polecenie .
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 typu wiki.
- --wiki: wymagane. Nazwa lub identyfikator witryny typu wiki.
- --comment: Opcjonalnie. 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
--file-path
jest określony. - --kodowanie: opcjonalne. Kodowanie pliku. Używany z parametrem
--file-path
. - --file-path: opcjonalne. Ścieżka danych wejściowych pliku, 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 polecenia
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