Write-Warning
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: dizeyi Write-Warning 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 bir uyarı yazma
Bu örnekte, değişkenin değerinin $WarningPreference bir Write-Warning komut üzerindeki etkisi gösterilir.
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 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."İlk komut, değişkeninin 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şkeninin $WarningPreference değerini değiştirdiğinizde, komutun Write-Warning etkisi yeniden değişir. değeri SilentlyContinue uyarıyı bastırır. 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, belirli bir komut için yalnızca 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, sistemi komut bir uyarı görüntülediği zaman 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
uyarısını içeren bir dizeyi öğesine Write-Warningyöneltebilirsiniz.
Çıkışlar
None
Write-Warning yalnızca uyarı akışına yazar. Başka çıkış oluşturmaz.
Notlar
değişkeninin 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 dizeye ayarlayın. Sonuçta elde edilen hata iletisi geçerli değerleri listeler.