Set-SCScriptCommandSetting
تكوين إعداد أمر البرنامج النصي.
بناء الجملة
Set-SCScriptCommandSetting
[-ScriptCommandSetting] <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>] الوصف
يقوم Set-SCScriptCommandSetting cmdlet بتكوين إعداد أمر البرنامج النصي.
أمثلة
مثال 1: تحديث دليل العمل المقترن بأمر البرنامج النصي
PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptCommand = Get-SCScriptCommand -ApplicationProfile $AppProfile | where {$_.Name -eq "PreInstall"}
PS C:\> $ScriptCmdSetting = Get-SCScriptCommandSetting -ScriptCommand $ScriptCommand
PS C:\> Set-SCScriptCommandSetting -ScriptCommandSetting $ScriptCmdSetting -WorkingDirectory "Working_Folder_03"
PS C:\> Set-SCScriptCommand -ScriptCommand $ScriptCommand -ScriptCommandSetting $ScriptCmdSettingيحصل الأمر الأول على كائن ملف تعريف التطبيق المسمى SvcWebAppProfile01 ويخزن الكائن في متغير $AppProfile.
يحصل الأمر الثاني على أمر البرنامج النصي المسمى PreInstall لملف تعريف التطبيق المخزن في $AppProfile، ثم يخزن الكائن في متغير $ScriptCommand.
يحصل الأمر الثالث على كائن إعداد أمر البرنامج النصي لأمر البرنامج النصي المخزن في $ScriptCommand ويخزن الكائن في متغير $ScriptCmdSetting.
يقوم الأمر الرابع بتعيين إعداد دليل العمل إلى Working_Folder_03.
يحدث الأمر الأخير أمر البرنامج النصي المخزن في $ScriptCommand مع الإعدادات المخزنة في $ScriptCmdSetting.
المعلمات
-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 |
-ScriptCommandSetting
تحديد كائن إعداد أمر البرنامج النصي.
| النوع: | SCScriptCommandSetting |
| Position: | 0 |
| القيمة الافتراضية: | None |
| مطلوب: | True |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | True |
| قبول أحرف البدل: | False |
-WarnAndContinueOnMatch
يشير إلى أن الإجراء المتخذ عند مطابقة نهج الفشل هو تحذير المستخدم ومتابعة العملية.
| النوع: | SwitchParameter |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | False |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
| قبول أحرف البدل: | False |
-WorkingDirectory
تحديد دليل عمل لأمر برنامج نصي.
| النوع: | String |
| Position: | Named |
| القيمة الافتراضية: | None |
| مطلوب: | False |
| قبول إدخال البنية الأساسية لبرنامج ربط العمليات التجارية: | False |
| قبول أحرف البدل: | False |
المخرجات
ScriptCommandSetting
يقوم cmdlet هذا بإرجاع كائن ScriptCommandSetting.