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>] Description
New-SCScriptCommandSetting Cmdlet 會建立腳本命令的 settings 物件。
範例
範例 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變數中。
第二個命令會針對儲存在 $AppProfile 中的應用程式配置檔，取得名為 PostInstall 的腳本命令物件。
第三個命令會建立新的腳本命令設定，將工作目錄設定為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
指出如果先前的作業失敗是因為與 New-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 物件。