Udostępnij przez

New-SCScriptCommandSetting

Moduł:
VirtualMachineManager Module

Tworzy obiekt ustawień dla polecenia skryptu.

Składnia

Default (Domyślna) 

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

Opis

Polecenie cmdlet New-SCScriptCommandSetting tworzy obiekt ustawień dla polecenia skryptu.

Przykłady

Przykład 1: Dodawanie ustawienia katalogu roboczego do polecenia skryptu

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

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

Drugie polecenie pobiera obiekt polecenia skryptu o nazwie PostInstall dla profilu aplikacji przechowywanego w $AppProfile.

Trzecie polecenie tworzy nowe ustawienie polecenia skryptu, które ustawia katalog roboczy na Working_Folder_02, a następnie zapisuje obiekt w zmiennej $ScriptSetting.

Ostatnie polecenie aktualizuje katalog roboczy dla polecenia skryptowego przechowywanego w $ScriptCommand, które ma być Working_Folder_02 (wartość $ScriptSetting).

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

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