Správa wikiwebů pomocí rozhraní příkazového řádku

Služby Azure DevOps

Pomocí Azure DevOps CLI můžete vytvářet, vypisovat, zobrazovat a odstraňovat wikiweby a vytvářet stránky wikiwebu. Rozhraní příkazového řádku je užitečné pro automatizaci úloh správy wikiwebu nebo integraci operací wikiwebu do skriptů a kanálů.

Poznámka

Wikiweby projektu nemůžete odstranit pomocí rozhraní příkazového řádku.

Požadavky

Kategorie	Požadavky
Přístup k projektu	Člen projektu, kde se nachází wikiweb. Pokud přístup nemáte, požádejte ho od správce projektu.
oprávnění	Člen skupiny Přispěvatelé.
úrovně přístupu	Alespoň základní přístup.

Příkazy

Příkazy	Description
az devops wiki vytvořit	Vytvoření wikiwebu
az devops wiki delete	Odstranění wikiwebu
seznam wiki az devops	Zobrazí seznam všech wikiwebů v projektu nebo organizaci.
az devops wiki stránka	Umožňuje spravovat stránky wikiwebu.
az devops wiki stránka vytvořit	Přidejte novou stránku.
az devops wiki stránka smazat	Odstraňte stránku.
az devops wiki stránka zobrazit	Získejte obsah stránky nebo otevřete stránku.
aktualizace stránky wiki ve službě az devops	Umožňuje upravit stránku.
az devops wiki show (Zobrazit wiki v Azure DevOps)	Zobrazí podrobnosti wikiwebu.

Vytvoření wikiwebu

Zadejte příkaz pro az devops wiki create vytvoření wikiwebu.

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

Volitelné parametry

• --mapped-path: [Požadováno pro typ codewiki] Mapovaná cesta nového wikiwebu, například / pro publikování z kořenové složky úložiště.
• --name: Název nového wikiwebu.
• --project -p: Volitelné. Název nebo ID projektu. Nakonfigurujte výchozí projekt pomocí .az devops configure -d project=NAME_OR_ID Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.
• --repository -r: [Požadováno pro typ codewiki] Název nebo ID úložiště pro publikování wikiwebu.
• --subscription: Volitelné. Název nebo ID předplatného Nakonfigurujte výchozí předplatné pomocí .az account set -s NAME_OR_ID
• --type --wiki-type: Typ wikiwebu, který chcete vytvořit. Přijaté hodnoty: codewiki, projectwiki. Výchozí hodnota: projectwiki.

Příklady

Vytvořte pojmenovaný wikiweb projektu.

az devops wiki create --name myprojectwiki

Vytvořte wikiweb kódu ze složky v úložišti kódu.

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

Odstranění wikiwebu

Pokud chcete odstranit wikiweb, zadejte příkaz az devops wiki delete.

Poznámka

Tento příkaz můžete použít pouze k odstranění wikiwebu kódu, nikoli wikiwebu projektu.

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

Parametry

• --wiki: Povinné. Název nebo ID wikiwebu, které chcete odstranit.
• --project -p: Volitelné. Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno prostřednictvím konfigurace Gitu.
• --subscription: Volitelné. Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí .az account set -s NAME_OR_ID
• --yes -y: Volitelné. Nevyžadujte potvrzení.

Příklad

Odstraňte wikiweb bez výzvy k potvrzení.

az devops wiki delete --wiki myprojectwiki --yes

Seznam wikiwebů

Pokud chcete zobrazit seznam všech wikiwebů v projektu nebo organizaci, zadejte příkaz az devops wiki list.

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

Volitelné parametry

• --project -p: Volitelné. Název nebo ID projektu.
• --scope: Volitelné. Zobrazí seznam wikiwebů na úrovni projektu nebo organizace. Přijaté hodnoty: organization, project. Výchozí hodnota: project.
• --subscription: Volitelné. Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí .az account set -s NAME_OR_ID

Příklady

Zobrazí seznam všech wikiwebů pro projekt.

az devops wiki list

Zobrazí seznam všech wikiwebů v organizaci.

az devops wiki list --scope organization

Zobrazit wiki

Pokud chcete zobrazit podrobnosti wikiwebu, zadejte příkaz az devops wiki show.

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

Parametry

• --wiki: Povinné. Název nebo ID wikiwebu
• --open: Volitelné. Otevřete stránku wikiwebu ve webovém prohlížeči.
• --project -p: Volitelné. Název nebo ID projektu.
• --subscription: Volitelné. Název nebo ID předplatného Nakonfigurujte výchozí předplatné pomocí .az account set -s NAME_OR_ID

Příklad

Zobrazte wikiweb s názvem myprojectwiki a otevřete stránku wikiwebu ve webovém prohlížeči.

az devops wiki show --wiki myprojectwiki --open

Vytvoření stránky wikiwebu

Pokud chcete přidat novou stránku wikiwebu, zadejte příkaz 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: Povinné. Cesta ke stránce wiki
• --wiki: Povinné. Název nebo ID wikiwebu
• --comment: Volitelné. Komentář ve zprávě potvrzení pro operaci přidání souboru. Výchozí hodnota: added a new page using Azure DevOps CLI.
• --content: Volitelné. Obsah stránky wikiwebu Ignorováno, pokud je zadán --file-path.
• --encoding: Volitelné. Kódování souboru. Používá se s parametrem --file-path.
• --file-path: Volitelné. Cesta ke vstupu souboru, pokud je v souboru zadaný obsah.
• --project -p: Volitelné. Název nebo ID projektu.
• --subscription: Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí .az account set -s NAME_OR_ID

Příklady

Vytvořte novou stránku s cestou my page ve wikiwebu s názvem myprojectwiki pomocí vloženého obsahu.

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

Vytvořte novou stránku s cestou my page ve wikiwebu s názvem myprojectwiki pomocí obsahu ze souboru.

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