New-SCScriptCommandSetting
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 $ScriptSettingDer erste Befehl ruft das Anwendungsprofilobjekt namens 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 dann das Objekt in der $ScriptSetting Variablen speichert.
Der letzte Befehl aktualisiert das Arbeitsverzeichnis für den in $ScriptCommand gespeicherten Skriptbefehl, der Working_Folder_02 (der Wert von $ScriptSetting).
Parameter
-AlwaysReboot
Gibt an, ob ein Computer oder ein virtueller Computer nach Abschluss des Skripts immer neu gestartet werden soll.
| 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 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 Fehlerrichtlinien-Exitcode 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 Neustartrichtlinien-Exitcode 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, um die Standardausgabe zu speichern.
| 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 aufgrund eines Skriptfehlers aufgrund eines Skriptfehlers in Verbindung mit New-SCScriptCommandSetting oder Set-SCScriptCommandSetting war.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RestartScriptOnExitCodeReboot
Gibt an, ob das Skript nach dem Neustart des Computers oder des virtuellen Computers neu gestartet wird, wenn ein Exitcode übereinstimmt.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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.
| 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.