Eksportowanie konfiguracji dsc

Streszczenie

Generuje dokument konfiguracji, który definiuje istniejące wystąpienia zestawu zasobów.

Składnia

Dokument konfiguracji ze stdin

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

Dokument konfiguracji z ciągu opcji

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

Dokument konfiguracji z pliku

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

Opis

Podpolecenia export generuje dokument konfiguracji, który zawiera każde wystąpienie zestawu zasobów.

Dokument konfiguracji musi zostać przekazany do tego polecenia jako plik JSON lub YAML za pośrednictwem narzędzia stdin, jako ciąg z opcją dokumentu lub z pliku z opcją ścieżki .

Konfiguracja wejściowa definiuje zasoby do wyeksportowania. Rozszerzenie DSC ignoruje wszystkie właściwości określone dla zasobów w konfiguracji wejściowej dla operacji, ale dokument wejściowy i wszelkie właściwości wystąpień zasobów muszą nadal weryfikować względem dokumentu konfiguracji i schematów wystąpień zasobów.

Określ tylko zasoby z manifestem zasobu, który definiuje sekcję eksportu w konfiguracji wejściowej. Zdefiniuj tylko jeden typ zasobu. Jeśli dokument konfiguracji zawiera jakiekolwiek wystąpienie zasobu, w którym typ zasobu nie jest eksportowalny lub został już zadeklarowany w konfiguracji, rozszerzenie DSC zgłasza błąd.

Opcje

-d, --document

Określa dokument konfiguracji do wyeksportowania z jako obiekt JSON lub YAML. Rozszerzenie DSC weryfikuje dokument względem schematu dokumentu konfiguracji. Jeśli weryfikacja nie powiedzie się, rozszerzenie DSC zgłosi błąd.

Tej opcji nie można używać z dokumentem konfiguracji za pośrednictwem narzędzia stdin lub --path opcji. Wybierz, czy chcesz przekazać dokument konfiguracji do polecenia za pośrednictwem narzędzia stdin, z pliku z --path opcją , czy z opcją --document .

Type:      String
Mandatory: false

-p, --path

Definiuje ścieżkę do dokumentu konfiguracji w celu wyeksportowania zamiast potokowania dokumentu ze stdin lub przekazania go jako ciągu z opcją --document . Określony plik musi zawierać dokument konfiguracji jako obiekt JSON lub YAML. Rozszerzenie DSC weryfikuje dokument względem schematu dokumentu konfiguracji. Jeśli walidacja zakończy się niepowodzeniem lub jeśli określony plik nie istnieje, rozszerzenie DSC zgłosi błąd.

Ta opcja wyklucza się wzajemnie z opcją --document . Jeśli używasz tej opcji, DSC ignoruje wszystkie dane wejściowe ze stdin.

Type:      String
Mandatory: false

-f, --format

Opcja --format steruje formatem danych wyjściowych konsoli dla polecenia . Jeśli dane wyjściowe polecenia są przekierowywane lub przechwytywane jako zmienna, dane wyjściowe są zawsze danymi JSON.

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

-h, --help

Wyświetla pomoc dla bieżącego polecenia lub podpolecenia. Po określeniu tej opcji aplikacja ignoruje wszystkie opcje i argumenty po tej opcji.

Type:      Boolean
Mandatory: false

Dane wyjściowe

To polecenie zwraca dane wyjściowe JSON, które definiują dokument konfiguracji, w tym każde wystąpienie zasobów zadeklarowanych w konfiguracji wejściowej. Aby uzyskać więcej informacji, zobacz Dokumentacja schematu dokumentu konfiguracji DSC.