Freigeben über


Set-SCScriptCommandSetting

Konfiguriert eine Skriptbefehlseinstellung.

Syntax

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>]

Beschreibung

Das Cmdlet Set-SCScriptCommandSetting konfiguriert eine Skriptbefehlseinstellung.

Beispiele

Beispiel 1: Aktualisieren des Arbeitsverzeichnisses, das dem Skriptbefehl zugeordnet ist

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

Der erste Befehl ruft das Anwendungsprofilobjekt namens SvcWebAppProfile01 ab und speichert das Objekt in der $AppProfile Variablen.

Der zweite Befehl ruft den Skriptbefehl "PreInstall" für das in $AppProfile gespeicherte Anwendungsprofil ab und speichert das Objekt dann in der $ScriptCommand Variablen.

Der dritte Befehl ruft das Skriptbefehlseinstellungsobjekt für den in $ScriptCommand gespeicherten Skriptbefehl ab und speichert das Objekt in der $ScriptCmdSetting Variablen.

Der vierte Befehl legt die Arbeitsverzeichniseinstellung auf Working_Folder_03 fest.

Der letzte Befehl aktualisiert den in $ScriptCommand gespeicherten Skriptbefehl mit den einstellungen, die in $ScriptCmdSetting gespeichert sind.

Parameter

-AlwaysReboot

Gibt an, ob ein Computer oder ein virtueller Computer immer neu gestartet werden soll, nachdem das Skript ausgeführt wurde.

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

-CommandMayReboot

Gibt an, dass der Skriptbefehl den Computer oder den virtuellen Computer möglicherweise neu starten kann.

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

-FailOnMatch

Gibt an, dass die Aktion, die ausgeführt wird, wenn eine Fehlerrichtlinie übereinstimmt, fehlschlägt.

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

-MatchExitCode

Gibt den Fehlerrichtlinienausgangscode an.

Beispielformat: -MatchExitCode "[1-9][0-9]*"

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

-MatchRebootExitCode

Gibt den Neustartrichtlinienabgleichscode an.

Beispielformat: -MatchRebootExitCode "{1641}|{3010}|{3011}"

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

-MatchStandardError

Gibt den Standardfehler der Fehlerrichtlinie an.

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

-MatchStandardOutput

Gibt die Standardausgabe der Fehlerrichtlinie an.

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

-PersistStandardErrorPath

Gibt den Dateipfad an, um den Standardfehler zu speichern.

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

-PersistStandardOutputPath

Gibt den Dateipfad an, der die Standardausgabe speichert.

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

-RestartOnRetry

Gibt an, ob ein Skript beim Neustart des VMM-Auftrags neu gestartet wird, wenn der vorherige Auftragsfehler auf einen Skriptfehler zurückzuführen war, wenn es in Verbindung mit New-SCScriptCommandSetting oder Set-SCScriptCommandSetting verwendet wurde.

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

-RestartScriptOnExitCodeReboot

Gibt an, ob das Skript neu gestartet wird, nachdem der Computer oder der virtuelle Computer neu gestartet wurde, wenn ein Exitcode abgeglichen wird.

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

-ScriptCommandSetting

Gibt ein Skriptbefehlseinstellungsobjekt an.

Type:SCScriptCommandSetting
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WarnAndContinueOnMatch

Gibt an, dass die Aktion, die ausgeführt wird, wenn eine Fehlerrichtlinie übereinstimmt, den Benutzer warnen und den Vorgang fortsetzen soll.

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

-WorkingDirectory

Gibt ein Arbeitsverzeichnis für einen Skriptbefehl an.

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

Ausgaben

ScriptCommandSetting

Dieses Cmdlet gibt ein ScriptCommandSetting -Objekt zurück.