Write-Warning

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Bir uyarı iletisi yazar.

Syntax

Write-Warning
     [-Message] <String>
     [<CommonParameters>]

Description

Cmdlet, Write-Warning PowerShell konağına bir uyarı iletisi yazar. Uyarıya verilen yanıt, kullanıcının $WarningPreference değişkeninin değerine ve WarningAction ortak parametresinin kullanımına bağlıdır.

Örnekler

Örnek 1: Uyarı iletisi yazma

Bu komut "UYARI: Bu yalnızca bir test uyarısıdır" iletisini görüntüler.

Write-Warning "This is only a test warning."

Örnek 2: Yazma Uyarısına bir dize geçirme

Bu komut, öğesine bir dize Write-Warninggöndermek için işlem hattı işlecini (|) kullanabileceğinizi gösterir. Bu komutta gösterildiği gibi dizeyi bir değişkene kaydedebilir veya dizeyi doğrudan öğesine yöneltebilirsiniz Write-Warning.

$w = "This is only a test warning."
$w | Write-Warning

Örnek 3: $WarningPreference değişkenini ayarlama ve uyarı yazma

Bu örnek, değişkenin değerinin $WarningPreference bir Write-Warning komut üzerindeki etkisini gösterir.

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.

İlk komut, değişkenin varsayılan değerini $WarningPreference (olan Continue) görüntüler. Sonuç olarak, bir uyarı yazdığınızda uyarı iletisi görüntülenir ve yürütme devam eder.

Değişkenin değerini $WarningPreference değiştirdiğinizde, komutun Write-Warning etkisi yeniden değişir. değeri SilentlyContinue uyarıyı gizler. değeri Stop uyarıyı görüntüler ve komutun yürütülmesini durdurur.

Değişken hakkında $WarningPreference daha fazla bilgi için bkz . about_Preference_Variables.

Örnek 4: WarningAction parametresini ayarlama ve bir uyarı yazma

Bu örnekte WarningAction ortak parametresinin bir Write-Warning komut üzerindeki etkisi gösterilmektedir. PowerShell'in bu komuttan kaynaklanan uyarılara nasıl yanıt verdiğini belirlemek için herhangi bir cmdlet ile WarningAction ortak parametresini kullanabilirsiniz. WarningAction ortak parametresi, yalnızca bu komut için değerini $WarningPreference geçersiz kılar.

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"):

Bu komut bir uyarı görüntülemek için cmdlet'ini kullanır Write-Warning . Inquire değerine sahip WarningAction ortak parametresi, komut bir uyarı görüntülendiğinde sistemi kullanıcıya sorması için yönlendirir.

WarningAction ortak parametresi hakkında daha fazla bilgi için bkz. about_CommonParameters.

Parametreler

-Message

Uyarı iletisini belirtir.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Girişler

String

Uyarıyı içeren bir dizeyi bu cmdlet'e aktarabilirsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez. Yalnızca uyarı akışına yazar.

Notlar

Değişkenin varsayılan değeri, uyarıyı $WarningPreference görüntüleyen ve komutu yürütmeye devam eden değeridir Continue. gibi $WarningPreferencebir tercih değişkeninin geçerli değerlerini belirlemek için bunu "abc" gibi rastgele karakterlerden oluşan bir dize olarak ayarlayın. Sonuçta elde edilen hata iletisi geçerli değerleri listeler.