Udostępnij za pośrednictwem

New-SCScriptCommandSetting

  • Odwołanie
Moduł:
VirtualMachineManager

Tworzy obiekt ustawień dla polecenia skryptu.

Składnia

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 przechowuje obiekt 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 polecenia skryptu przechowywanego w $ScriptCommand jako Working_Folder_02 (wartość $ScriptSetting).

Parametry

-AlwaysReboot

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

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-CommandMayReboot

Wskazuje, że polecenie skryptu może ponownie uruchomić komputer lub maszynę wirtualną.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-FailOnMatch

Wskazuje, że akcja wykonywana po dopasowaniu zasad niepowodzenia kończy się niepowodzeniem.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MatchExitCode

Określa kod zakończenia zasad niepowodzenia.

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MatchRebootExitCode

Określa kod zakończenia zasad ponownego uruchamiania.

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

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MatchStandardError

Określa błąd standardowy zasad awarii.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-MatchStandardOutput

Określa standardowe dane wyjściowe zasad błędów.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PersistStandardErrorPath

Określa ścieżkę pliku do przechowywania standardowego błędu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-PersistStandardOutputPath

Określa ścieżkę pliku do przechowywania standardowych danych wyjściowych.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestartOnRetry

Wskazuje, czy skrypt jest ponownie uruchamiany po ponownym uruchomieniu zadania programu VMM, jeśli poprzedni błąd zadania był spowodowany niepowodzeniem skryptu w połączeniu z New-SCScriptCommandSetting lub Set-SCScriptCommandSetting.

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-RestartScriptOnExitCodeReboot

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

Typ:Boolean
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WarnAndContinueOnMatch

Wskazuje, że akcja podjęta po dopasowaniu zasad niepowodzenia polega na ostrzeżeniu użytkownika i kontynuowaniu operacji.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-WorkingDirectory

Określa katalog roboczy dla polecenia skryptu.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

ScriptCommandSetting

To polecenie cmdlet zwraca obiekt ScriptCommandSetting.