النص

الخلاصة

تشغيل كتل البرنامج النصي PowerShell.

بناء الجملة

Script [String] #ResourceName
{
    GetScript = [string]
    SetScript = [string]
    TestScript = [string]
    [Credential = [PSCredential]]
    [DependsOn = [string[]]]
    [PsDscRunAsCredential = [PSCredential]]
}

الوصف

Script يمكنك المورد من كتابة التعليمات البرمجية PowerShell للحصول على مورد واختباره وتعيينه عندما لا يتوفر مورد DSC معين. يجب توفير التعليمات البرمجية لهذه الأساليب، والتعامل مع جميع التبعيات، والتأكد من أن التعليمات البرمجية الخاصة بك غير فعالة.

تلميح

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

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

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

المتطلبات

لا شيء

الخصائص

الخصائص الرئيسية

GetScript

حدد حظر البرنامج النصي PowerShell الذي يسترد الحالة الحالية للمورد. يتم تشغيل هذا البرنامج النصي عند استدعاء أسلوب Get لهذا المورد.

يجب أن يرجع هذا البرنامج النصي جدول تجزئة يحتوي على مفتاح واحد يسمى Result بقيمة سلسلة.

Type: System.String

SetScript

حدد حظر البرنامج النصي PowerShell الذي يقوم بتكوين المورد إلى الحالة المطلوبة. يتم تشغيل كتلة البرنامج النصي هذه عند استدعاء أسلوب Set لهذا المورد.

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

Type: System.String

TestScript

حدد حظر البرنامج النصي PowerShell الذي يتحقق من صحة ما إذا كان المورد في الحالة المطلوبة. يتم تشغيل كتلة البرنامج النصي هذه عند استدعاء أسلوب الاختبار لهذا المورد.

يجب أن ترجع $true كتلة البرنامج النصي هذه إذا كان المورد في الحالة المطلوبة وإذا $false لم يكن في الحالة المطلوبة.

Type: System.String

خصائص اختيارية

بيانات اعتماد

حدد بيانات اعتماد حساب لتشغيل scriptblocks ضمن إذا لزم الأمر.

Type: System.Management.Automation.PSCredential
Default Value: None

خصائص القراءة فقط

النتيجة

النتيجة من كتلة البرنامج النصي GetScript .

Type: System.String

أمثلة

• إنشاء ملف يحتوي على محتوى