dsc kaynağı dışarı aktarma

Özet

Belirli bir kaynağın varolan örneklerini tanımlayan bir yapılandırma belgesi oluşturur.

Sözdizimi

Örnek özellikleri olmadan

dsc resource export [Options] --resource <RESOURCE>

Giriş seçeneğinden örnek özellikleri

dsc resource export --input <INPUT> --resource <RESOURCE>

Dosyadan örnek özellikleri

dsc resource export --file <FILE> --resource <RESOURCE>

stdin'den örnek özellikleri

cat <FILE> | dsc resource get [Options] --resource <RESOURCE> --file -

Açıklama

export Alt komut, belirli bir kaynağın her örneğini içeren bir yapılandırma belgesi oluşturur. Kaynak seçeneği --resource ile belirtilmelidir.

DSC 3.1.0'dan --input başlayarak, dışarı aktarılan kaynaklar için filtre olarak kullanılacak bir kaynak örneği belirtmek için veya --file seçeneğini kullanabilirsiniz. Bunu yaptığınızda, belirtilen örnek filtrelemede kullanılmak üzere kaynağa geçirilir. Filtreleme uygulaması, DSC'nin kendisine değil, her kaynağa bağlıdır.

Dışarı aktarılabilir kaynakları yalnızca giriş yapılandırmasında dışarı aktarma bölümünü tanımlayan bir kaynak bildirimiyle belirtin. Belirtilen kaynak türü dışarı aktarılabilir değilse, DSC bir hata oluşturur.

Seçenekler

-r, --kaynak

Dışarı aktarılacak DSC Kaynağının tam tür adını belirtir, örneğin Microsoft.Windows/Registry.

Tam tür adı sözdizimi şöyledir: <owner>[.<group>][.<area>]/<name>, burada:

• Kaynağın owner bakımını yapan yazar veya kuruluştur.
• ve area , group bir kaynak için ad aralığını etkinleştiren isteğe bağlı ad bileşenleridir.
• Kaynağın name yönettiği bileşeni tanımlar.

Type        : string
Mandatory   : true
LongSyntax  : --resource <RESOURCE>
ShortSyntax : -r <RESOURCE>

-i, --input

Dışarı aktarılan kaynak örnekleri için filtre olarak kullanılacak kaynak örneğini belirtir.

Örnek, JSON veya YAML nesnesi içeren bir dize olmalıdır. DSC, nesneyi kaynağın örnek şemasına göre doğrular. Doğrulama başarısız olursa, DSC bir hata oluşturur.

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

Type        : string
Mandatory   : false
LongSyntax  : --input <INPUT>
ShortSyntax : -i <INPUT>

-f, --dosya

Dışarı aktarılan kaynak örnekleri için filtre olarak kullanılacak kaynak örneğini tanımlayan bir dosyanın yolunu tanımlar.

Belirtilen dosya, kaynak için geçerli özellikleri temsil eden bir JSON veya YAML nesnesi içermelidir. DSC, nesneyi kaynağın örnek şemasına göre doğrular. Doğrulama başarısız olursa veya belirtilen dosya yoksa, DSC bir hata oluşturur.

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

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

-o, --çıktı-biçimi

Bu --output-format seçenek, komutun döndürdüğü veriler için DSC'nin hangi biçimi kullanacağını denetler. Kullanılabilir biçimler şunlardır:

• json verileri bir JSON Satırı olarak yaymak için.
• pretty-json verileri yeni satırlar, girinti ve okunabilirlik için boşluklarla JSON olarak yaymak için.
• yaml verileri YAML olarak yaymak için.

Varsayılan çıktı biçimi, DSC'nin çıktının yeniden yönlendirildiğini veya bir değişken olarak yakalandığını algılayıp algılamadığına bağlıdır:

• Komut yeniden yönlendirilmiyor veya yakalanmıyorsa, DSC çıktıyı konsolda biçim olarak yaml görüntüler.
• Komut çıktısı yeniden yönlendirilir veya yakalanırsa, DSC verileri stdout'a json biçim olarak yayar.

Bu seçeneği kullandığınızda, DSC, komutun yeniden yönlendirilip yönlendirilmediğine veya yakalanıp yakalanmadığına bakılmaksızın belirtilen biçimi kullanır.

Komut yeniden yönlendirilmediğinde veya yakalanmadığında, konsoldaki çıktı daha iyi okunabilirlik için biçimlendirilir. Komut yeniden yönlendirilmediğinde veya yakalanmadığında, çıkış biçimlendirme için terminal dizilerini içerir.

Type        : string
Mandatory   : false
ValidValues : [json, pretty-json, yaml]
LongSyntax  : --output-format <OUTPUT_FORMAT>
ShortSyntax : -o <OUTPUT_FORMAT>

-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

Çıktı

Bu komut, giriş yapılandırmasında bildirilen kaynakların her örneğini içeren bir yapılandırma belgesini tanımlayan biçimlendirilmiş verileri döndürür. Daha fazla bilgi için bkz: DSC Yapılandırması belge şeması başvurusu.

Çıktı verilerinin biçimlendirmesi hakkında daha fazla bilgi için --output-format seçeneğine bakın.