CLI를 사용하여 위키 관리
Azure DevOps Services
위키를 관리하기 위한 다음 CLI 명령을 알아봅니다.
메모
CLI를 사용하여 프로젝트 위키를 삭제할 수 없습니다.
필수 구성 요소
| 범주 | 요구 사항 |
|---|---|
| 프로젝트 액세스 | 위키가 있는 프로젝트의 구성원입니다. 액세스 권한이 없는 경우 프로젝트 관리자에게 요청합니다. |
| 사용 권한 | 기여자 그룹의 구성원입니다. |
| 액세스 수준 | 적어도 기본 액세스. |
명령
| 명령 | 묘사 |
|---|---|
| az devops wiki create | 위키를 만듭니다. |
| az devops 위키 삭제 | 위키를 삭제합니다. |
| az devops wiki 목록 나열 | 프로젝트 또는 조직의 모든 위키를 나열합니다. |
| az devops wiki 페이지 | 위키 페이지를 관리합니다. |
| az devops wiki 페이지 만들기 | 새 페이지를 추가합니다. |
| az devops wiki 페이지 삭제 | 페이지를 삭제합니다. |
| az devops 위키 페이지 표시 | 페이지의 콘텐츠를 얻거나 페이지를 엽니다. |
| az devops wiki 페이지 업데이트 | 페이지를 편집합니다. |
| 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: [
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사용하여 기본 구독을 구성할 수 있습니다.
예제
인라인 콘텐츠가 있는 myprojectwiki 위키에 경로 my page 있는 새 페이지를 만듭니다.
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