dsc

Áttekintés

Konfigurálás alkalmazása vagy adott erőforrások meghívása a szoftverösszetevők kezeléséhez.

Syntax

dsc [Options] <COMMAND>

Parancsok

completer

A completer parancs egy olyan rendszerhéjszkriptet ad vissza, amely végrehajtásakor regisztrálja az adott rendszerhéj befejezéseit. További információ: completer.

config

A config parancs egy DSC-konfigurációs dokumentumot kezel. A következőre használhatja:

• A konfiguráció aktuális állapotának lekérése.
• Ellenőrizze, hogy egy konfiguráció a kívánt állapotban van-e.
• Állítson be egy konfigurációt a kívánt állapotra.

További információ: konfiguráció.

erőforrás

A resource parancs egy DSC-erőforrást kezel. A következőre használhatja:

• Az elérhető erőforrások listázása.
• Szerezze be az erőforrás példányainak JSON-sémáját.
• Erőforráspéldány aktuális állapotának lekérése.
• Ellenőrizze, hogy egy erőforráspéldány a kívánt állapotban van-e.
• Állítson be egy erőforráspéldányt a kívánt állapotra.

További információ: erőforrás

schema

A schema parancs egy adott DSC-típus JSON-sémáját adja vissza. További információ: séma.

súgó

A help parancs a dsc, egy parancs vagy egy alparancs súgóadatait adja vissza.

Egy parancs vagy alparancs súgójának lekéréséhez használja a szintaxist:

dsc help <COMMAND> [<SUBCOMMAND>]

Lekéri például dsc help config az config alparancs súgóját. dsc help config set megkapja az alparancs súgóját config set .

A - -help lehetőséget is használhatja egy parancson a súgóinformációk megjelenítéséhez. Például dsc config --help vagy dsc config set --help.

Beállítások

-h, --help

Megjeleníti az aktuális parancs vagy alparancs súgóját. Ha ezt a beállítást adja meg, az alkalmazás figyelmen kívül hagyja az összes beállítást és argumentumot.

Type:      Boolean
Mandatory: false

-l, --trace-level

Meghatározza, hogy a DSC milyen minimális üzenetszintet adjon ki egy művelet során. A DSC-ben lévő üzenetek a szintjük szerint vannak kategorizálva.

Az alábbi lista a legmagasabbtól a legalacsonyabb szintig érvényes üzenetszinteket jeleníti meg. Ha ez a beállítás a listában szereplő bármely értékre van állítva, a DSC e-maileket bocsát ki az adott szinten és annál magasabb szinten.

• error
• warning (alapértelmezett)
• info
• debug
• trace

Figyelmeztetés

A trace szintkimenet az összes JSON-bemenetet/kimenetet kibocsátja, amelyet a DSC feldolgoz a végrehajtás során. A DSC nem fertőtleníti a JSON-t, mielőtt kibocsátja. Ez a nyomkövetési szint csak fejlesztői használatra készült. Soha ne irányítsa át trace a szintű kimenetet a tárolóba, mert bizalmas információkat tartalmazhat.

Ha például a naplószint , debuga DSC minden naplószinthez küld üzeneteket, kivéve a következőt trace: . Ha a napló szintje , a errorDSC csak hibaüzeneteket bocsát ki. A DSC figyelmen kívül hagy minden alacsonyabb naplószinttel rendelkező üzenetet.

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

-f, --trace-format

Meghatározza a nyomkövetési üzenetek stderren való kibocsátásakor használni kívánt kimeneti formátumot. A DSC a következő formátumokat támogatja:

• default – AnSI-konzol színezésével küldi el az üzenetet az időbélyeg, az üzenetszint és a sorszám számára.
• plaintext - Mint, default de konzolszínek nélkül.
• json – Minden üzenetet tömörített JSON-objektumként bocsát ki, tulajdonságként az időbélyeggel, a szinttel, az üzenettel és a sorszámmal.

Type:         String
Mandatory:    false
DefaultValue: default
ValidValues:  [default, plaintext, json]

-V, --version

Megjeleníti az alkalmazás verzióját. Ha ezt a beállítást adja meg, az alkalmazás figyelmen kívül hagyja az összes beállítást és argumentumot.

Type:      Boolean
Mandatory: false

Környezeti változók

Alapértelmezés szerint a dsc parancs parancsalapú DSC-erőforrásjegyzékeket keres a PATH környezeti változó által meghatározott mappákban. Ha a DSC_RESOURCE_PATH környezeti változó definiálva van, dsc a helyett a mappában DSC_RESOURCE_PATHPATHkeres.

A DSC_RESOURCE_PATH környezetnek olyan környezeti változónak kell lennie, amely ugyanazokat a konvenciót követi, mint az PATH operációs rendszer környezeti változója. Külön mappaútvonalak pontosvesszővel (;) Windows rendszeren és kettősponttal (:) más platformokon.

Kilépési kódok

A dsc parancs szemantikai kilépési kódokat használ. Minden kilépési kód más eredményt ad a parancs végrehajtásához.

Kilépési kód	Értelmezés
0	A parancs hiba nélkül sikeresen lefutott.
1	A parancs nem sikerült, mert érvénytelen argumentumokat kapott.
2	A parancs meghiúsult, mert egy erőforrás hibát jelzett.
3	A parancs sikertelen volt, mert egy értéket nem lehetett szerializálni vagy deszerializálni a JSON-ból.
4	A parancs sikertelen volt, mert a parancs bemenete nem volt érvényes YAML vagy JSON.
5	A parancs meghiúsult, mert egy erőforrásdefiníció vagy -példány értéke érvénytelen volt a JSON-sémán.
6	A parancsot a Ctrl+C megszakítása megszakította.