CLI를 사용하여 위키 관리

Azure DevOps Services

위키를 관리하기 위한 다음 CLI 명령을 알아봅니다.

참고 항목

CLI를 사용하여 프로젝트 위키를 삭제할 수 없습니다.

명령

명령 description
az devops wiki create 위키를 만듭니다.
az devops wiki delete 위키를 삭제합니다.
az devops wiki list 프로젝트 또는 조직의 모든 위키를 나열합니다.
az devops wiki 페이지 위키 페이지를 관리합니다.
az devops wiki page create 새 페이지를 추가합니다.
az devops wiki page delete 페이지를 삭제합니다.
az devops wiki page show 페이지의 콘텐츠를 얻거나 페이지를 엽니다.
az devops wiki page update 페이지를 편집합니다.
az devops wiki show 위키의 세부 정보를 표시합니다.

위키 만들기

wiki를 만들려면 명령을 입력합니다 az devops wiki create .

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

선택적 매개 변수

  • --mapped-path: [형식에 필요 codewiki ] 리포지토리의 루트에서 게시할 새 wiki / 의 매핑된 경로입니다.
  • --name: 새 위키의 이름입니다.
  • --project -p: 선택 사항입니다. 프로젝트의 이름 또는 ID입니다. 를 사용하여 az devops configure -d project=NAME_OR_ID기본 프로젝트를 구성합니다. 기본값으로 구성되지 않았거나 git 구성을 통해 선택되는 경우 필수입니다.
  • --repository -r: [형식에 필요] wiki를 codewiki 게시할 리포지토리의 이름 또는 ID입니다.
  • --subscription: 선택 사항입니다. 구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성합니다.
  • --type --wiki-type: 만들 위키의 유형입니다. 허용되는 값: codewiki, . projectwiki 기본값: projectwiki.

예제

명명된 프로젝트 wiki를 만듭니다.

az devops wiki create --name myprojectwiki

코드 리포지토리의 폴더에서 코드 위키를 만듭니다.

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

위키 삭제

wiki를 삭제하려면 명령을 입력합니다 az devops wiki delete .

참고 항목

이 명령은 프로젝트 위키를 삭제하지 않고 코드 위키를 삭제하는 데만 사용할 수 있습니다.

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

매개 변수

  • --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: 선택 사항입니다. 확인 메시지를 표시하지 않습니다.

예시

확인 프롬프트 없이 위키를 삭제합니다.

az devops wiki delete --wiki myprojectwiki --yes

위키 나열

프로젝트 또는 조직의 모든 위키를 나열하려면 명령을 입력합니다 az devops wiki list .

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

선택적 매개 변수

  • --project -p: 선택 사항입니다. 프로젝트의 이름 또는 ID입니다.
  • --scope: 선택 사항입니다. 프로젝트 또는 조직 수준에서 위키를 나열합니다. 허용되는 값: organization, . project 기본값: project.
  • --subscription: 선택 사항입니다. 구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

예제

프로젝트의 모든 위키를 나열합니다.

az devops wiki list

조직의 모든 위키를 나열합니다.

az devops wiki list --scope organization

위키 표시

위키의 세부 정보를 표시하려면 명령을 입력합니다 az devops wiki show .

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

매개 변수

  • --wiki: 필수입니다. 위키의 이름 또는 ID입니다.
  • --open: 선택 사항입니다. 웹 브라우저에서 위키 페이지를 엽니다.
  • --project -p: 선택 사항입니다. 프로젝트의 이름 또는 ID입니다.
  • --subscription: 선택 사항입니다. 구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성합니다.

예시

명명 myprojectwiki 된 위키를 표시하고 웹 브라우저에서 위키 페이지를 엽니다.

az devops wiki show --wiki myprojectwiki --open

위키 페이지 만들기

새 위키 페이지를 추가하려면 명령을 입력합니다 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: 필수입니다. 위키의 이름 또는 ID입니다.
  • --comment: 선택 사항입니다. 파일 추가 작업의 커밋 메시지 주석을 추가합니다. 기본값: added a new page using Azure DevOps CLI.
  • --content: 선택 사항입니다. 위키 페이지의 내용입니다. 지정된 경우 --file-path 무시됩니다.
  • --encoding: 선택 사항입니다. 파일 인코딩 매개 변수와 함께 --file-path 사용됩니다.
  • --file-path: 선택 사항입니다. 파일에 콘텐츠가 지정된 경우 파일 입력의 경로입니다.
  • --project -p: 선택 사항입니다. 프로젝트의 이름 또는 ID입니다.
  • --subscription: 구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

예제

인라인 콘텐츠가 포함된 위키에 경로 my page 가 있는 myprojectwiki 새 페이지를 만듭니다.

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

파일의 콘텐츠가 포함된 'myprojectwiki'라는 위키에 경로가 'my page'인 새 페이지를 만듭니다.

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