dsc

خلاصه

تطبيق الإعدادات أو استدعاء موارد محددة لإدارة مكونات البرمجيات.

إعراب

dsc [Options] <COMMAND>

الاوامر

المكملة

completer تعيد هذه الأوامر سكريبت shell، وعند تنفيذه، يسجل الإكمال للقشرة المعطاة. لمزيد من المعلومات، راجع مكتمل dsc.

config

config تدير هذه الأوامر وثيقة تكوين DSC. يمكنك استخدامه من أجل:

• احصل على الحالة الحالية للتكوين.
• اختبر ما إذا كان التكوين في الحالة المطلوبة.
• قم بتعيين تكوين على الحالة المطلوبة.

لمزيد من المعلومات، راجع إعدادات dsc.

resource

تدير القيادة resource مورد DSC. يمكنك استخدامه من أجل:

• اذكر الموارد المتاحة.
• احصل على مخطط JSON لحالات المورد.
• احصل على الحالة الحالية لمثيل المورد.
• اختبر ما إذا كان المورد في الحالة المطلوبة.
• قم بتعيين نسخة مورد على الحالة المطلوبة.

لمزيد من المعلومات، راجع مورد dsc

المخطط

يرجع schema الأمر مخطط JSON لنوع DSC معين. لمزيد من المعلومات، راجع مخطط dsc.

تعليمات

يعيد الأمر help معلومات المساعدة ل dsc، أو أمر، أو أمر فرعي.

للحصول على المساعدة في أمر أو أمر فرعي، استخدم النحو التالي:

dsc help <COMMAND> [<SUBCOMMAND>]

على سبيل المثال، dsc help config يحصل على المساعدة في config الأمر الفرعي. dsc help config set يحصل على المساعدة للأمر config set الفرعي.

يمكنك أيضا استخدام خيار المساعدة في أمر لعرض معلومات المساعدة. على سبيل المثال، dsc config --help أو dsc config set --help.

الخيارات

-ل، --مستوى الأثر

يحدد الحد الأدنى لمستوى الرسالة الذي يجب أن يصدره DSC أثناء العملية. يتم تصنيف الرسائل في DSC حسب مستواها.

تظهر القائمة التالية مستويات الرسائل الصالحة من أعلى إلى أدنى مستوى. عندما يتم تعيين هذا الخيار على أي قيمة في القائمة، يرسل DSC رسائل على ذلك المستوى وما فوق.

• error
• warn (افتراضي)
• info
• debug
• trace

تحذير

يصدر إخراج trace المستوى جميع إدخالات/مخرجات JSON التي يعالجها DSC أثناء التنفيذ. DSC لا يقوم بتعقيم JSON قبل إطلاقه. هذا المستوى الأثري مخصص فقط لاستخدام المطورين. لا تعيد توجيه trace مخرجات المستوى إلى التخزين لأنها قد تحتوي على معلومات حساسة.

على سبيل المثال، عندما يكون مستوى السجل هو debug، يصدر DSC رسائل لكل مستوى سجل ما عدا trace. عندما يكون مستوى السجل هو error، فإن DSC يصدر فقط رسائل الخطأ. DSC يتجاهل كل رسالة تحتوي على مستوى سجل أقل.

Type         : string
Mandatory    : false
DefaultValue : warn
ValidValues  : [error, warn, info, debug, trace]
LongSyntax   : --trace-level <TRACE_LEVEL>
ShortSyntax  : -l <TRACE_LEVEL>

-f, --trace-format

يحدد تنسيق الإخراج المستخدم عند إرسال رسائل التتبع على stderr. يدعم DSC الصيغ التالية:

• default - يرسل الرسالة بتلوين وحدة تحكم ANSI للطابع الزمني ومستوى الرسالة ورقم السطر.
• plaintext - كما default لو لم تكن ألوان الكونسول.
• json - يرسل كل رسالة ككائن JSON مضغوط مع طابع زمني، مستوى، رسالة، ورقم سطر كخصائص.

Type         : string
Mandatory    : false
DefaultValue : default
ValidValues  : [default, plaintext, json]
LongSyntax   : --trace-format <TRACE_FORMAT>
ShortSyntax  : -f <TRACE_FORMAT>

-p, --progress-format

يحدد تنسيق التقدم المستخدم عند إرسال رسائل التقدم على stderr. يدعم DSC الصيغ التالية:

• default - يظهر شريط تقدم إذا اكتشف DSC أنه يتم استدعاؤه بشكل تفاعلي. بخلاف ذلك، لا يظهر DSC أي تقدم.
• none - لا يظهر أي تقدم.
• json - يصدر التقدم ككائنات JSON مضغوطة مع طابع زمني، مستوى، رسالة، ورقم سطر كخصائص.

Type         : string
Mandatory    : false
DefaultValue : default
ValidValues  : [default, none, json]
LongSyntax   : --progress-format <PROGRESS_FORMAT>
ShortSyntax  : -p <PROGRESS_FORMAT>

-V، --نسخة

يعرض إصدار التطبيق. عندما تحدد هذا الخيار، يتجاهل التطبيق جميع الخيارات والمقترحات باستثناء --help، الذي يتجاوز هذا الخيار.

Type        : boolean
Mandatory   : false
LongSyntax  : --version
ShortSyntax : -V

-h، --help

يعرض التعليمات الخاصة بالأمر الحالي أو الأمر الفرعي الحالي. عند تحديد هذا الخيار، يتجاهل التطبيق جميع الخيارات والوسيطات الأخرى.

Type        : boolean
Mandatory   : false
LongSyntax  : --help
ShortSyntax : -h

متغيرات البيئة

افتراضيا، يبحث الأمر dsc عن تجسيات موارد DSC في المجلدات التي يحددها PATH المتغير البيئة. إذا DSC_RESOURCE_PATH كان متغير البيئة معرفا، dsc يبحث في المجلدات بدلا DSC_RESOURCE_PATH من PATH.

يجب أن DSC_RESOURCE_PATH تكون البيئة متغيرا بيئيا يتبع نفس الاتفاقيات التي يتبعها PATH متغير البيئة في نظام التشغيل. افصل مسارات المجلدات مع فاصلة منقوطة (;) على Windows ونقطتين (:) على منصات أخرى.

رموز الخروج

يستخدم الأمر dsc رموز خروج دلالية. يمثل كل رمز خروج نتيجة مختلفة لتنفيذ الأمر.

رمز الخروج	المعنى
0	تم تنفيذ الأمر بنجاح دون أي أخطاء.
1	فشل الأمر لأنه تلقى وسائط غير صالحة.
2	فشل الأمر لأن موردا ظهر خطأ.
3	فشل الأمر لأن قيمة لم يكن بالإمكان تسلسلها أو إلغاء تسلسلي من JSON.
4	فشل الأمر لأن إدخال الأمر لم يكن صالحا في YAML أو JSON.
5	فشل الأمر لأن تعريف المورد أو قيمة المثيل كانت غير صالحة ضد مخطط JSON الخاص به.
6	تم إلغاء الأمر بسبب انقطاع Ctrl+C .

ملاحظات

تتوقع DSC أن تستخدم سلاسل الإدخال ترميز UTF-8. عند تمرير الإدخال من stdin أو المسار إلى ملف، تأكد من أن الإدخال مشفر ك UTF-8.