Freigeben über

Set-SCScriptCommandSetting

Modul:
VirtualMachineManager Module

Konfiguriert eine Skriptbefehlseinstellung.

Syntax

Default (Standardwert) 

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

Mit dem Cmdlet Set-SCScriptCommandSetting wird eine Skriptbefehlseinstellung konfiguriert.

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 Variablen $AppProfile.

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

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

Mit dem vierten Befehl wird die Einstellung für das Arbeitsverzeichnis auf Working_Folder_03 gesetzt.

Mit dem letzten Befehl wird der in $ScriptCommand gespeicherte Skriptbefehl mit den in $ScriptCmdSetting gespeicherten Einstellungen aktualisiert.

Parameter

-AlwaysReboot

Gibt an, ob ein Computer oder virtueller Computer immer neu gestartet werden soll, nachdem die Ausführung des Skripts abgeschlossen ist.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-CommandMayReboot

Gibt an, dass der Skriptbefehl den Computer oder die virtuelle Maschine neu starten kann.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-FailOnMatch

Gibt an, dass die Aktion, die ausgeführt wird, wenn eine Fehlerrichtlinie abgeglichen wird, ein Fehler ist.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MatchExitCode

Gibt den Exitcode der Fehlerrichtlinie an.

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MatchRebootExitCode

Gibt den Exitcode für die Übereinstimmung mit der Neustartrichtlinie an.

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

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MatchStandardError

Gibt den Standardfehler der Fehlerrichtlinie an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-MatchStandardOutput

Gibt die Standardausgabe der Fehlerrichtlinie an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PersistStandardErrorPath

Gibt den Dateipfad an, in dem der Standardfehler gespeichert werden soll.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-PersistStandardOutputPath

Gibt den Dateipfad an, in dem die Standardausgabe gespeichert werden soll.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 ist, wenn er in Verbindung mit New-SCScriptCommandSetting oder Set-SCScriptCommandSetting verwendet wird.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-RestartScriptOnExitCodeReboot

Gibt an, ob das Skript nach dem Neustart des Computers oder virtuellen Computers neu gestartet wird, wenn ein Exitcode übereinstimmt.

Parametereigenschaften

Typ:Boolean
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ScriptCommandSetting

Gibt ein Objekt zum Festlegen eines Skriptbefehls an.

Parametereigenschaften

Typ:SCScriptCommandSetting
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:0
Obligatorisch.:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WarnAndContinueOnMatch

Gibt an, dass die Aktion, die ausgeführt wird, wenn eine Fehlerrichtlinie abgeglichen wird, darin besteht, den Benutzer zu warnen und den Vorgang fortzusetzen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-WorkingDirectory

Gibt ein Arbeitsverzeichnis für einen Skriptbefehl an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Ausgaben

ScriptCommandSetting

Dieses Cmdlet gibt ein ScriptCommandSetting-Objekt zurück.