DSC

  • Článek

Synopse

Použití konfigurace nebo vyvolání konkrétních prostředků pro správu softwarových komponent

Syntax

dsc [Options] <COMMAND>

Příkazy

completer

Příkaz completer vrátí skript prostředí, který po spuštění zaregistruje dokončení pro dané prostředí. Další informace najdete v tématu completer.

config

Příkaz config spravuje dokument konfigurace DSC. Můžete ho použít k:

  • Získejte aktuální stav konfigurace.
  • Otestujte, jestli je konfigurace v požadovaném stavu.
  • Nastavte konfiguraci do požadovaného stavu.

Další informace najdete v tématu konfigurace.

prostředek

Příkaz resource spravuje prostředek DSC. Můžete ho použít k:

  • Vypište dostupné prostředky.
  • Získejte schéma JSON pro instance prostředku.
  • Získejte aktuální stav instance prostředku.
  • Otestujte, jestli je instance prostředku v požadovaném stavu.
  • Nastavte instanci prostředku do požadovaného stavu.

Další informace najdete v tématu prostředek.

schema

Příkaz schema vrátí schéma JSON pro konkrétní typ DSC. Další informace najdete v tématu schéma.

Nápověda

Příkaz help vrátí informace nápovědy pro příkaz dsc, příkaz nebo dílčí příkaz.

Pokud chcete získat nápovědu k příkazu nebo podpříkazu, použijte syntaxi:

dsc help <COMMAND> [<SUBCOMMAND>]

dsc help config Například získá nápovědu pro config podpříkaz. dsc help config set získá pomoc pro config set dílčí příkaz.

K zobrazení informací nápovědy můžete u příkazu použít také možnost --help . Příkladem je dsc config --help nebo dsc config set --help.

Možnosti

-h, --help

Zobrazí nápovědu k aktuálnímu příkazu nebo dílčímu příkazu. Když zadáte tuto možnost, aplikace ignoruje všechny možnosti a argumenty za touto možností.

Type:      Boolean
Mandatory: false

-l, --trace-level

Definuje minimální úroveň zprávy, kterou by měl DSC vygenerovat během operace. Zprávy v DSC jsou kategorizovány podle jejich úrovně.

Následující seznam obsahuje platné úrovně zpráv od nejvyšší po nejnižší. Pokud je tato možnost nastavená na libovolnou hodnotu v seznamu, služba DSC vygeneruje zprávy na této a vyšší úrovni.

  • error
  • warning (výchozí)
  • info
  • debug
  • trace

Upozornění

Výstup trace úrovně vygeneruje všechny vstupy a výstupy JSON, které DSC zpracovává během provádění. DSC před vygenerováním kódu JSON nešifikuje. Tato úroveň trasování je určená jenom pro vývojáře. Nikdy nepřesměrovávejte trace výstup úrovně do úložiště, protože může obsahovat citlivé informace.

Pokud je debugnapříklad úroveň protokolu , DSC vysílá zprávy pro každou úroveň protokolu s výjimkou trace. Pokud je errorúroveň protokolu , DSC pouze generuje chybové zprávy. DSC ignoruje každou zprávu s nižší úrovní protokolu.

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

-f, --trace-format

Definuje výstupní formát, který se má použít při generování zpráv trasování na stderru. DSC podporuje následující formáty:

  • default – Vygeneruje zprávu s obarvením konzoly ANSI pro časové razítko, úroveň zprávy a číslo řádku.
  • plaintext - Jako default bez jakýchkoliv barev konzoly.
  • json – Vygeneruje každou zprávu jako komprimovaný objekt JSON s vlastnostmi časového razítka, úrovně, zprávy a čísla řádku.
Type:         String
Mandatory:    false
DefaultValue: default
ValidValues:  [default, plaintext, json]

-V, --version

Zobrazí verzi aplikace. Když zadáte tuto možnost, aplikace ignoruje všechny možnosti a argumenty za touto možností.

Type:      Boolean
Mandatory: false

Proměnné prostředí

Ve výchozím nastavení dsc příkaz vyhledává manifesty prostředků DSC založené na příkazech ve složkách definovaných proměnnou PATH prostředí. Pokud je proměnná DSC_RESOURCE_PATH prostředí definovaná, dsc prohledá složky v DSC_RESOURCE_PATH místo PATH.

Prostředí DSC_RESOURCE_PATH musí být proměnnou prostředí, která se řídí stejnými konvencemi jako PATH proměnná prostředí pro operační systém. Cesty ke složkám oddělte středníkem (;) ve Windows a dvojtečkami (:) na jiných platformách.

Ukončovací kódy

Příkaz dsc používá sémantické ukončovací kódy. Každý ukončovací kód představuje jiný výsledek pro spuštění příkazu.

Ukončovací kód Význam
0 Příkaz se úspěšně spustil bez chyb.
1 Příkaz selhal, protože obdržel neplatné argumenty.
2 Příkaz selhal, protože prostředek vyvolal chybu.
3 Příkaz selhal, protože hodnotu nebylo možné serializovat nebo deserializovat z JSON.
4 Příkaz selhal, protože vstup pro příkaz nebyl platný YAML nebo JSON.
5 Příkaz se nezdařil, protože definice prostředku nebo hodnota instance byla pro jeho schéma JSON neplatná.
6 Příkaz byl zrušen přerušením ctrl+C .