dsc yapılandırması

Özet

Bir yapılandırma belgesi uygulayın.

Sözdizimi

dsc config [Options] <COMMAND>

Açıklama

Komut dsc config , bir DSC yapılandırma belgesinde tanımlanan kaynak örneklerini yönetmek için alt komutlar içerir. Kaynakları doğrudan yönetmek için dsc resource komutuna bakın.

Komutlar

dışarı aktarma

Komut export , bir kaynak kümesinin mevcut örneklerini tanımlayan bir yapılandırma belgesi oluşturur. Daha fazla bilgi için bkz: dsc config export.

almak / edinmek / bulmak

Komut get , bir yapılandırma belgesindeki kaynak örneklerinin geçerli durumunu alır. Daha fazla bilgi için bkz: dsc config get.

ayarlamak

Komut set , bir yapılandırma belgesindeki kaynak örneklerinin istenen durumunu zorlar. Daha fazla bilgi için bkz: dsc config set.

deneme

Komut test , bir yapılandırma belgesindeki kaynak örneklerinin istenen durumda olup olmadığını doğrular. Daha fazla bilgi için bkz: dsc yapılandırma testi.

Yardım

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

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

dsc config help [<SUBCOMMAND>]

Örneğin, dsc config help bu komut için yardım alır. dsc config help set alt komut için set yardım alır.

Yardım bilgilerini görüntülemek için komut veya alt komuttaki --help seçeneğini de kullanabilirsiniz. Örneğin, dsc config --help veya dsc config set --help.

Seçenekler

-f, --parametreler-dosyası

Yapılandırmaya JSON veya YAML olarak geçirilecek parametreleri içeren bir veri dosyasının yolunu belirtir. Bu seçeneği belirttiğinizde, DSC veri dosyasındaki anahtarları parametre olarak yorumlar ve belirtilen değerleri kullanır. Veri dosyasındaki değerler, yapılandırmanın kendisinde tanımlanan tüm varsayılanları geçersiz kılar.

Veri dosyası, anahtarla parameters birlikte bir nesne içermelidir. Anahtarın parameters değeri, her anahtarın tanımlı bir parametrenin adı olduğu ve her değerin bu parametre için geçerli bir değer olduğu bir nesne olmalıdır.

Bu seçenek, seçenek ile --parameters birbirini dışlar.

DSC sürüm 3.1.0'dan başlayarak, parametre verilerini stdin üzerinden bir alt komuta geçirebilirsiniz. Bunu yaptığınızda, yapılandırma belgesini bir giriş dizesi veya sistemdeki bir dosyanın yolu olarak geçirmeniz gerekir. Hem parametreler dosyasını hem de yapılandırma belgesini stdin'den bir komuta geçiremezsiniz.

Bir yapılandırma belgesinde parametreleri tanımlama hakkında daha fazla bilgi için DSC Yapılandırma belgesi parametre şemasına bakın. Yapılandırma belgesinde parametreleri kullanma hakkında daha fazla bilgi için, parametreler işlev başvurusuna bakın.

Type        : string
Mandatory   : false
LongSyntax  : --parameters-file <PARAMETERS_FILE>
ShortSyntax : -f <PARAMETERS_FILE>

-p, --parametreleri

Yapılandırma belgesine JSON veya YAML olarak biçimlendirilmiş bir veri dizesi olarak geçirilecek parametreleri belirtir. Bu seçeneği belirttiğinizde, DSC veri dizesindeki anahtarları parametre olarak yorumlar ve belirtilen değerleri kullanır. Veri dizesindeki değerler, yapılandırma belgesinin kendisinde tanımlanan tüm varsayılanları geçersiz kılar.

Veri dizesi, anahtara sahip parameters bir nesne içermelidir. Anahtarın parameters değeri, her anahtarın tanımlı bir parametrenin adı olduğu ve her değerin bu parametre için geçerli bir değer olduğu bir nesne olmalıdır.

Bu seçenek, seçenek ile --parameters_file birbirini dışlar.

Bir yapılandırma belgesinde parametreleri tanımlama hakkında daha fazla bilgi için DSC Yapılandırma belgesi parametre şemasına bakın. Yapılandırma belgesinde parametreleri kullanma hakkında daha fazla bilgi için, parametreler işlev başvurusuna bakın.

Type        : string
Mandatory   : false
LongSyntax  : --parameters <PARAMETERS>
ShortSyntax : -p <PARAMETERS>

-r, --sistem-kökü

Geçerli çalışan işletim sistemini hedeflemediğinizde işletim sistemi kökünün yolunu belirtmek için bu seçeneği kullanın.

Type        : string
Mandatory   : false
LongSyntax  : --system-root <SYSTEM_ROOT>
ShortSyntax : -r <SYSTEM_ROOT>

-h, --help (yardım)

Geçerli komut veya alt komutun yardımını 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

Alt dsc config * komutlar, DSC_CONFIG_ROOT komut için kullanılacak yapılandırma belgesini belirtme seçeneğiyle --path bir komut çağırdığınızda ortam değişkenini oluşturur. DSC, ortam değişkeninin değerini DSC_CONFIG_ROOT , belirtilen yapılandırma belgesini içeren klasörün tam yoluna ayarlar.

Uyarı

Değişkeni DSC'nin DSC_CONFIG_ROOT dışında tanımlarsanız, DSC bir işlem için mevcut ortam değişkeninin değerini geçersiz kıldığında bir uyarı verir.

Yapılandırmadaki kaynak örnekleri için bu klasör yoluna başvurmak üzere envvar yapılandırma işlevini kullanabilirsiniz.