Manage wikis with the CLI

Azure DevOps Services | Azure DevOps Server 2020

Learn the following CLI commands for managing wikis.

Note

You can't delete project wikis with the CLI.

Commands

Commands description
az devops wiki create Create a wiki.
az devops wiki delete Delete a wiki.
az devops wiki list List all the wikis in a project or an organization.
az devops wiki page Manage wiki pages.
az devops wiki page create Add a new page.
az devops wiki page delete Delete a page.
az devops wiki page show Get the content of a page or open a page.
az devops wiki page update Edit a page.
az devops wiki show Show the details of a wiki.

Create a wiki

To create a wiki, enter the az devops wiki create command.

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

Optional parameters

  • --mapped-path: [Required for codewiki type] Mapped path of the new wiki, for example, '/' to publish from root of repository. --name: Name of the new wiki.
  • --project -p: Optional. Name or ID of the project. You can configure the default project using az devops configure -d project=NAME_OR_ID. Required if not configured as default or picked up via git config.
  • --repository -r: [Required for codewiki type] Name or ID of the repository to publish the wiki from.
  • --subscription: Optional. Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
  • --type --wiki-type: Type of wiki to create. Accepted values: codewiki, projectwiki. Default value: projectwiki.

Examples

Create a named project wiki.

az devops wiki create --name myprojectwiki

Create a code wiki from a folder in a code repository.

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

Delete a wiki

To delete a wiki, enter the az devops wiki delete command.

Note

You can use this command only to delete a code wiki. You can't use the command to delete a project wiki.

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

Parameters

  • --wiki: Required. Name or ID of the wiki to delete.
  • --project -p: Optional. Name or ID of the project. You can configure the default project using az devops configure -d project=NAME_OR_ID. Required if not configured as default or picked up via git config.
  • --subscription: Optional. Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.
  • --yes -y: Optional. Don't prompt for confirmation.

Example

Delete a wiki without a prompt for confirmation.

az devops wiki delete --wiki myprojectwiki --yes

List wikis

To list all the wikis in a project or an organization, enter the az devops wiki list command.

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

Optional parameters

  • --project -p: Optional. Name or ID of the project.
  • --scope: Optional. List the wikis at project or organization level. Accepted values: organization, project. Default value: project.
  • --subscription: Optional. Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Examples

List all wikis for a project.

az devops wiki list

List all wikis in the organization.

az devops wiki list --scope organization

Show wiki

To show details of a wiki, enter the az devops wiki show command.

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

Parameters

  • --wiki: Required. Name or ID of the wiki.
  • --open: Optional. Open the wiki page in your web browser.
  • --project -p: Optional. Name or ID of the project.
  • --subscription: Optional. Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Example

Show the wiki named 'myprojectwiki' and open the wiki page in your web browser.

az devops wiki show --wiki myprojectwiki --open

Create a wiki page

To add a new wiki page, enter the az devops wiki page create command.

az devops wiki page create --path
                           --wiki
                           [--comment]
                           [--content]
                           [--encoding {ascii, utf-16be, utf-16le, utf-8}]
                           [--file-path]
                           [--project]
                           [--subscription]

Parameters

  • --path: Required. Path of the wiki page.
  • --wiki: Required. Name or ID of the wiki.
  • --comment: Optional. Comment in the commit message of file add operation. Default value: Added a new page using Azure DevOps CLI.
  • --content: Optional. Content of the wiki page. Ignored if --file-path is specified.
  • --encoding: Optional. Encoding of the file. Used with --file-path parameter.
  • --file-path: Optional. Path of the file input if content is specified in the file.
  • --project -p: Optional. Name or ID of the project.
  • --subscription: Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

Examples

Create a new page with path 'my page' in a wiki named 'myprojectwiki' with inline content.

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

Create a new page with path 'my page' in a wiki named 'myprojectwiki' with content from a file.

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