Freigeben über

Set-SCScriptCommandSetting

  • Referenz
Modul:
VirtualMachineManager

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 mit dem Namen 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 in $ScriptCmdSetting gespeicherten Einstellungen.

Parameter

-AlwaysReboot

Gibt an, ob ein Computer oder ein virtueller Computer nach Abschluss der Ausführung des Skripts immer neu gestartet werden soll.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CommandMayReboot

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FailOnMatch

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MatchExitCode

Gibt den Fehlerrichtlinienausgangscode an.

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MatchRebootExitCode

Gibt den Ausgangscode für die Neustartrichtlinie an.

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

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MatchStandardError

Gibt den Standardfehler der Fehlerrichtlinie an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MatchStandardOutput

Gibt die Standardausgabe der Fehlerrichtlinie an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PersistStandardErrorPath

Gibt den Dateipfad an, um den Standardfehler zu speichern.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PersistStandardOutputPath

Gibt den Dateipfad zum Speichern der Standardausgabe an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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-SCScriptCommandSettingverwendet wurde.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RestartScriptOnExitCodeReboot

Gibt an, ob das Skript neu gestartet wird, nachdem der Computer oder der virtuelle Computer neu gestartet wurde, wenn ein Beendigungscode übereinstimmt.

Typ:Boolean
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ScriptCommandSetting

Gibt ein Skriptbefehlseinstellungsobjekt an.

Typ:SCScriptCommandSetting
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WarnAndContinueOnMatch

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

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WorkingDirectory

Gibt ein Arbeitsverzeichnis für einen Skriptbefehl an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

ScriptCommandSetting

Dieses Cmdlet gibt ein ScriptCommandSetting--Objekt zurück.