dsc

Sinopsis

Terapkan konfigurasi atau panggil sumber daya tertentu untuk mengelola komponen perangkat lunak.

Syntax

dsc [Options] <COMMAND>

Commands

Penyelesai

Perintah mengembalikan completer skrip shell yang, ketika dijalankan, mendaftarkan penyelesaian untuk shell yang diberikan. Untuk informasi selengkapnya, lihat pelengkap dsc.

config

Perintah ini config mengelola dokumen Konfigurasi DSC. Anda dapat menggunakannya untuk:

• Dapatkan status konfigurasi saat ini.
• Uji apakah konfigurasi dalam status yang diinginkan.
• Atur konfigurasi ke status yang diinginkan.

Untuk informasi selengkapnya, lihat konfigurasi dsc.

resource

Perintah mengelola resource Sumber Daya DSC. Anda dapat menggunakannya untuk:

• Cantumkan sumber daya yang tersedia.
• Dapatkan skema JSON untuk instans sumber daya.
• Dapatkan status instans sumber daya saat ini.
• Uji apakah instans sumber daya dalam status yang diinginkan.
• Atur instans sumber daya ke status yang diinginkan.

Untuk informasi selengkapnya, lihat sumber daya dsc

skema

Perintah mengembalikan schema skema JSON untuk jenis DSC tertentu. Untuk informasi selengkapnya, lihat skema dsc.

bantuan

Perintah mengembalikan help informasi bantuan untuk dsc, perintah, atau subperintah.

Untuk mendapatkan bantuan untuk perintah atau subperintah, gunakan sintaks:

dsc help <COMMAND> [<SUBCOMMAND>]

Misalnya, dsc help config mendapatkan bantuan untuk config subperintah. dsc help config set mendapatkan bantuan untuk config set subperintah.

Anda juga dapat menggunakan opsi --help pada perintah untuk menampilkan informasi bantuan. Misalnya, dsc config --help atau dsc config set --help.

Opsi

-l, --tingkat jejak

Menentukan tingkat pesan minimum yang harus dipancarkan DSC selama operasi. Pesan di DSC dikategorikan berdasarkan levelnya.

Daftar berikut menunjukkan tingkat pesan yang valid dari tingkat tertinggi ke terendah. Ketika opsi ini diatur ke nilai apa pun dalam daftar, DSC memancarkan pesan pada tingkat tersebut dan di atasnya.

• error
• warn (standar)
• info
• debug
• trace

Warning

Output trace level memancarkan semua input/output JSON yang diproses DSC selama eksekusi. DSC tidak membersihkan JSON sebelum memancarkannya. Tingkat pelacakan ini hanya ditujukan untuk penggunaan pengembang. Jangan pernah mengalihkan trace output level ke penyimpanan karena mungkin berisi informasi sensitif.

Misalnya, ketika tingkat log adalah debug, DSC memancarkan pesan untuk setiap tingkat log kecuali trace. Ketika tingkat log adalah error, DSC hanya memancarkan pesan kesalahan. DSC mengabaikan setiap pesan dengan tingkat log yang lebih rendah.

Type         : string
Mandatory    : false
DefaultValue : warn
ValidValues  : [error, warn, info, debug, trace]
LongSyntax   : --trace-level <TRACE_LEVEL>
ShortSyntax  : -l <TRACE_LEVEL>

-f, --format jejak-

Menentukan format output yang akan digunakan saat memancarkan pesan pelacakan pada stderr. DSC mendukung format berikut:

• default - Memancarkan pesan dengan pewarnaan konsol ANSI untuk stempel waktu, tingkat pesan, dan nomor baris.
• plaintext - Seperti default tetapi tanpa warna konsol.
• json - Memancarkan setiap pesan sebagai objek JSON terkompresi dengan stempel waktu, level, pesan, dan nomor baris sebagai properti.

Type         : string
Mandatory    : false
DefaultValue : default
ValidValues  : [default, plaintext, json]
LongSyntax   : --trace-format <TRACE_FORMAT>
ShortSyntax  : -f <TRACE_FORMAT>

-p, --format-progress

Menentukan format kemajuan yang akan digunakan saat memancarkan pesan kemajuan di stderr. DSC mendukung format berikut:

• default - Menampilkan bilah kemajuan jika DSC mendeteksi bahwa itu sedang dipanggil secara interaktif. Jika tidak, DSC tidak menunjukkan kemajuan apa pun.
• none - Tidak menunjukkan kemajuan apa pun.
• json - Memancarkan kemajuan sebagai objek JSON terkompresi dengan stempel waktu, level, pesan, dan nomor baris sebagai properti.

Type         : string
Mandatory    : false
DefaultValue : default
ValidValues  : [default, none, json]
LongSyntax   : --progress-format <PROGRESS_FORMAT>
ShortSyntax  : -p <PROGRESS_FORMAT>

-V, --versi

Menampilkan versi aplikasi. Saat Anda menentukan opsi ini, aplikasi mengabaikan semua opsi dan argumen kecuali --help, yang menggantikan opsi ini.

Type        : boolean
Mandatory   : false
LongSyntax  : --version
ShortSyntax : -V

-h, --bantuan

Menampilkan bantuan untuk perintah atau sub-perintah saat ini. Saat Anda menentukan opsi ini, aplikasi mengabaikan semua opsi dan argumen lainnya.

Type        : boolean
Mandatory   : false
LongSyntax  : --help
ShortSyntax : -h

Variabel Lingkungan

Secara default, perintah mencari dsc manifes sumber daya DSC di folder yang ditentukan oleh PATH variabel lingkungan. Jika DSC_RESOURCE_PATH variabel lingkungan ditentukan, dsc cari folder di alih-alih PATHDSC_RESOURCE_PATH .

Lingkungan DSC_RESOURCE_PATH harus berupa variabel lingkungan yang mengikuti konvensi yang sama dengan PATH variabel lingkungan untuk sistem operasi. Pisahkan jalur folder dengan titik koma (;) pada Windows dan titik dua (:) di platform lain.

Kode Keluar

Perintah ini dsc menggunakan kode keluar semantik. Setiap kode keluar mewakili hasil yang berbeda untuk eksekusi perintah.

Kode Keluar	Meaning
0	Perintah berhasil dijalankan tanpa kesalahan.
1	Perintah gagal karena menerima argumen yang tidak valid.
2	Perintah gagal karena sumber daya menimbulkan kesalahan.
3	Perintah gagal karena nilai tidak dapat diserialisasikan ke atau dideserialisasi dari JSON.
4	Perintah gagal karena input untuk perintah tidak valid YAML atau JSON.
5	Perintah gagal karena definisi sumber daya atau nilai instans tidak valid terhadap skema JSON-nya.
6	Perintah dibatalkan oleh interupsi Ctrl+C .

Catatan

DSC mengharapkan string input menggunakan pengkodean UTF-8. Saat Anda meneruskan input dari stdin atau jalur ke file, pastikan input dikodekan sebagai UTF-8.