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>]
Description
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變數中。
第二個命令會針對儲存在 $AppProfile 的應用程式配置檔取得名為 PreInstall 的腳本命令,然後將物件儲存在$ScriptCommand變數中。
第三個命令會取得儲存在 $ScriptCommand 之腳本命令的腳本命令設定物件,並將物件儲存在$ScriptCmdSetting變數中。
第四個命令會將工作目錄設定設為Working_Folder_03。
最後一個命令會使用儲存在 $ScriptCmdSetting 中的設定,更新儲存在 $ScriptCommand 中的腳本命令。
參數
-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
指出如果先前的作業失敗是因為與 New-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 物件。