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变量中。

第二个命令为存储在 $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

指示在 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 对象。