次の方法で共有

CLI を使用して Wiki を管理する

Azure DevOps Services

Wiki を管理するための次の CLI コマンドについて説明します。

注

CLI を使用してプロジェクト Wiki を削除することはできません。

[前提条件]

カテゴリ 要求事項
プロジェクトへのアクセス Wiki が配置されているプロジェクトのメンバー。 アクセス権がない場合は、プロジェクト管理者に依頼してください。
アクセス許可 共同作成者 グループのメンバー。
アクセス レベル 少なくとも Basic アクセス。

コマンド

コマンド 説明
az devops wiki 作成 Wiki を作成します。
az devops wiki delete（ウィキを削除するコマンド） Wiki を削除します。
az devops wiki list プロジェクトまたは組織のすべての Wiki を一覧表示します。
az devops wiki page Wiki ページを管理します。
az devops wiki page create 新しいページを追加します。
az devops wiki ページの削除 ページを削除します。
az devops wiki ページを表示 ページのコンテンツを取得するか、ページを開きます。
az devops wiki ページの更新 ページを編集します。
az devops wiki show Wiki の詳細を表示します。

Wiki を作成する

wiki を作成するには、 az devops wiki create コマンドを入力します。

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

省略可能なパラメーター

  • --mapped-path: [ codewiki 型に必須] 新しい wiki のマップされたパス 。たとえば、リポジトリのルートから発行 / 。
  • --name: 新しい Wiki の名前。
  • --project -p: 省略可能。 プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_IDを使用して既定のプロジェクトを構成します。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。
  • --repository -r: [ codewiki の種類に必要] Wiki を発行するリポジトリの名前または ID。
  • --subscription: 省略可能。 サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成します。
  • --type --wiki-type: 作成する Wiki の種類。 指定できる値: codewiki、projectwiki。 既定値: projectwiki。

例示

名前付きプロジェクト Wiki を作成します。

az devops wiki create --name myprojectwiki

コード リポジトリ内のフォルダーからコード Wiki を作成します。

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

Wiki を削除する

wiki を削除するには、 az devops wiki delete コマンドを入力します。

注

このコマンドは、プロジェクト Wiki を削除する場合ではなく、コード Wiki を削除する場合にのみ使用できます。

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

パラメーター

  • --wiki: 必須。 削除する Wiki の名前または ID。
  • --project -p: 省略可能。 プロジェクトの名前または ID。 az devops configure -d project=NAME_OR_ID を使用して、既定のプロジェクトを構成できます。 既定として構成されていない場合、または git 構成を使用して取得された場合は必須です。
  • --subscription: 省略可能。 サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。
  • --yes -y: 省略可能。 確認を求めるプロンプトを表示しません。

例

確認を求めずに Wiki を削除します。

az devops wiki delete --wiki myprojectwiki --yes

Wiki を一覧表示する

プロジェクトまたは組織のすべての Wiki を一覧表示するには、 az devops wiki list コマンドを入力します。

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

省略可能なパラメーター

  • --project -p: 省略可能。 プロジェクトの名前または ID。
  • --scope: オプションです。 プロジェクトまたは組織レベルで Wiki を一覧表示します。 指定できる値: organization、project。 既定値: project。
  • --subscription: 省略可能。 サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

例示

プロジェクトのすべての Wiki を一覧表示します。

az devops wiki list

組織内のすべての Wiki を一覧表示します。

az devops wiki list --scope organization

Wiki を表示する

wiki の詳細を表示するには、 az devops wiki show コマンドを入力します。

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

パラメーター

  • --wiki: 必須。 Wiki の名前または ID。
  • --open: 省略可能。 Web ブラウザーで Wiki ページを開きます。
  • --project -p: 省略可能。 プロジェクトの名前または ID。
  • --subscription: 省略可能。 サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成します。

例

myprojectwikiという名前の Wiki を表示し、Web ブラウザーで Wiki ページを開きます。

az devops wiki show --wiki myprojectwiki --open

Wiki ページを作成する

新しい Wiki ページを追加するには、 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]

パラメーター

  • --path: 必須。 Wiki ページのパス。
  • --wiki: 必須。 Wiki の名前または ID。
  • --comment: 省略可能。 ファイル追加操作のコミット メッセージのコメント。 既定値: added a new page using Azure DevOps CLI。
  • --content: 省略可能。 Wiki ページのコンテンツ。 指定されている場合 --file-path は無視されます。
  • --encoding: 省略可能。 ファイルのエンコード。 パラメーターと共に --file-path 使用されます。
  • --file-path: 省略可能。 ファイルにコンテンツが指定されている場合のファイル入力のパス。
  • --project -p: 省略可能。 プロジェクトの名前または ID。
  • --subscription: サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

例示

インライン コンテンツを含む my page という名前の wiki に、パス myprojectwikiを含む新しいページを作成します。

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

ファイルの内容を含む 'myprojectwiki' という Wiki に、パス 'my page' を含む新しいページを作成します。

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