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 オブジェクトを 返します。