Share via


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]
                           [--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

--comment

Comment in the commit message of file add operation.

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.

Accepted values: false, true
--encoding

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

Accepted values: ascii, utf-16be, utf-16le, utf-8
Default value: 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.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

az devops wiki page delete

Delete a page.

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

Required Parameters

--path

Path of the wiki page.

--wiki

Name or Id of the wiki.

Optional Parameters

--comment

Comment in the commit message of delete operation.

Default value: Deleted the page using Azure DevOps CLI
--detect

Automatically detect organization.

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.

Default value: False
Global Parameters
--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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]
                         [--project]
                         [--recursion-level]
                         [--version]

Required Parameters

--path

Path of the wiki page.

--wiki

Name or Id of the wiki.

Optional Parameters

--detect

Automatically detect organization.

Accepted values: false, true
--include-content

Include content of the page.

Default value: False
--open

Open the wiki page in your web browser.

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.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.

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]
                           [--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

--comment

Comment in the commit message of file edit operation.

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.

Accepted values: false, true
--encoding

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

Accepted values: ascii, utf-16be, utf-16le, utf-8
Default value: 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.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

Accepted values: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--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.