Freigeben über

New-SCScriptCommandSetting

  • Referenz
Modul:
VirtualMachineManager

Erstellt ein Einstellungsobjekt für einen Skriptbefehl.

Syntax

New-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 New-SCScriptCommandSetting erstellt ein Einstellungsobjekt für einen Skriptbefehl.

Beispiele

Beispiel 1: Hinzufügen einer Arbeitsverzeichniseinstellung zu einem Skriptbefehl

PS C:\> $AppProfile = Get-SCApplicationProfile -Name "SvcWebAppProfile01"
PS C:\> $ScriptCommand = Get-SCScriptCommand -ApplicationProfile $AppProfile | where {$_.Name -eq "PostInstall"}
PS C:\> $ScriptSetting = New-SCScriptCommandSetting -WorkingDirectory "Working_Folder_02"
PS C:\> Set-SCScriptCommand -ScriptCommand $ScriptCommand -ScriptCommandSetting $ScriptSetting

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

Der zweite Befehl ruft das Skriptbefehlsobjekt namens PostInstall für das in $AppProfile gespeicherte Anwendungsprofil ab.

Der dritte Befehl erstellt eine neue Skriptbefehlseinstellung, die das Arbeitsverzeichnis auf Working_Folder_02 festlegt, und speichert das Objekt dann in der $ScriptSetting Variablen.

Der letzte Befehl aktualisiert das Arbeitsverzeichnis für den skriptbefehl, der in $ScriptCommand gespeichert ist, um Working_Folder_02 zu werden (der Wert von $ScriptSetting).

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

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