dsc kaynak listesi

Özet

İsteğe bağlı bir filtre ile kullanılabilir DSC Kaynaklarının listesini alır.

Sözdizimi

dsc resource list [Options] <RESOURCE_NAME>

Tarif

Alt komut, list kullanılabilir DSC Kaynaklarını arar ve bilgilerini döndürür. DSC, önce veya PATH ortam değişkeninde DSC_RESOURCE_PATH , .dsc.resource.jsonve .dsc.resource.yml files için dsc.resource.yamlarama yaparak kaynakları bulur. DSC'nin kullandığı ortam değişkenleri hakkında daha fazla bilgi için bkz: Ortam değişkenleri

Bulunan kaynaklardan herhangi biri kaynak bağdaştırıcılarıysa, list seçeneği eşleşen bir filtre belirtiyorsa DSC bu bağdaştırıcılar için işlemi çağırır. Varsayılan olarak, DSC uyarlanmış kaynak döndürmez. Seçeneği kullandığınızda --adapter , komut uyarlanmamış herhangi bir kaynak döndürmez.

DSC, bulunan kaynakların listesini uygulama bilgileri ve meta verileriyle birlikte döndürür. Komut bağımsız değişkeni RESOURCE_NAME içeriyorsa, DSC bulunan kaynakların listesini döndürmeden önce filtreler. ve --description--tags seçenekleri, sonuçları kaynak açıklamalarına ve etiketlere göre filtreler. Filtreler her zaman kaynak bulmadan sonra uygulanır.

Uyarlanmış kaynak önbelleği

DSC, performans optimizasyonu için keşfedilen uyarlanmış kaynakların önbelleğini tutar. Önbelleğin konumu, aşağıdaki tabloda gösterildiği gibi işletim sistemine bağlıdır.

İşletim sistemi Önbellek yolu
Linux işletim sistemi ~/.dsc/AdaptedResourcesLookupTable.json
macOS ~/.dsc/AdaptedResourcesLookupTable.json
Windows %LOCALAPPDATA%\dsc\AdaptedResourcesLookupTable.json

Örnekler

Örnek 1 - Uyarlanmamış tüm kaynakları listeleme

Herhangi bir filtre olmadan, komut bulunan her DSC Kaynağını döndürür, ancak uyarlanmış kaynakları numaralandırmak için bağdaştırıcı kaynakları için işlemi çağırmaz list .

dsc resource list

Type                                        Kind      Version  Capabilities  RequireAdapter  Description
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Microsoft.DSC.Debug/Echo                    Resource  1.0.0    gs--t---
Microsoft.DSC.Transitional/RunCommandOnSet  Resource  0.1.0    gs------                      Takes a single-command line to execute on DSC set operation      
Microsoft.DSC/Assertion                     Group     0.1.0    gs--t---                      `test` will be invoked for all resources in the supplied configu…
Microsoft.DSC/Group                         Group     0.1.0    gs--t---                      All resources in the supplied configuration is treated as a grou…
Microsoft.DSC/Include                       Importer  0.1.0    gs--t---                      Allows including a configuration file with optional parameter fi…
Microsoft.DSC/PowerShell                    Adapter   0.1.0    gs--t-e-                      Resource adapter to classic DSC Powershell resources.
Microsoft.Windows/RebootPending             Resource  0.1.0    g-------                      Returns info about pending reboot.
Microsoft.Windows/Registry                  Resource  0.1.0    gs-w-d--                      Manage Windows Registry keys and values
Microsoft.Windows/WMI                       Adapter   0.1.0    g-------                      Resource adapter to WMI resources.
Microsoft.Windows/WindowsPowerShell         Adapter   0.1.0    gs--t---                      Resource adapter to classic DSC Powershell resources in Windows …
Microsoft/OSInfo                            Resource  0.1.0    g-----e-                      Returns information about the operating system.

Örnek 2 - Belirli bir kaynağı listeleme

RESOURCE_NAME Bağımsız değişken bir joker karakter içermediğinde, komut yalnızca belirtilen tür adına sahip kaynağı döndürür.

dsc resource list Microsoft.DSC/Group

Type                 Kind   Version  Capabilities  RequireAdapter  Description
-------------------------------------------------------------------------------------------------------------------------------------
Microsoft.DSC/Group  Group  0.1.0    gs--t---                      All resources in the supplied configuration is treated as a group.

Örnek 3 - Eşleşen tür adıyla kaynakları listeleme

Bağımsız RESOURCE_NAME değişken bir joker karakter içerdiğinde, komut her kaynağı eşleşen bir tür adına sahip olarak döndürür.

dsc resource list Microsoft.DSC/*

Type                      Kind      Version  Capabilities  RequireAdapter  Description
--------------------------------------------------------------------------------------------------------------------------------------------------
Microsoft.DSC/Assertion   Group     0.1.0    gs--t---                      `test` will be invoked for all resources in the supplied configuration.
Microsoft.DSC/Group       Group     0.1.0    gs--t---                      All resources in the supplied configuration is treated as a group.
Microsoft.DSC/Include     Importer  0.1.0    gs--t---                      Allows including a configuration file with optional parameter file.
Microsoft.DSC/PowerShell  Adapter   0.1.0    gs--t-e-                      Resource adapter to classic DSC Powershell resources.

Örnek 4 - Eşleşen açıklamaya sahip kaynakları listeleme

Komut *--description seçeneğini içerdiğinde, sonuçlar belirtilen değeri içeren bir açıklamaya sahip kaynakları içerir.

dsc resource list --description 'supplied configuration'

Type                     Kind   Version  Capabilities  RequireAdapter  Description
----------------------------------------------------------------------------------------------------------------------------------------------
Microsoft.DSC/Assertion  Group  0.1.0    gs--t---                      `test` will be invoked for all resources in the supplied configuration.
Microsoft.DSC/Group      Group  0.1.0    gs--t---                      All resources in the supplied configuration is treated as a group.

Örnek 5 - Eşleşen etiketlerle kaynakları listeleme

Komut, seçeneğin --tags birden çok örneğini içerdiğinde, sonuçlar belirtilen etiketlerden herhangi birine sahip kaynakları içerir.

dsc resource list --tags Windows --tags Linux

Type                        Kind      Version  Capabilities  RequireAdapter  Description
----------------------------------------------------------------------------------------------------------------------------
Microsoft.Windows/Registry  Resource  0.1.0    gs-w-d--                      Manage Windows Registry keys and values
Microsoft/OSInfo            Resource  0.1.0    g-----e-                      Returns information about the operating system.

Örnek 6 - Belirli bir bağdaştırıcının kaynaklarını listeleme

Komut seçeneği --adapter içerdiğinde, DSC eşleşen bir ada sahip bulunan kaynak bağdaştırıcılarını denetler. Herhangi birini bulursa, bağdaştırıcı için işlemi çağırır list ve döndürülen uyarlanmış kaynak listesini bulunan kaynak listesine ekler. DSC, bu numaralandırmadan sonra komutuyla belirtilen diğer filtreleri uygular.

dsc resource list --adapter Microsoft.Windows/WindowsPowerShell

Bu sonraki komut, döndürülen kaynakların listesini sınırlayan kaynak adı filtresini *Windows*belirtir:

dsc resource list --adapter Microsoft.Windows/WindowsPowerShell *Windows*

Bağımsız değişken

RESOURCE_NAME

Bulunan DSC Kaynaklarının tür adları için uygulanacak isteğe bağlı bir filtre belirtir. Filtre joker karakterler (*) içerebilir. Filtre büyük/küçük harfe duyarlı değildir.

Bu bağımsız değişken belirtildiğinde, DSC sonuçları yalnızca kaynak türü adının filtreyle eşleştiği kaynakları içerecek şekilde filtreler.

Örneğin, filtrenin Microsoft.* belirtilmesi yalnızca Microsoft tarafından yayımlanan kaynakları döndürür. Filtrenin *Sql* belirtilmesi, büyük/küçük harften bağımsız olarak, adında dize Sql bulunan herhangi bir kaynağı döndürür.

Type      : string
Mandatory : false

Seçenekler

-a, --adaptör

Uyarlanmış kaynakların listeleneceği bağdaştırıcı kaynaklarını tanımlamak için bir filtre belirtir. Varsayılan olarak, komut bağdaştırıcı kaynakları için komutu çağırmaz list . Bu seçeneği belirttiğinizde, DSC filtreyle eşleşen tür adlarıyla bağdaştırıcı kaynaklarını arar. Filtreyle eşleşen herhangi bir bağdaştırıcı bulursa, bu bağdaştırıcılar için komutu çağırır list ve uyarlanan kaynakları döndürür. DSC, komut için başka filtreler uygulamadan önce uyarlanmış kaynakları alır.

Bu seçeneği kullandığınızda, komut uyarlanmamış herhangi bir kaynak döndürmez.

Bu seçeneği filtreyle *belirtirseniz, DSC diğer filtreleri uygulamadan önce bulduğu her bağdaştırıcı kaynağını çağırır list .

Type        : string
Mandatory   : false
LongSyntax  : --adapter <ADAPTER_NAME>
ShortSyntax : -a <ADAPTER_NAME>

-d, --açıklama

Kaynağın açıklamasında eşleşecek dizeyi belirtir. Bu seçenek belirtildiğinde, DSC kaynakları açıklama dizelerine göre filtreler. Filtre büyük/küçük harfe duyarlı değildir ve açıklama dizesinin herhangi bir yerindeki değerle eşleşir. Joker karakterlere izin verilmez.

Type        : string
Mandatory   : false
LongSyntax  : --description <DESCRIPTION>
ShortSyntax : -d <DESCRIPTION>

-t, --etiketleri

Filtre uygulamak için bir kaynak etiketi belirtir. Bu seçenek belirtildiğinde, DSC kaynakları filtreler ve yalnızca eşleşen etikete sahip olanları içerir. Filtre büyük/küçük harfe duyarlı değildir. Joker karakterlere izin verilmez.

Bir etiket kümesine filtre uygulamak için bu seçeneği birden çok kez belirtebilirsiniz. Sonuçlar, bu seçenekle belirtilen etiketlerden en az birine sahip kaynakları içerir.

Type        : string
Mandatory   : false
LongSyntax  : --tags <TAGS>
ShortSyntax : -t <TAGS>

-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.
  • table-no-truncate Her satırı geçerli konsol genişliğine kesmeden verileri bir özet tablo 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ı bu belgenin Çıktı bölümünde açıklanan bir özet tablo olarak 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, table-no-truncate]
LongSyntax  : --output-format <OUTPUT_FORMAT>
ShortSyntax : -o <OUTPUT_FORMAT>

-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

Çıktı

Bu komut, kaynağın türünü, sürümünü, bildirim ayarlarını ve diğer meta verilerini içeren her kaynak için bir nesne içeren biçimlendirilmiş bir dizi döndürür. Daha fazla bilgi için bkz: dsc kaynak listesi sonuç şeması.

Komutun çıkışı yakalanmaz veya yeniden yönlendirilmezse, döndürülen kaynaklar için varsayılan olarak konsolda özet tablosu olarak görüntülenir. Özet tablosu, listelenen sırada görüntülenen aşağıdaki sütunları içerir:

  • Tür - Kaynağın tam tür adı.

  • Tür - Kaynağın , adapter, groupveya tipik importerolup Resourceolmadığı. Daha fazla bilgi için bkz: DSC Kaynak türü şema başvurusu.

  • Sürüm - Kaynağın anlamsal sürümü.

  • Yetenekler - Kaynağın yeteneklerinin bayraklar olarak görüntülenmesi. Yetenekler, kaynağın belirli bir yeteneği yoksa uygun harf yerine a - kullanılarak aşağıdaki sırayla görüntülenir:

    Örneğin, Microsoft.Windows/Registry kaynak aşağıdaki yeteneklere sahiptir: gs--d-, , getve set yeteneklerine deletesahip olduğunu gösterir.

  • RequireAdapter - DSC'nin döndürülen kaynağı çağırmak için kullandığı bağdaştırıcı kaynağının tam tür adı.

  • Açıklama - Kaynağın amacının ve kullanımının kısa açıklaması.

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

  • Last updated on