Export prostředků dsc

Přehled

Vytvoří konfigurační dokument, který definuje existující instance konkrétního zdroje.

Syntaxe

Bez vlastností instance

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

Vlastnosti instance z možnosti vstupu

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

Vlastnosti instance ze souboru

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

Vlastnosti instance ze stdin

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

Popis

Dílčí export příkaz vygeneruje konfigurační dokument, který obsahuje všechny instance konkrétního zdroje. Prostředek musí být zadán s touto --resource možností.

Počínaje DSC 3.1.0 můžete pomocí --input možnosti nebo --file určit instanci prostředku, která se má použít jako filtr pro exportované prostředky. Pokud tak učiníte, určená instance se předá prostředku pro použití při filtrování. Implementace filtrování závisí na každém prostředku, nikoli na samotném DSC.

Exportovatelné prostředky zadejte pouze pomocí manifestu zdroje, který definuje oddíl exportu ve vstupní konfiguraci. Pokud zadaný typ prostředku nelze exportovat, DSC vyvolá chybu.

Možnosti

-r, --zdroj

Určuje plně kvalifikovaný název typu prostředku DSC, který se má exportovat, například Microsoft.Windows/Registry.

Plně kvalifikovaná syntaxe názvu typu je: <owner>[.<group>][.<area>]/<name>, kde:

• Je owner udržující autor nebo organizace zdroje.
• A grouparea jsou volitelné součásti názvů, které umožňují mezeru mezi názvy pro prostředek.
• Identifikuje name komponentu, kterou prostředek spravuje.

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

-i, --vstup

Určuje instanci prostředku, která se má použít jako filtr pro exportované instance prostředků.

Instance musí být řetězec obsahující objekt JSON nebo YAML. DSC ověří objekt proti schématu instance prostředku. Pokud se ověření nezdaří, DSC vyvolá chybu.

Tato možnost se vzájemně vylučuje s touto --file možností.

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

-f, --soubor

Definuje cestu k souboru definující instanci prostředku, která se má použít jako filtr pro exportované instance prostředků.

Zadaný soubor musí obsahovat objekt JSON nebo YAML, který představuje platné vlastnosti prostředku. DSC ověří objekt proti schématu instance prostředku. Pokud se ověření nezdaří nebo pokud zadaný soubor neexistuje, DSC vyvolá chybu.

Tato možnost se vzájemně vylučuje s touto --input možností.

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

-o, --výstupní-formát

Tato --output-format možnost určuje, jaký formát DSC použije pro data, která příkaz vrátí. K dispozici jsou následující formáty:

• json vygenerujte data jako řádek JSON.
• pretty-json vygenerujte data jako JSON s novými řádky, odsazením a mezerami pro čitelnost.
• yaml vygenerujte data jako YAML.

Výchozí výstupní formát závisí na tom, zda DSC zjistí, že je výstup přesměrován nebo zachycen jako proměnná:

• Pokud příkaz není přesměrován nebo zachycen, DSC zobrazí výstup jako formát v konzole yaml .
• Pokud je výstup příkazu přesměrován nebo zachycen, DSC vygeneruje data ve json formátu pro stdout.

Pokud použijete tuto možnost, DSC použije určený formát bez ohledu na to, zda je příkaz přesměrováván nebo zachycován.

Pokud příkaz není přesměrován nebo zachycen, výstup v konzole je naformátován tak, aby byl lépe čitelný. Pokud příkaz není přesměrován nebo zachycen, výstup obsahuje sekvence terminálů pro formátování.

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

-h, --help (--nápověda)

Zobrazí nápovědu k aktuálnímu příkazu nebo dílčímu příkazu. Když tuto volbu určíte, aplikace ignoruje všechny ostatní volby a argumenty.

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

Výstup

Tento příkaz vrátí formátovaná data, která definují konfigurační dokument včetně všech instancí zdrojů deklarovaných ve vstupní konfiguraci. Další informace najdete v referenčních informacích ke schématu konfiguračního dokumentu DSC.

Další informace o formátování výstupních dat naleznete v části --output-format volba.