Bagikan melalui

Mengelola wiki dengan CLI

  • Artikel

Layanan Azure DevOps

Pelajari perintah CLI berikut untuk mengelola wiki.

Nota

Anda tidak dapat menghapus wiki proyek dengan CLI.

Prasyarat

Kategori Persyaratan
Akses Proyek Anggota proyek tempat wiki berada. Jika Anda tidak memiliki akses, mintalah dari administrator proyek Anda.
Izin Anggota grup Kontributor.
Tingkat akses Setidaknya akses Dasar.

Perintah

Perintah deskripsi
az devops wiki buat Buat wiki.
az devops wiki delete Menghapus wiki.
daftar wiki devops az Mencantumkan semua wiki dalam proyek atau organisasi.
halaman wiki az devops Mengelola halaman wiki.
az devops membuat halaman wiki Tambahkan halaman baru.
az devops hapus halaman wiki Menghapus halaman.
az devops wiki halaman tampilkan Dapatkan konten halaman atau buka halaman.
pembaruan halaman wiki az devops Sunting halaman.
az devops wiki tampilkan Perlihatkan detail wiki ini.

Membuat wiki

Untuk membuat wiki, masukkan perintah az devops wiki create.

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

Parameter opsional

  • --mapped-path: [Diperlukan untuk tipe codewiki] Jalur yang dipetakan dari wiki baru, misalnya, / akan diterbitkan dari root repositori.
  • --name: Nama wiki baru.
  • --project -p: Opsional. Nama atau ID proyek. Konfigurasikan proyek default menggunakan az devops configure -d project=NAME_OR_ID. Diperlukan jika tidak dikonfigurasi sebagai default atau dideteksi melalui git config.
  • --repositori -r: [Diperlukan untuk jenis codewiki] Nama atau ID repositori untuk menerbitkan wiki.
  • --subscription: Pilihan. Nama atau ID langganan. Konfigurasikan langganan default menggunakan az account set -s NAME_OR_ID.
  • --type --wiki-type: Jenis wiki yang akan dibuat. Nilai yang diterima: codewiki, projectwiki. Nilai default: projectwiki.

Contoh

Buat wiki proyek bernama.

az devops wiki create --name myprojectwiki

Buat wiki kode dari folder di repositori kode.

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

Menghapus wiki

Untuk menghapus wiki, masukkan perintah az devops wiki delete.

Nota

Anda hanya dapat menggunakan perintah ini hanya untuk menghapus wiki kode, bukan untuk menghapus wiki proyek.

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

Parameter

  • --wiki: Diperlukan. Nama atau ID wiki yang akan dihapus.
  • --project -p: Opsional. Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=NAME_OR_ID. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil dari git config.
  • --subscription: Opsional. Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.
  • --yes -y: Opsional. Jangan meminta konfirmasi.

Contoh

Hapus wiki tanpa permintaan konfirmasi.

az devops wiki delete --wiki myprojectwiki --yes

Daftar wiki

Untuk mencantumkan semua wiki dalam proyek atau organisasi, masukkan perintah az devops wiki list.

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

Parameter opsional

  • --project -p: Opsional. Nama atau ID proyek.
  • --scope: Opsional. Cantumkan wiki di tingkat proyek atau organisasi. Nilai yang diterima: organization, project. Nilai default: project.
  • --subscription: Opsional. Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Contoh

Mencantumkan semua wiki untuk sebuah proyek.

az devops wiki list

Cantumkan semua wiki dalam organisasi.

az devops wiki list --scope organization

Tampilkan wiki

Untuk memperlihatkan detail wiki, masukkan perintah az devops wiki show.

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

Parameter

  • --wiki: Diperlukan. Nama atau ID wiki.
  • --buka: Pilihan. Buka halaman wiki di browser web Anda.
  • --project -p: Opsional. Nama atau ID proyek.
  • --subscription: Pilihan. Nama atau ID langganan. Konfigurasikan langganan default menggunakan az account set -s NAME_OR_ID.

Contoh

Perlihatkan wiki bernama myprojectwiki dan buka halaman wiki di browser web Anda.

az devops wiki show --wiki myprojectwiki --open

Membuat halaman wiki

Untuk menambahkan halaman wiki baru, masukkan perintah 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]

Parameter

  • --path: Diperlukan. Jalur halaman wiki.
  • --wiki: Diperlukan. Nama atau ID wiki.
  • --comment: Opsional. Komentari dalam pesan penerapan operasi penambahan file. Nilai default: added a new page using Azure DevOps CLI.
  • --content: Opsional. Konten halaman wiki. Diabaikan jika --file-path ditentukan.
  • --encoding: Opsional. Pengkodean file. Digunakan dengan parameter --file-path.
  • --file-path: Opsional. Jalur input file jika konten ditentukan dalam file.
  • --project -p: Opsional. Nama atau ID proyek.
  • --subscription: Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

Contoh

Buat halaman baru dengan jalur my page di wiki bernama myprojectwiki dengan konten inline.

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

Buat halaman baru dengan jalur 'halaman saya' di wiki bernama 'myprojectwiki' dengan isi dari sebuah berkas.

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