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 trace
kivé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, dsc
PATH
helyett 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.