Udostępnij przez

Set-SCScriptCommandSetting

Moduł:
VirtualMachineManager Module

Konfiguruje ustawienie polecenia skryptu.

Składnia

Default (Domyślna) 

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

Opis

Polecenie cmdlet Set-SCScriptCommandSetting konfiguruje ustawienie polecenia skryptu.

Przykłady

Przykład 1: Aktualizowanie katalogu roboczego skojarzonego z poleceniem skryptu

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

Pierwsze polecenie pobiera obiekt profilu aplikacji o nazwie SvcWebAppProfile01 i zapisuje go w zmiennej $AppProfile.

Drugie polecenie pobiera polecenie skryptu o nazwie PreInstall dla profilu aplikacji przechowywanego w $AppProfile, a następnie zapisuje obiekt w zmiennej $ScriptCommand.

Trzecie polecenie pobiera obiekt ustawienia polecenia skryptu dla polecenia skryptu przechowywanego w $ScriptCommand i zapisuje obiekt w zmiennej $ScriptCmdSetting.

Czwarte polecenie ustawia ustawienie katalogu roboczego na Working_Folder_03.

Ostatnie polecenie aktualizuje polecenie skryptu przechowywane w $ScriptCommand z ustawieniami przechowywanymi w $ScriptCmdSetting.

Parametry

-AlwaysReboot

Wskazuje, czy komputer lub maszyna wirtualna powinna zawsze zostać uruchomiona ponownie po zakończeniu działania skryptu.

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-CommandMayReboot

Wskazuje, że polecenie skryptu może spowodować ponowne uruchomienie komputera lub maszyny wirtualnej.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-FailOnMatch

Wskazuje, że akcja podjęta po dopasowaniu zasady niepowodzenia ma zakończyć się niepowodzeniem.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MatchExitCode

Określa kod zakończenia zasady awarii.

Przykładowy format: -MatchExitCode "[1-9][0-9]*"

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MatchRebootExitCode

Określa kod zakończenia dopasowania zasad ponownego uruchamiania.

Przykładowy format: -MatchRebootExitCode "{1641}|{3010}|{3011}"

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MatchStandardError

Określa standardowy błąd zasady błędów.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-MatchStandardOutput

Określa standardowe dane wyjściowe zasad awarii.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PersistStandardErrorPath

Określa ścieżkę do pliku, w którym ma być przechowywany błąd standardowy.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-PersistStandardOutputPath

Określa ścieżkę do pliku, w którym mają być przechowywane standardowe dane wyjściowe.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RestartOnRetry

Wskazuje, czy skrypt jest uruchamiany ponownie po ponownym uruchomieniu zadania programu VMM, jeśli poprzednie niepowodzenie zadania było spowodowane błędem skryptu, gdy jest używane w połączeniu z New-SCScriptCommandSetting lub Set-SCScriptCommandSetting.

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-RestartScriptOnExitCodeReboot

Wskazuje, czy skrypt jest uruchamiany ponownie po ponownym uruchomieniu komputera lub maszyny wirtualnej po dopasowaniu kodu zakończenia.

Właściwości parametru

Typ:Boolean
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-ScriptCommandSetting

Określa obiekt ustawień komendy skryptu.

Właściwości parametru

Typ:SCScriptCommandSetting
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:0
Obowiązkowy:True
Wartość z potoku:True
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WarnAndContinueOnMatch

Wskazuje, że akcja wykonywana po dopasowaniu zasad awarii polega na ostrzeżeniu użytkownika i kontynuowaniu operacji.

Właściwości parametru

Typ:SwitchParameter
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

-WorkingDirectory

Określa katalog roboczy dla polecenia skryptu.

Właściwości parametru

Typ:String
Domyślna wartość:None
Obsługuje symbole wieloznaczne:False
DontShow:False

Zestawy parametrów

(All)
Position:Named
Obowiązkowy:False
Wartość z potoku:False
Wartość z potoku według nazwy właściwości:False
Wartość z pozostałych argumentów:False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wyjściowe

ScriptCommandSetting

To polecenie cmdlet zwraca obiekt ScriptCommandSetting .