Dsc

Áttekintés

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

Szintaxis

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.

konfiguráció

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ós.

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 állapotba.

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

séma

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

segítség

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

Ha segítségre van szüksége egy parancshoz vagy alparancshoz, használja a szintaxist:

dsc help <COMMAND> [<SUBCOMMAND>]

A dsc help config például a config alparancshoz kap segítséget. dsc help config set segítséget kap a config set alparancshoz.

A parancsok --help beállításával is megjelenítheti a súgóinformációkat. 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. A beállítás megadásakor 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 minimális üzenetszintet kell-e kibocsátania 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 lista bármely értékére van állítva, a DSC üzeneteket bocsát ki ezen a szinten és felett.

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

Figyelmeztetés

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

Ha például a naplószint debug, a DSC a tracekivételével minden naplószintről küld üzeneteket. Ha a naplószint error, a DSC 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álandó kimeneti formátumot. A DSC a következő formátumokat támogatja:

• default – ANSI-konzol színezéssel küldi el az üzenetet az időbélyeg, az üzenetszint és a sorszám alapján.
• plaintext – default, de konzolszínek nélkül.
• json – Az egyes üzeneteket tömörített JSON-objektumként bocsátja ki tulajdonságokké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. A beállítás megadásakor 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 az PATH környezeti változó által meghatározott mappákban. Ha a DSC_RESOURCE_PATH környezeti változó definiálva van, dscPATHhelyett DSC_RESOURCE_PATH mappáiban keres.

A DSC_RESOURCE_PATH környezetnek olyan környezeti változónak kell lennie, amely ugyanazokat az egyezményeket követi, mint az operációs rendszer PATH környezeti változója. Különítse el a mappa elérési útjait pontosvesszővel (;) a Windowson, a kettőspontot (:) pedig 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	Jelentés
0	A parancs hiba nélkül sikeresen végrehajtva.
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 nem sikerült, mert egy értéket nem sikerült szerializálni vagy deszerializálni A JSON-ból.
4	A parancs nem sikerült, 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 egy a Ctrl+C megszakítása megszakította.

Notes

A DSC arra számít, hogy a bemeneti sztringek UTF-8 kódolást használnak. Ha az stdinből vagy egy fájl elérési útjából ad át bemenetet, győződjön meg arról, hogy a bemenet UTF-8 kóddal van kódolva.