Set-SCScriptCommandSetting

Configures a script command setting.

Syntax

Set-SCScriptCommandSetting [-ScriptCommandSetting] <SCScriptCommandSetting> [-AlwaysReboot <Boolean>]
 [-CommandMayReboot] [-FailOnMatch] [-MatchExitCode <String>] [-MatchRebootExitCode <String>]
 [-MatchStandardError <String>] [-MatchStandardOutput <String>] [-PersistStandardErrorPath <String>]
 [-PersistStandardOutputPath <String>] [-RestartOnRetry <Boolean>] [-RestartScriptOnExitCodeReboot <Boolean>]
 [-WarnAndContinueOnMatch] [-WorkingDirectory <String>] [<CommonParameters>]

Description

The Set-SCScriptCommandSetting cmdlet configures a script command setting.

Examples

Example 1: Update the working directory associated with script command

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

The first command gets the application profile object named SvcWebAppProfile01 and stores the object in the $AppProfile variable.

The second command gets the script command named PreInstall for the application profile stored in $AppProfile, and then stores the object in the $ScriptCommand variable.

The third command gets the script command setting object for the script command stored in $ScriptCommand and stores the object in the $ScriptCmdSetting variable.

The fourth command sets the working directory setting to Working_Folder_03.

The last command updates the script command stored in $ScriptCommand with the settings stored in $ScriptCmdSetting.

Parameters

-AlwaysReboot

Indicates whether a computer or virtual machine should always restart after the script has finished running.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-CommandMayReboot

Indicates that the script command may reboot the computer or virtual machine.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-FailOnMatch

Indicates that the action taken when a failure policy is matched is to fail.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MatchExitCode

Specifies the failure policy exit code.

Example format: -MatchExitCode "[1-9][0-9]*"

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MatchRebootExitCode

Specifies the restart policy match exit code.

Example format: -MatchRebootExitCode "{1641}|{3010}|{3011}"

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MatchStandardError

Specifies the failure policy standard error.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-MatchStandardOutput

Specifies the failure policy standard output.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PersistStandardErrorPath

Specifies the file path to store the standard error.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-PersistStandardOutputPath

Specifies the file path to store the standard output.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RestartOnRetry

Indicates whether a script is restarted upon VMM job restart if the previous job failure was due to a script failure when used in conjunction with New-SCScriptCommandSetting or Set-SCScriptCommandSetting.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-RestartScriptOnExitCodeReboot

Indicates whether the script restarts after the computer or virtual machine is restarted when an exit code is matched.

Type:Boolean
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-ScriptCommandSetting

Specifies a script command setting object.

Type:SCScriptCommandSetting
Required:True
Position:0
Default value:None
Accept pipeline input:True (ByValue)
Accept wildcard characters:False
-WarnAndContinueOnMatch

Indicates that the action taken when a failure policy is matched is to warn the user and continue the operation.

Type:SwitchParameter
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
-WorkingDirectory

Specifies a working directory for a script command.

Type:String
Required:False
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Outputs

ScriptCommandSetting

This cmdlet returns a **ScriptCommandSetting** object.