dsc-konfigurationsexport

Synopsis

Genererar ett konfigurationsdokument som definierar befintliga instanser av en uppsättning resurser.

Syntax

Konfigurationsdokument från stdin

<document-string> | dsc config export [Options]

Konfigurationsdokument från alternativsträng

dsc config export [Options] --document <document-string>

Konfigurationsdokument från fil

dsc config export [Options] --path <document-filepath>

Description

Underkommandot export genererar ett konfigurationsdokument som innehåller varje instans av en uppsättning resurser.

Konfigurationsdokumentet måste skickas till det här kommandot som JSON eller YAML över stdin, som en sträng med dokumentalternativet eller från en fil med sökvägsalternativet .

Indatakonfigurationen definierar de resurser som ska exporteras. DSC ignorerar alla egenskaper som anges för resurserna i indatakonfigurationen för åtgärden, men indatadokumentet och eventuella egenskaper för resursinstanser måste fortfarande verifieras mot konfigurationsdokumentet och resursinstansscheman.

Ange endast resurser med ett resursmanifest som definierar exportavsnittet i indatakonfigurationen. Definiera endast varje resurstyp en gång. Om konfigurationsdokumentet innehåller en resursinstans där resurstypen inte kan exporteras eller redan har deklarerats i konfigurationen genererar DSC ett fel.

Alternativ

-d, --document

Anger konfigurationsdokumentet som ska exporteras från som ett JSON- eller YAML-objekt. DSC validerar dokumentet mot konfigurationsdokumentschemat. Om verifieringen misslyckas genererar DSC ett fel.

Det här alternativet kan inte användas med konfigurationsdokumentet över stdin eller alternativet --path . Välj om du vill skicka konfigurationsdokumentet till kommandot över stdin, från en fil med --path alternativet eller med --document alternativet .

Type:      String
Mandatory: false

-p, --path

Definierar sökvägen till ett konfigurationsdokument som ska exporteras i stället för att skicka dokumentet från stdin eller skicka det som en sträng med alternativet --document . Den angivna filen måste innehålla ett konfigurationsdokument som ett JSON- eller YAML-objekt. DSC validerar dokumentet mot konfigurationsdokumentschemat. Om verifieringen misslyckas, eller om den angivna filen inte finns, genererar DSC ett fel.

Det här alternativet är ömsesidigt uteslutande med alternativet --document . När du använder det här alternativet ignorerar DSC alla indata från stdin.

Type:      String
Mandatory: false

-f, --format

Alternativet --format styr konsolens utdataformat för kommandot. Om kommandoutdata omdirigeras eller avbildas som en variabel är utdata alltid JSON.

Type:         String
Mandatory:    false
DefaultValue: yaml
ValidValues:  [json, pretty-json, yaml]

-h, --help

Visar hjälpen för det aktuella kommandot eller underkommandot. När du anger det här alternativet ignorerar programmet alla alternativ och argument efter det här alternativet.

Type:      Boolean
Mandatory: false

Utdata

Det här kommandot returnerar JSON-utdata som definierar ett konfigurationsdokument, inklusive varje instans av resurserna som deklareras i indatakonfigurationen. Mer information finns i dokumentschemareferensen för DSC-konfiguration.