Write-Warning
Zapisuje komunikat ostrzegawczy.
Składnia
Default (domyślnie)
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ązkowe: | 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żna potokować ciąg zawierający ostrzeżenie do Write-Warning.
Dane wyjściowe
None
Write-Warning Zapisuje tylko do strumienia ostrzeżeń. Nie generuje żadnych innych danych wyjściowych.
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.