Write-Warning
Zapisuje komunikat ostrzegawczy.
Składnia
Default (Domyślna)
Write-Warning
[-Message] <String>
[<CommonParameters>]
Opis
Polecenie cmdlet Write-Warning zapisuje komunikat ostrzegawczy na hoście programu PowerShell. Odpowiedź na ostrzeżenie zależy od wartości zmiennej $WarningPreference użytkownika oraz użycia wspólnego parametru WarningAction.
Przykłady
Przykład 1: Pisanie komunikatu ostrzegawczego
To polecenie wyświetla komunikat "OSTRZEŻENIE: jest to tylko ostrzeżenie testowe".
Write-Warning "This is only a test warning."
Przykład 2. Przekazywanie ciągu do Write-Warning
To polecenie pokazuje, że za pomocą operatora potoku (|) można wysłać ciąg do Write-Warning.
Ciąg można zapisać w zmiennej, jak pokazano w tym poleceniu, lub przekazać ciąg bezpośrednio do Write-Warning.
$w = "This is only a test warning."
$w | Write-Warning
Przykład 3. Ustawianie zmiennej $WarningPreference i zapisywanie ostrzeżenia
W tym przykładzie pokazano wpływ wartości zmiennej $WarningPreference na polecenie Write-Warning.
PS> $WarningPreference
Continue
PS> Write-Warning "This is only a test warning."
This is only a test warning.
PS> $WarningPreference = "SilentlyContinue"
PS> Write-Warning "This is only a test warning."
PS> $WarningPreference = "Stop"
PS> Write-Warning "This is only a test warning."
WARNING: This is only a test warning.
Write-Warning: The running command stopped because the preference variable "WarningPreference" or common parameter is set to Stop: This is only a test warning.
Pierwsze polecenie wyświetla wartość domyślną zmiennej $WarningPreference, która jest Continue. W związku z tym po zapisie ostrzeżenia zostanie wyświetlony komunikat ostrzegawczy i wykonanie będzie kontynuowane.
Po zmianie wartości zmiennej $WarningPreference efekt polecenia Write-Warning zmienia się ponownie. Wartość SilentlyContinue pomija ostrzeżenie. Wartość Stop wyświetla ostrzeżenie, a następnie zatrzymuje wykonywanie polecenia.
Aby uzyskać więcej informacji na temat zmiennej $WarningPreference, zobacz about_Preference_Variables.
Przykład 4. Ustawianie parametru WarningAction i zapisywanie ostrzeżenia
W tym przykładzie pokazano efekt WarningAction typowego parametru polecenia Write-Warning. Możesz użyć WarningAction parametru wspólnego z dowolnym poleceniem cmdlet, aby określić sposób, w jaki program PowerShell odpowiada na ostrzeżenia generowane przez dane polecenie.
WarningAction wspólny parametr zastępuje wartość $WarningPreference tylko dla tego konkretnego polecenia.
PS> Write-Warning "This is only a test warning." -WarningAction Inquire
WARNING: This is only a test warning.
Confirm
Continue with this operation?
[Y] Yes [A] Yes to All [H] Halt Command [S] Suspend [?] Help (default is "Y"):
To polecenie używa polecenia cmdlet Write-Warning do wyświetlenia ostrzeżenia.
WarningAction to wspólny parametr z wartością Inquire, który nakazuje systemowi zapytać użytkownika, gdy polecenie wyświetli ostrzeżenie.
Aby uzyskać więcej informacji na temat WarningAction typowego parametru, zobacz about_CommonParameters.
Parametry
-Message
Określa komunikat ostrzegawczy.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | Msg |
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 |
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 wejściowe
String
Możesz przesłać ciąg zawierający ostrzeżenie do tego cmdletu.
Dane wyjściowe
None
To polecenie cmdlet nie zwraca żadnych danych wyjściowych. Zapisuje tylko do strumienia ostrzeżeń.
Uwagi
Wartość domyślna zmiennej $WarningPreference to Continue, która wyświetla ostrzeżenie, a następnie kontynuuje wykonywanie polecenia. Aby określić prawidłowe wartości zmiennej preferencji, takiej jak $WarningPreference, ustaw ją na ciąg losowych znaków, taki jak "abc". Wynikowy komunikat o błędzie zawiera listę prawidłowych wartości.
