az devops wiki page

Note

This reference is part of the azure-devops extension for the Azure CLI (version 2.30.0 or higher). The extension will automatically install the first time you run an az devops wiki page command. Learn more about extensions.

Manage wiki pages.

Commands

Name	Description	Type	Status
az devops wiki page create	Add a new page.	Extension	GA
az devops wiki page delete	Delete a page.	Extension	GA
az devops wiki page show	Get the content of a page or open a page.	Extension	GA
az devops wiki page update	Edit a page.	Extension	GA

az devops wiki page create

Add a new page.

az devops wiki page create --path
                           --wiki
                           [--comment]
                           [--content]
                           [--detect {false, true}]
                           [--encoding {ascii, utf-16be, utf-16le, utf-8}]
                           [--file-path]
                           [--org --organization]
                           [--project]

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

Required Parameters

--path

Path of the wiki page.

--wiki

Name or Id of the wiki.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--comment

Comment in the commit message of file add operation.

Property	Value
Default value:	Added a new page using Azure DevOps CLI

--content

Content of the wiki page. Ignored if --file-path is specified.

--detect

Automatically detect organization.

Property	Value
Accepted values:	false, true

--encoding

Encoding of the file. Used in conjunction with --file-path parameter.

Property	Value
Default value:	utf-8
Accepted values:	ascii, utf-16be, utf-16le, utf-8

--file-path

Path of the file input if content is specified in the file.

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--project -p

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.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az devops wiki page delete

Delete a page.

az devops wiki page delete --path
                           --wiki
                           [--comment]
                           [--detect {false, true}]
                           [--org --organization]
                           [--project]
                           [--yes]

Required Parameters

--path

Path of the wiki page.

--wiki

Name or Id of the wiki.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--comment

Comment in the commit message of delete operation.

Property	Value
Default value:	Deleted the page using Azure DevOps CLI

--detect

Automatically detect organization.

Property	Value
Accepted values:	false, true

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--project -p

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.

--yes -y

Do not prompt for confirmation.

Property	Value
Default value:	False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az devops wiki page show

Get the content of a page or open a page.

az devops wiki page show --path
                         --wiki
                         [--detect {false, true}]
                         [--include-content]
                         [--open]
                         [--org --organization]
                         [--project]
                         [--recursion-level]
                         [--version]

Required Parameters

--path

Path of the wiki page.

--wiki

Name or Id of the wiki.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Automatically detect organization.

Property	Value
Accepted values:	false, true

--include-content

Include content of the page.

Property	Value
Default value:	False

--open

Open the wiki page in your web browser.

Property	Value
Default value:	False

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--project -p

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.

--recursion-level

Include subpages of the page.

--version -v

Version (ETag) of the wiki page.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False

az devops wiki page update

Edit a page.

az devops wiki page update --path
                           --version
                           --wiki
                           [--comment]
                           [--content]
                           [--detect {false, true}]
                           [--encoding {ascii, utf-16be, utf-16le, utf-8}]
                           [--file-path]
                           [--org --organization]
                           [--project]

Examples

Update content of page with path 'my page' in a wiki named 'myprojectwiki' with inline content

az devops wiki page update --path 'my page' --wiki myprojectwiki --content "Hello World"            --version 4ae78ad5835cb7dd55072fe210c9ee7eb6d6413b

Update content of page with path 'my page' in a wiki with content from a file

az devops wiki page update --path 'my page' --wiki myprojectwiki --file-path a.txt            --encoding utf-8 --version 4ae78ad5835cb7dd55072fe210c9ee7eb6d6413b

Required Parameters

--path

Path of the wiki page.

--version -v

Version (ETag) of file to edit.

--wiki

Name or Id of the wiki.

Optional Parameters

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--comment

Comment in the commit message of file edit operation.

Property	Value
Default value:	Updated the page using Azure DevOps CLI

--content

Content of the wiki page. Ignored if --file-path is specified.

--detect

Automatically detect organization.

Property	Value
Accepted values:	false, true

--encoding

Encoding of the file. Used in conjunction with --file-path parameter.

Property	Value
Default value:	utf-8
Accepted values:	ascii, utf-16be, utf-16le, utf-8

--file-path

Path of the file input if content is specified in the file.

--org --organization

Azure DevOps organization URL. You can configure the default organization using az devops configure -d organization=ORG_URL. Required if not configured as default or picked up via git config. Example: https://dev.azure.com/MyOrganizationName/.

--project -p

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.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

Property	Value
Default value:	False

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

Property	Value
Default value:	False

--output -o

Output format.

Property	Value
Default value:	json
Accepted values:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

Property	Value
Default value:	False