dsc

Synopsis

Yapılandırma uygulayın veya yazılım bileşenlerini yönetmek için belirli kaynakları çağırın.

Syntax

dsc [Options] <COMMAND>

Komutlar

Tamamlanmış

Komut, completer çalıştırıldığında verilen kabuk için tamamlanmaları kaydeden bir shell script döndürür. Daha fazla bilgi için dsc completer'a bakınız.

config

Komut, config bir DSC Yapılandırma belgesini yönetir. Şunu yapmak için kullanabilirsiniz:

• Konfigürasyonun mevcut durumunu alın.
• Bir yapılandırmanın istenen durumda olup olmadığını test edin.
• İstenilen duruma konfigürasyon ayarlayın.

Daha fazla bilgi için dsc config'e bakınız.

resource

Komut, resource bir DSC Kaynağı yönetir. Şunu yapmak için kullanabilirsiniz:

• Mevcut kaynakları listeleyin.
• Bir kaynağın örnekleri için JSON şemasını alın.
• Bir kaynak örneğinin mevcut durumunu alın.
• Bir kaynak örneğinin istenen durumda olup olmadığını test edin.
• Bir kaynak örneğini istenen duruma ayarlayın.

Daha fazla bilgi için dsc kaynağına bakınız

schema

Komut, schema belirli bir DSC tipi için JSON şemasını döndürür. Daha fazla bilgi için dsc şemasına bakınız.

Yardım

Komut, help dsc, bir komut veya alt komut için yardım bilgisi döndürür.

Bir komut veya alt komut için yardım almak için şu sözdizimi kullanın:

dsc help <COMMAND> [<SUBCOMMAND>]

Örneğin, dsc help config alt komut için yardım config alıyor. dsc help config set alt komutanlık config set için yardım alıyor.

Ayrıca yardım bilgilerini göstermek için komutta --help seçeneğini kullanabilirsiniz. Örneğin, dsc config --help veya dsc config set --help.

Options

-l, --iz seviyesi

DSC'nin bir işlem sırasında yayması gereken minimum mesaj seviyesini tanımlar. DSC'deki mesajlar seviyelerine göre kategorize edilir.

Aşağıdaki liste, en yüksekten en düşük seviyeye doğru geçerli mesaj seviyelerini gösterir. Bu seçenek listedeki herhangi bir değere ayarlandığında, DSC o seviyede ve üzerinde mesajlar gönderir.

• error
• warn (varsayılan)
• info
• debug
• trace

Warning

Seviye çıktı, trace DSC'nin yürütme sırasında işlediği tüm JSON girdi/çıktılarını yayar. DSC, JSON'u yaymadan önce dezenfekte etmez. Bu iz seviyesi yalnızca geliştiriciler için tasarlanmıştır. Seviye çıktıyı asla trace depolamaya yönlendirmeyin, çünkü hassas bilgiler içerebilir.

Örneğin, log seviyesi debugolduğunda, DSC her log seviyesi için mesaj yayar, hariç trace. Log seviyesi errorolduğunda, DSC yalnızca hata mesajları verir. DSC, daha düşük log seviyesine sahip her mesajı görmezden gelir.

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

-f, --trace-format

Stderr'de iz mesajı yayılırken kullanılacak çıkış formatını tanımlar. DSC aşağıdaki formatları destekler:

• default - Mesajı zaman damgası, mesaj seviyesi ve satır numarası için ANSI konsol renkle yayımlar.
• plaintext - Konsol renkleri olmadan, ama default konsol renkleri olmadan.
• json - Her mesajı, zaman damgası, seviye, mesaj ve satır numarası özellikleriyle sıkıştırılmış bir JSON nesnesi olarak yayımlar.

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

-p, --ilerleme formatı

Stderr'de ilerleme mesajı gönderilirken kullanılacak ilerleme formatını tanımlar. DSC aşağıdaki formatları destekler:

• default - DSC etkileşimli çağrı olduğunu tespit ederse ilerleme çubuğu gösterir. Bunun dışında, DSC herhangi bir ilerleme göstermiyor.
• none - Hiçbir ilerleme göstermiyor.
• json - Zaman damgası, seviye, mesaj ve satır numarası özellikler olarak sıkıştırılmış JSON nesneleri olarak ilerleme yayımlar.

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

-V, --versiyon

Uygulamanın sürümünü gösterir. Bu seçeneği belirttiğinizde, uygulama tüm seçenekleri ve argümanları görmezden gelir, ancak --help hariç bu seçenek geçersiz kalır.

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

-h, --help (yardım)

Geçerli komut veya alt komut için yardımı görüntüler. Bu seçeneği belirttiğinizde, uygulama diğer tüm seçenekleri ve bağımsız değişkenleri yok sayar.

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

Ortam Değişkenleri

Varsayılan olarak, dsc komut ortam değişkeniyle tanımlanan PATH klasörlerde DSC kaynak örneklerini arar. Eğer ortam DSC_RESOURCE_PATH değişkeni tanımlanmışsa, dscDSC_RESOURCE_PATH klasörleri arar.PATH

Ortam, DSC_RESOURCE_PATH işletim sistemi için ortam değişkeniyle aynı konvansiyonları PATH takip eden bir ortam değişkeni olmalıdır. Klasör yollarını ayrı bir nokta virgül (;) Windows ve diğer platformlarda iki nokta (:) ile ayırın.

Çıkış Kodları

Komut, dsc anlamsal çıkış kodları kullanır. Her çıkış kodu, komutun yürütülmesi için farklı bir sonucu temsil eder.

Çıkış Kodu	Anlamı
0	Komut hatasız başarıyla yürütüldü.
1	Komut, geçersiz argümanlar aldığı için başarısız oldu.
2	Komut, bir kaynak hata yarattığı için başarısız oldu.
3	Komut, bir değerin JSON'a seri olarak kullanılamaması veya serilikten çıkarılması mümkün olmaması nedeniyle başarısız oldu.
4	Komut, komutun girdisi geçerli YAML veya JSON olmadığı için başarısız oldu.
5	Komut, bir kaynak tanımı veya örnek değeri JSON şemasına karşı geçersiz olduğu için başarısız oldu.
6	Komut, Ctrl+C kesintisiyle iptal edildi.

Notlar

DSC, giriş dizelerinin UTF-8 kodlaması kullanmasını bekler. Stdin'den veya bir dosyaya giden yoldan girdi geçirdiğinizde, girişin UTF-8 olarak kodlandığından emin olun.