Udostępnij za pośrednictwem

Write-Warning

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Zapisuje komunikat ostrzegawczy.

Składnia

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 WarningAction wspólnego parametru.

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 wspólnego parametru z dowolnym poleceniem cmdlet, aby określić sposób, w jaki program PowerShell reaguje na ostrzeżenia wynikające z tego polecenia. 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 typowym parametrem z wartością Inquire kieruje system, aby monitować 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.

Typ:String
Aliasy:Msg
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

Możesz potokować ciąg zawierający ostrzeżenie, aby 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 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.