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 Windows PowerShell. Reakcja na ostrzeżenie zależy od wartości zmiennej $WarningPreference użytkownika i użycia wspólnego parametru WarningAction .
Przykłady
Przykład 1: Pisanie komunikatu ostrzegawczego
PS C:\> Write-Warning "This is only a test warning."
To polecenie wyświetla komunikat "OSTRZEŻENIE: jest to tylko ostrzeżenie testowe".
Przykład 2. Przekazywanie ciągu do Write-Warning
PS C:\> $w = "This is only a test warning."
PS C:\> $w | Write-Warning
To polecenie pokazuje, że można użyć operatora potoku (|), aby wysłać ciąg do Write-Warning. Możesz zapisać ciąg w zmiennej, jak pokazano w tym poleceniu, lub potokować ciąg bezpośrednio do Write-Warning.
Przykład 3. Ustawianie zmiennej $WarningPreference i zapisywanie ostrzeżenia
PS C:\> $warningpreference
Continue PS C:\> Write-Warning "This is only a test warning."
This is only a test warning. PS C:\> $warningpreference = "SilentlyContinue"
PS C:\> Write-Warning "This is only a test warning."
PS C:\>
PS C:\> $warningpreference = "Stop"
PS C:\> Write-Warning "This is only a test warning."
WARNING: This is only a test message.
Write-Warning : Command execution stopped because the shell variable "WarningPreference" is set to Stop.
At line:1 char:14
+ Write-Warning <<<< "This is only a test message."
W tym przykładzie pokazano wpływ wartości zmiennej $WarningPreference na polecenie Write-Warning .
Pierwsze polecenie wyświetla wartość domyślną zmiennej $WarningPreference, czyli 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 ponownie się zmieni. Wartość SilentlyContinue pomija ostrzeżenie. Wartość Stop powoduje wyświetlenie ostrzeżenia, a następnie zatrzymanie wykonywania polecenia.
Aby uzyskać więcej informacji na temat zmiennej $WarningPreference, zobacz about_Preference_Variables.
Przykład 4. Ustawianie parametru WarningAction i zapisywanie ostrzeżenia
PS C:\> 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"):
W tym przykładzie pokazano wpływ typowego parametru WarningAction na polecenie Write-Warning . Parametru Common WarningAction można użyć z dowolnym poleceniem cmdlet, aby określić, jak program Windows PowerShell reaguje na ostrzeżenia wynikające z tego polecenia. Typowy parametr WarningAction zastępuje wartość $WarningPreference tylko dla tego konkretnego polecenia.
To polecenie używa polecenia cmdlet Write-Warning w celu 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 wspólnego parametru WarningAction , 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
Ciąg zawierający ostrzeżenie można potokować do Write-Warning.
Dane wyjściowe
None
Write-Warning zapisuje tylko w strumieniu ostrzegawczym. Nie generuje żadnych innych danych wyjściowych.
Uwagi
Wartość domyślna zmiennej $WarningPreference to Continue, która powoduje wyświetlenie ostrzeżenia, a następnie kontynuowanie wykonywania 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 wyświetli listę prawidłowych wartości.