Freigeben über

New-SCScriptCommandSetting

Modul:
VirtualMachineManager Module

Erstellt ein Einstellungsobjekt für einen Skriptbefehl.

Syntax

Default (Standardwert) 

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

Mit dem Cmdlet New-SCScriptCommandSetting wird ein Einstellungsobjekt für einen Skriptbefehl erstellt.

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

Mit dem zweiten Befehl wird das Skriptbefehlsobjekt mit dem Namen PostInstall für das in $AppProfile gespeicherte Anwendungsprofil abgerufen.

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

Mit dem letzten Befehl wird das Arbeitsverzeichnis für den in $ScriptCommand gespeicherten Skriptbefehl aktualisiert, um Working_Folder_02 zu werden (der Wert von $ScriptSetting).

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

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