تكوين dsc

خلاصه

تطبيق مستند تكوين.

بناء الجملة

dsc config [Options] <COMMAND>

وصف

يتضمن الأمر dsc config أوامر فرعية لإدارة طبعات الموارد المحددة في مستند تكوين DSC. لإدارة الموارد مباشرة، راجع أمر مورد DSC .

الأوامر

تصدير

يقوم الأمر export بإنشاء مستند تكوين يحدد المثيلات الموجودة لمجموعة من الموارد. لمزيد من المعلومات، راجع تصدير تكوين DSC.

حصل

get يسترد الأمر الحالة الحالية لمثيلات الموارد في مستند تكوين. لمزيد من المعلومات، راجع الحصول على تكوين dsc.

جبر

set يفرض الأمر الحالة المطلوبة لمثيلات الموارد في مستند تكوين. لمزيد من المعلومات، راجع مجموعة تكوين DSC.

اختبر

يتحقق الأمر test مما إذا كانت مثيلات الموارد في مستند التكوين في الحالة المطلوبة. لمزيد من المعلومات، راجع اختبار تكوين DSC.

مساعدة

يقوم help الأمر بإرجاع معلومات التعليمات لهذا الأمر أو أمر فرعي.

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

dsc config help [<SUBCOMMAND>]

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

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

الخيارات

-f ، --ملف المعلمات

يحدد المسار إلى ملف بيانات يحتوي على المعلمات المراد تمريرها إلى التكوين ك JSON أو YAML. عند تحديد هذا الخيار، يفسر DSC المفاتيح الموجودة في ملف البيانات كمعلمات ويستخدم القيم المحددة. تتجاوز القيم الموجودة في ملف البيانات أي إعدادات افتراضية محددة في التكوين نفسه.

يجب أن يحتوي ملف البيانات على كائن يحتوي على المفتاح parameters . يجب أن تكون قيمة parameters المفتاح كائنا حيث يكون كل مفتاح هو اسم معلمة محددة وكل قيمة قيمة صالحة لتلك المعلمة.

هذا الخيار حصري بشكل متبادل مع الخيار --parameters .

بدءا من الإصدار 3.1.0 من DSC، يمكنك تمرير بيانات المعلمات إلى أمر فرعي عبر stdin. عند القيام بذلك، يجب تمرير مستند التكوين كسلسلة إدخال أو المسار إلى ملف على النظام. لا يمكنك تمرير كل من ملف المعلمات ومستند التكوين إلى أمر من stdin.

لمزيد من المعلومات حول تعريف المعلمات في مستند تكوين، راجع مخطط معلمة مستند تكوين DSC. لمزيد من المعلومات حول استخدام المعلمات في مستند التكوين، راجع مرجع دالة المعلمات.

Type        : string
Mandatory   : false
LongSyntax  : --parameters-file <PARAMETERS_FILE>
ShortSyntax : -f <PARAMETERS_FILE>

-ع ، --المعلمات

يحدد المعلمات المراد تمريرها إلى مستند التكوين كسلسلة من البيانات المنسقة ك JSON أو YAML. عند تحديد هذا الخيار، يفسر DSC المفاتيح الموجودة في سلسلة البيانات كمعلمات ويستخدم القيم المحددة. تتجاوز القيم الموجودة في سلسلة البيانات أي إعدادات افتراضية محددة في مستند التكوين نفسه.

يجب أن تحتوي سلسلة البيانات على كائن يحتوي على المفتاح parameters . يجب أن تكون قيمة parameters المفتاح كائنا حيث يكون كل مفتاح هو اسم معلمة محددة وكل قيمة قيمة صالحة لتلك المعلمة.

هذا الخيار حصري بشكل متبادل مع الخيار --parameters_file .

لمزيد من المعلومات حول تعريف المعلمات في مستند تكوين، راجع مخطط معلمة مستند تكوين DSC. لمزيد من المعلومات حول استخدام المعلمات في مستند التكوين، راجع مرجع دالة المعلمات.

Type        : string
Mandatory   : false
LongSyntax  : --parameters <PARAMETERS>
ShortSyntax : -p <PARAMETERS>

-r ، --نظام الجذر

استخدم هذا الخيار لتحديد المسار إلى جذر نظام التشغيل عندما لا تستهدف نظام التشغيل قيد التشغيل الحالي.

Type        : string
Mandatory   : false
LongSyntax  : --system-root <SYSTEM_ROOT>
ShortSyntax : -r <SYSTEM_ROOT>

-h، - مساعدة

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

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

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

تنشئ الأوامر dsc config * الفرعية متغير DSC_CONFIG_ROOT البيئة عند استدعاء أمر مع --path خيار تحديد مستند التكوين المراد استخدامه للأمر. يقوم DSC بتعيين قيمة DSC_CONFIG_ROOT متغير البيئة إلى المسار الكامل للمجلد الذي يحتوي على مستند التكوين المحدد.

إشعار

إذا قمت بتعريف المتغير DSC_CONFIG_ROOT خارج DSC، فإن DSC يرفع تحذيرا عندما يتجاوز قيمة متغير البيئة الحالي لعملية ما.

يمكنك استخدام وظيفة تكوين envvar للإشارة إلى مسار المجلد هذا لمثيلات الموارد في التكوين.