PowerShell
Wspólne parametry
Szukaj…
Uwagi
Wspólne parametry mogą być używane z dowolnym poleceniem cmdlet (co oznacza, że jak tylko oznaczysz swoją funkcję jako polecenie cmdlet [patrz CmdletBinding()
], otrzymasz wszystkie te parametry za darmo).
Oto lista wszystkich popularnych parametrów (alias znajduje się w nawiasie po odpowiednim parametrze):
-Debug (db)
-ErrorAction (ea)
-ErrorVariable (ev)
-InformationAction (ia) # introduced in v5
-InformationVariable (iv) # introduced in v5
-OutVariable (ov)
-OutBuffer (ob)
-PipelineVariable (pv)
-Verbose (vb)
-WarningAction (wa)
-WarningVariable (wv)
-WhatIf (wi)
-Confirm (cf)
Parametr ErrorAction
Możliwe wartości to Continue | Ignore | Inquire | SilentlyContinue | Stop | Suspend
Wartość tego parametru określa sposób, w jaki cmdlet będzie obsługiwał błędy nie kończące się (na przykład generowane z błędu zapisu; aby dowiedzieć się więcej na temat obsługi błędów, patrz [ temat jeszcze nie utworzony ]).
Wartość domyślna (jeśli ten parametr zostanie pominięty) to Continue
.
-ErrorAction Kontynuuj
Ta opcja wyświetli komunikat o błędzie i będzie kontynuować wykonywanie.
PS C:\> Write-Error "test" -ErrorAction Continue ; Write-Host "Second command"
-ErrorAction Ignoruj
Ta opcja nie wyświetli żadnego komunikatu o błędzie i będzie kontynuować wykonywanie. Również do zmiennej automatycznej $Error
nie zostaną dodane żadne błędy.
Ta opcja została wprowadzona w wersji 3.
PS C:\> Write-Error "test" -ErrorAction Ignore ; Write-Host "Second command"
-ErrorAction Zapytanie
Ta opcja spowoduje wyświetlenie komunikatu o błędzie i poprosi użytkownika o wybranie akcji do podjęcia.
PS C:\> Write-Error "test" -ErrorAction Inquire ; Write-Host "Second command"
-ErrorAction SilentlyContinue
Ta opcja nie wyświetli komunikatu o błędzie i będzie kontynuować wykonywanie. Wszystkie błędy zostaną dodane do zmiennej automatycznej $Error
.
PS C:\> Write-Error "test" -ErrorAction SilentlyContinue ; Write-Host "Second command"
-ErrorAction Stop
Ta opcja spowoduje wyświetlenie komunikatu o błędzie i nie będzie kontynuowana wykonywania.
PS C:\> Write-Error "test" -ErrorAction Stop ; Write-Host "Second command"
-ErrorAction Suspend
Dostępne tylko w przepływie pracy Powershell. W przypadku użycia, jeśli polecenie napotka błąd, przepływ pracy zostanie zawieszony. Pozwala to na badanie takiego błędu i daje możliwość wznowienia przepływu pracy. Aby dowiedzieć się więcej o systemie Workflow, zobacz [temat jeszcze nie stworzony].