Write-Warning
Bir uyarı iletisi yazar.
Sözdizimi
Write-Warning
[-Message] <String>
[<CommonParameters>]Description
Write-Warning cmdlet'i 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, Write-Warningbir dize gö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 Write-Warning'e yöneltebilirsiniz.
$w = "This is only a test warning."
$w | Write-WarningÖrnek 3: $WarningPreference değişkenini ayarlama ve uyarı yazma
Bu örnekte, $WarningPreference değişkeninin değerinin bir Write-Warning komutu ü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 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, Continueolan $WarningPreference değişkeninin varsayılan değerini görüntüler. Sonuç olarak, bir uyarı yazdığınızda uyarı iletisi görüntülenir ve yürütme devam eder.
$WarningPreference değişkeninin değerini değiştirdiğinizde, Write-Warning komutunun etkisi yeniden değişir.
SilentlyContinue değeri uyarıyı gizler.
Stop değeri uyarıyı görüntüler ve komutun yürütülmesini durdurur.
$WarningPreference değişkeni hakkında daha fazla bilgi için bkz. about_Preference_Variables.
Örnek 4: WarningAction parametresini ayarlama ve bir uyarı yazma
Bu örnekte WarningAction ortak parametresinin Write-Warning komutu üzerindeki etkisi gösterilmektedir.
WarningAction ortak parametresini herhangi bir cmdlet ile kullanarak PowerShell'in bu komuttan kaynaklanan uyarılara nasıl yanıt verdiğini belirleyebilirsiniz.
WarningAction ortak parametresi yalnızca belirli bir komut için $WarningPreference değerini 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, uyarı görüntülemek için Write-Warning cmdlet'ini kullanır.
WarningAction Inquire değerine sahip ortak parametre, komutun bir uyarı görüntülediği zaman kullanıcıya sorması için sistemi yönlendirir.
WarningAction ortak parametresi hakkında daha fazla bilgi için bkz. about_CommonParameters.
Parametreler
-Message
Uyarı iletisini belirtir.
| Tür: | String |
| Diğer adlar: | Msg |
| Position: | 0 |
| Default value: | None |
| Gerekli: | True |
| İşlem hattı girişini kabul et: | True |
| Joker karakterleri kabul et: | False |
Girişler
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
$WarningPreference değişkeninin varsayılan değeri, uyarıyı görüntüleyen ve komutu yürütmeye devam eden Continuedeğeridir.
$WarningPreferencegibi bir 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.
