مشاركة عبر


New-SCScriptCommandSetting

إنشاء كائن إعدادات لأمر برنامج نصي.

بناء الجملة

New-SCScriptCommandSetting
   [-AlwaysReboot <Boolean>]
   [-FailOnMatch]
   [-WarnAndContinueOnMatch]
   [-MatchExitCode <String>]
   [-MatchStandardError <String>]
   [-MatchStandardOutput <String>]
   [-PersistStandardErrorPath <String>]
   [-PersistStandardOutputPath <String>]
   [-MatchRebootExitCode <String>]
   [-RestartScriptOnExitCodeReboot <Boolean>]
   [-WorkingDirectory <String>]
   [-CommandMayReboot]
   [-RestartOnRetry <Boolean>]
   [<CommonParameters>]

الوصف

ينشئ New-SCScriptCommandSetting cmdlet كائن إعدادات لأمر برنامج نصي.

أمثلة

مثال 1: إضافة إعداد دليل عمل إلى أمر برنامج نصي

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptCommand = Get-SCScriptCommand -ApplicationProfile $AppProfile | where {$_.Name -eq "PostInstall"}
PS C:\> $ScriptSetting = New-SCScriptCommandSetting -WorkingDirectory "Working_Folder_02"
PS C:\> Set-SCScriptCommand -ScriptCommand $ScriptCommand -ScriptCommandSetting $ScriptSetting

يحصل الأمر الأول على كائن ملف تعريف التطبيق المسمى SvcWebAppProfile01 ويخزن الكائن في متغير $AppProfile.

يحصل الأمر الثاني على كائن أمر البرنامج النصي المسمى PostInstall لملف تعريف التطبيق المخزن في $AppProfile.

يقوم الأمر الثالث بإنشاء إعداد أمر برنامج نصي جديد يعين دليل العمل إلى Working_Folder_02، ثم يخزن الكائن في متغير $ScriptSetting.

يقوم الأمر الأخير بتحديث دليل العمل لأمر البرنامج النصي المخزن في $ScriptCommand ليتم Working_Folder_02 (قيمة $ScriptSetting).

المعلمات

-AlwaysReboot

يشير إلى ما إذا كان يجب إعادة تشغيل الكمبيوتر أو الجهاز الظاهري دائما بعد انتهاء تشغيل البرنامج النصي.

النوع:Boolean
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-CommandMayReboot

يشير إلى أن أمر البرنامج النصي قد يعيد تشغيل الكمبيوتر أو الجهاز الظاهري.

النوع:SwitchParameter
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-FailOnMatch

يشير إلى أن الإجراء الذي يتم اتخاذه عند مطابقة نهج الفشل هو الفشل.

النوع:SwitchParameter
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-MatchExitCode

تحديد رمز إنهاء نهج الفشل.

مثال على التنسيق: -MatchExitCode "[1-9][0-9]*"

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-MatchRebootExitCode

يحدد رمز الخروج لمطابقة نهج إعادة التشغيل.

مثال على التنسيق: -MatchRebootExitCode "{1641}|{3010}|{3011}"

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-MatchStandardError

تحديد الخطأ القياسي لنهج الفشل.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-MatchStandardOutput

تحديد الإخراج القياسي لنهج الفشل.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-PersistStandardErrorPath

تحديد مسار الملف لتخزين الخطأ القياسي.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-PersistStandardOutputPath

تحديد مسار الملف لتخزين الإخراج القياسي.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-RestartOnRetry

يشير إلى ما إذا كان يتم إعادة تشغيل برنامج نصي عند إعادة تشغيل مهمة VMM إذا كان فشل المهمة السابق بسبب فشل البرنامج النصي عند استخدامه بالاقتران مع New-SCScriptCommandSetting أو Set-SCScriptCommandSetting.

النوع:Boolean
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-RestartScriptOnExitCodeReboot

يشير إلى ما إذا كان البرنامج النصي يعيد التشغيل بعد إعادة تشغيل الكمبيوتر أو الجهاز الظاهري عند مطابقة رمز الخروج.

النوع:Boolean
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-WarnAndContinueOnMatch

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

النوع:SwitchParameter
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

-WorkingDirectory

تحديد دليل عمل لأمر برنامج نصي.

النوع:String
Position:Named
القيمة الافتراضية:None
مطلوب:False
قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية:False
قبول أحرف البدل:False

المخرجات

ScriptCommandSetting

يقوم cmdlet هذا بإرجاع كائن ScriptCommandSetting.