Delen via

dsc

  • Artikel

Synopsis

Pas configuratie toe of roep specifieke resources aan om softwareonderdelen te beheren.

Syntax

dsc [Options] <COMMAND>

Opdracht

completer

De completer opdracht retourneert een shellscript dat, wanneer uitgevoerd, voltooiingen voor de opgegeven shell registreert. Zie completer voor meer informatie.

configuratie

Met de config opdracht wordt een DSC-configuratiedocument beheerd. U kunt deze gebruiken voor het volgende:

  • Haal de huidige status van de configuratie op.
  • Test of een configuratie de gewenste status heeft.
  • Stel een configuratie in op de gewenste status.

Zie config (Configuratie) voor meer informatie.

resource

Met de resource opdracht wordt een DSC-resource beheerd. U kunt deze gebruiken voor het volgende:

  • De beschikbare resources weergeven.
  • Haal het JSON-schema op voor de exemplaren van een resource.
  • De huidige status van een resource-exemplaar ophalen.
  • Test of een resource-exemplaar de gewenste status heeft.
  • Stel een resource-exemplaar in op de gewenste status.

Zie resource voor meer informatie

schema

De schema opdracht retourneert het JSON-schema voor een specifiek DSC-type. Zie schema voor meer informatie.

help

De help opdracht retourneert Help-informatie voor dsc, een opdracht of een subopdracht.

Als u de help voor een opdracht of subopdracht wilt krijgen, gebruikt u de syntaxis:

dsc help <COMMAND> [<SUBCOMMAND>]

Krijgt bijvoorbeeld dsc help config de hulp voor de config subopdracht. dsc help config set krijgt de hulp voor de config set subopdracht.

U kunt ook de --help-optie voor een opdracht gebruiken om de Help-informatie weer te geven. Bijvoorbeeld dsc config --help of dsc config set --help.

Opties

-h, --help

Geeft de Help weer voor de huidige opdracht of subopdracht. Wanneer u deze optie opgeeft, worden alle opties en argumenten na deze optie genegeerd.

Type:      Boolean
Mandatory: false

-l, --trace-level

Hiermee definieert u het minimale berichtniveau dat DSC moet verzenden tijdens een bewerking. Berichten in DSC worden gecategoriseerd op niveau.

In de volgende lijst ziet u de geldige berichtniveaus van het hoogste naar het laagste niveau. Wanneer deze optie is ingesteld op een waarde in de lijst, verzendt DSC berichten op dat niveau en hoger.

  • error
  • warning (standaard)
  • info
  • debug
  • trace

Waarschuwing

De trace uitvoer op niveau verzendt alle JSON-invoer/-uitvoer die DSC tijdens de uitvoering verwerkt. DSC maakt de JSON niet op voordat deze wordt verzonden. Dit traceringsniveau is alleen bedoeld voor gebruik door ontwikkelaars. U kunt uitvoer op niveau nooit omleiden trace naar de opslag, omdat deze gevoelige informatie kan bevatten.

Wanneer het logboekniveau bijvoorbeeld is debug, verzendt DSC berichten voor elk logboekniveau, met uitzondering van trace. Wanneer het logboekniveau is error, verzendt DSC alleen foutberichten. DSC negeert elk bericht met een lager logboekniveau.

Type:         String
Mandatory:    false
DefaultValue: warning
ValidValues:  [error, warning, info, debug, trace]

-f, --trace-format

Definieert de uitvoerindeling die moet worden gebruikt bij het verzenden van traceringsberichten op stderr. DSC ondersteunt de volgende indelingen:

  • default - Verzendt het bericht met ANSI-consolekleuring voor het tijdstempel, berichtniveau en regelnummer.
  • plaintext - Als default maar zonder consolekleuren.
  • json - Verzendt elk bericht als een gecomprimeerd JSON-object met de tijdstempel, het niveau, het bericht en het regelnummer als eigenschappen.
Type:         String
Mandatory:    false
DefaultValue: default
ValidValues:  [default, plaintext, json]

-V, --version

Geeft de versie van de toepassing weer. Wanneer u deze optie opgeeft, worden alle opties en argumenten na deze optie genegeerd.

Type:      Boolean
Mandatory: false

Omgevingsvariabelen

Standaard zoekt de dsc opdracht naar dsc-resourcemanifesten op basis van opdrachten in de mappen die zijn gedefinieerd door de PATH omgevingsvariabele. Als de DSC_RESOURCE_PATH omgevingsvariabele is gedefinieerd, dsc zoekt u in de mappen in DSC_RESOURCE_PATH in plaats van PATH.

De DSC_RESOURCE_PATH omgeving moet een omgevingsvariabele zijn die dezelfde conventies volgt als de PATH omgevingsvariabele voor het besturingssysteem. Scheid mappaden met een puntkomma (;) in Windows en een dubbele punt (:) op andere platforms.

Afsluitcodes

De dsc opdracht maakt gebruik van semantische afsluitcodes. Elke afsluitcode vertegenwoordigt een ander resultaat voor de uitvoering van de opdracht.

Afsluitcode Betekenis
0 De opdracht is zonder fouten uitgevoerd.
1 De opdracht is mislukt omdat deze ongeldige argumenten heeft ontvangen.
2 De opdracht is mislukt omdat een resource een fout heeft gegenereerd.
3 De opdracht is mislukt omdat een waarde niet kan worden geserialiseerd naar of gedeserialiseerd vanuit JSON.
4 De opdracht is mislukt omdat de invoer voor de opdracht geen geldige YAML of JSON is.
5 De opdracht is mislukt omdat een resourcedefinitie of exemplaarwaarde ongeldig is op basis van het JSON-schema.
6 De opdracht is geannuleerd door een Ctrl+C-onderbreking .