dsc config get

Artikel
06/24/2024

Synopsis

Hämtar det aktuella tillståndet för resursinstanser i ett konfigurationsdokument.

Syntax

Konfigurationsdokument från stdin

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

Konfigurationsdokument från alternativsträng

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

Konfigurationsdokument från fil

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

Description

Underkommandot get returnerar det aktuella tillståndet för resursinstanserna i ett konfigurationsdokument. När det här kommandot körs validerar DSC konfigurationsdokumentet innan du anropar get-åtgärden för varje resursinstans som definieras i dokumentet.

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 .

Exempel

Exempel 1 – Hämta aktuellt tillstånd för en konfigurations resursinstanser

Kommandot returnerar det faktiska tillståndet för resursinstanserna som definierats i konfigurationsdokumentet som sparats som example.dsc.config.yaml.

# example.dsc.config.yaml
$schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
resources:
- name: Windows only
  type: Microsoft.DSC/Assertion
  properties:
    $schema: https://raw.githubusercontent.com/PowerShell/DSC/main/schemas/2024/04/config/document.json
    resources:
    - name: os
      type: Microsoft/OSInfo
      properties:
        family: Windows
- name: Current user registry example
  type: Microsoft.Windows/Registry
  properties:
    keyPath: HKCU\example
    _exist: true
  dependsOn:
    - "[resourceId('Microsoft.DSC/Assertion', 'Windows only')"

cat ./example.dsc.config.yaml | dsc config get

Exempel 2 – Skicka en fil att läsa som konfigurationsdokument

Kommandot använder sökvägsalternativet för att hämta de resursinstanser som definierats i example.dsc.config.yaml filen.

dsc config get --path ./example.dsc.config.yaml

Exempel 3 – Skicka ett konfigurationsdokument som en variabel

Kommandot använder dokumentalternativet för att hämta resursinstanserna som definierats i ett konfigurationsdokument som lagras i variabeln $desired .

dsc config get --document $desired

Alternativ

-d, --document

Anger konfigurationsdokumentet för att hämta det faktiska tillståndet för. Dokumentet måste vara en sträng som innehåller 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 för att hämta det faktiska tillståndet för i stället för att skicka dokumentet från stdin eller skicka det som en sträng med --document alternativet . 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 innehåller om åtgärden eller några resurser har utlöst några fel, insamlingen av meddelanden som genererats under åtgärden och hämta åtgärdsresultat för varje instans. Mer information finns i dsc config get result schema (Hämta resultatschema).

Dela via