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.