تصدير مورد dsc

خلاصه

ينشئ مستند تكوين يحدد المثيلات الموجودة لمورد معين.

بناء الجملة

بدون خصائص المثيل

dsc resource export [Options] --resource <RESOURCE>

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

dsc resource export --input <INPUT> --resource <RESOURCE>

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

dsc resource export --file <FILE> --resource <RESOURCE>

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

cat <FILE> | dsc resource get [Options] --resource <RESOURCE> --file -

‏‏الوصف

يقوم الأمر export الفرعي بإنشاء مستند تكوين يتضمن كل مثيل لمورد معين. يجب تحديد المورد بالخيار --resource .

بدءا من DSC 3.1.0، يمكنك استخدام --input الخيار أو --file لتحديد مثيل مورد لاستخدامه كعامل تصفية للموارد المصدرة. عند القيام بذلك، يتم تمرير المثيل المحدد إلى المورد لاستخدامه في التصفية. يعتمد تنفيذ التصفية على كل مورد، وليس DSC نفسه.

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

الخيارات

-r، --resource

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

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

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

Type        : string
Mandatory   : true
LongSyntax  : --resource <RESOURCE>
ShortSyntax : -r <RESOURCE>

-i، --input

يحدد مثيل المورد لاستخدامه كعامل تصفية لمثيلات الموارد المصدرة.

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

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

Type        : string
Mandatory   : false
LongSyntax  : --input <INPUT>
ShortSyntax : -i <INPUT>

-و، --ملف

يحدد المسار إلى ملف يحدد مثيل المورد لاستخدامه كعامل تصفية لمثيلات الموارد المصدرة.

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

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

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

-o، --تنسيق الإخراج

يتحكم --output-format الخيار في التنسيق الذي يستخدمه DSC للبيانات التي يرجعها الأمر. التنسيقات المتاحة هي:

• json لإصدار البيانات كخط JSON.
• pretty-json لإصدار البيانات ك JSON مع أسطر جديدة ومسافة بادئة ومساحات لسهولة القراءة.
• yaml لإصدار البيانات ك YAML.

يعتمد تنسيق الإخراج الافتراضي على ما إذا كان DSC يكتشف أن الإخراج تتم إعادة توجيهه أو التقاطه كمتغير:

• إذا لم تتم إعادة توجيه الأمر أو التقاطه، يعرض DSC الإخراج كتنسيق yaml في وحدة التحكم.
• إذا تمت إعادة توجيه إخراج الأمر أو التقاطه، يصدر DSC البيانات كتنسيق json stdout.

عند إستخدام هذا الخيار، يستخدم DSC التنسيق المحدد بغض النظر عما إذا كان الأمر تتم إعادة توجيهه أو التقاطه.

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

Type        : string
Mandatory   : false
ValidValues : [json, pretty-json, yaml]
LongSyntax  : --output-format <OUTPUT_FORMAT>
ShortSyntax : -o <OUTPUT_FORMAT>

-h، - مساعدة

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

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

المخرجات

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

لمزيد من المعلومات حول تنسيق بيانات الإخراج، راجع الخيار --output-format.