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 コマンドレットは、スクリプト コマンド設定を構成します。
例
例 1: script コマンドに関連付けられている作業ディレクトリを更新する
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変数にオブジェクトを格納します。
2 番目のコマンドは、$AppProfileに格納されているアプリケーション プロファイルの PreInstall という名前のスクリプト コマンドを取得し、$ScriptCommand変数にオブジェクトを格納します。
3 番目のコマンドは、$ScriptCommandに格納されているスクリプト コマンドのスクリプト コマンド設定オブジェクトを取得し、$ScriptCmdSetting変数にオブジェクトを格納します。
4 番目のコマンドは、作業ディレクトリの設定をWorking_Folder_03に設定します。
最後のコマンドは、$ScriptCommandに格納されているスクリプト コマンドを、$ScriptCmdSettingに格納されている設定で更新します。
パラメーター
-AlwaysReboot
スクリプトの実行が完了した後、コンピューターまたは仮想マシンを常に再起動するかどうかを示します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandMayReboot
スクリプト コマンドがコンピューターまたは仮想マシンを再起動する可能性があることを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FailOnMatch
エラー ポリシーが一致したときに実行されるアクションが失敗することを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MatchExitCode
エラー ポリシー終了コードを指定します。
形式の例: -MatchExitCode "[1-9][0-9]*"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MatchRebootExitCode
再起動ポリシーの一致終了コードを指定します。
形式の例: -MatchRebootExitCode "{1641}|{3010}|{3011}"
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MatchStandardError
エラー ポリシー標準エラーを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MatchStandardOutput
障害ポリシーの標準出力を指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistStandardErrorPath
標準エラーを格納するファイル パスを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PersistStandardOutputPath
標準出力を格納するファイル パスを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RestartOnRetry
New-SCScriptCommandSetting または Set-SCScriptCommandSetting と組み合わせて使用した場合に、前のジョブの失敗がスクリプトエラーによるものである場合に、VMM ジョブの再起動時にスクリプトを再起動するかどうかを示します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RestartScriptOnExitCodeReboot
終了コードが一致したときに、コンピューターまたは仮想マシンの再起動後にスクリプトを再起動するかどうかを示します。
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ScriptCommandSetting
スクリプト コマンド設定オブジェクトを指定します。
Type: | SCScriptCommandSetting |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WarnAndContinueOnMatch
エラー ポリシーが一致したときに実行されるアクションが、ユーザーに警告して操作を続行することを示します。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkingDirectory
スクリプト コマンドの作業ディレクトリを指定します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
出力
ScriptCommandSetting
このコマンドレットは ScriptCommandSetting オブジェクトを 返します。