اختبار مورد dsc

الخلاصة

استدعاء عملية اختبار مورد.

بناء الجملة

خصائص المثيل من stdin

<instance-properties> | dsc resource set [Options] --resource <RESOURCE>

خصائص المثيل من خيار الإدخال

dsc resource set --input '<instance-properties>' --resource <RESOURCE>

خصائص المثيل من الملف

dsc resource set --path <instance-properties-filepath> --resource <RESOURCE>

الوصف

test يتحقق الأمر الفرعي من الحالة الفعلية لمثيل مورد مقابل الحالة المطلوبة.

يختبر هذا الأمر الفرعي مثيلا واحدا لمورد DSC معين. لاختبار موارد متعددة، استخدم مجموعة موارد أو أمر اختبار تكوين dsc .

يجب تمرير الحالة المطلوبة للمثيل المراد اختباره إلى هذا الأمر ككائن JSON أو YAML. يجب أن تكون خصائص الكائن خصائص صالحة للمورد. يمكن تمرير خصائص المثيل إلى هذا الأمر من stdin، كسلسلة مع --input الخيار، أو من ملف محفوظ مع --path الخيار .

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

يتحقق هذا الأمر من صحة خصائص المثيل فقط في ظل شرطين:

1. عندما يتم تضمين الخاصية بشكل صريح في إدخال الحالة المطلوبة.
2. عندما يكون للخاصية قيمة افتراضية ولا يتم تضمينها بشكل صريح في إدخال الحالة المطلوبة.

أمثلة

مثال 1 - اختبار مورد بخصائص من stdin

يختبر الأمر ما إذا كان Example المفتاح موجودا في خلية المستخدم الحالية. يحدد خصائص مثيل المورد ك JSON ويمررها من stdin.

'{
    "keyPath": "HKCU\\Example",
    "_exist": true
}' | dsc resource test --resource Microsoft.Windows/Registry

مثال 2 - اختبار مورد باستخدام خيار الإدخال

يختبر الأمر ما إذا كان Example المفتاح موجودا في خلية المستخدم الحالية. يحدد خصائص مثيل المورد ك JSON ويمررها مع خيار الإدخال .

dsc resource test --resource Microsoft.Windows/Registry --input '{
    "keyPath": "HKCU\\Example",
    "_exist": true
}'

مثال 3 - اختبار مورد بخصائص من ملف YAML

يختبر الأمر ما إذا كان Example المفتاح موجودا في خلية المستخدم الحالية. يحدد المسار إلى ملف YAML الذي يحدد خصائص مثيل المورد مع خيار المسار .

keyPath: HKCU\\Example
_exist:  true

dsc resource test --resource Microsoft.Windows/Registry --path ./example.yaml

الخيارات

-r، --resource

يحدد اسم النوع المؤهل بالكامل لمورد DSC المراد استخدامه، مثل Microsoft.Windows/Registry.

بناء جملة اسم النوع المؤهل بالكامل هو: <owner>[.<group>][.<area>]/<name>، حيث:

• owner هو الكاتب أو المؤسسة المحتفظ بها للمورد.
• و grouparea هما مكونان اختياريان للاسم يتيحان مسار الأسماء لمورد.
• name يحدد المكون الذي يديره المورد.

Type:      String
Mandatory: true

-i، --input

يحدد كائن JSON أو YAML مع الخصائص التي تحدد الحالة المطلوبة لمثيل مورد DSC. يتحقق DSC من صحة الكائن مقابل مخطط مثيل المورد. إذا فشل التحقق من الصحة، فإن DSC يثير خطأ.

لا يمكن استخدام هذا الخيار مع خصائص المثيل عبر stdin أو --path الخيار. اختر ما إذا كنت تريد تمرير خصائص المثيل إلى الأمر عبر stdin أو من ملف يحتوي على --path الخيار أو باستخدام --input الخيار .

Type:      String
Mandatory: false

-p، --path

يحدد المسار إلى ملف نصي للقراءة كإدخل للأمر بدلا من توجيه الإدخال من stdin أو تمريره كسلسلة مع --input الخيار . يجب أن يحتوي الملف المحدد على JSON أو YAML الذي يمثل خصائص صالحة للمورد. يتحقق DSC من صحة الكائن مقابل مخطط مثيل المورد. إذا فشل التحقق من الصحة، أو إذا لم يكن الملف المحدد موجودا، فإن DSC يثير خطأ.

هذا الخيار حصري بشكل متبادل مع --input الخيار . عند استخدام هذا الخيار، تتجاهل DSC أي إدخال من stdin.

Type:      String
Mandatory: false

-f، --format

--format يتحكم الخيار في تنسيق إخراج وحدة التحكم للأمر . إذا تمت إعادة توجيه إخراج الأمر أو التقاطه كمتغير، يكون الإخراج دائما JSON.

Type:         String
Mandatory:    false
DefaultValue: yaml
ValidValues:  [json, pretty-json, yaml]

-h، - مساعدة

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

Type:      Boolean
Mandatory: false

المخرجات

يقوم هذا الأمر بإرجاع إخراج JSON الذي يتضمن الحالة المطلوبة للمثيل والحالة الفعلية وقائمة الخصائص خارج الحالة المطلوبة وقيمة منطقية تشير إلى ما إذا كان المثيل في الحالة المطلوبة. لمزيد من المعلومات، راجع مخطط نتيجة اختبار مورد dsc.