Write-Warning
Bir uyarı iletisi yazar.
Sözdizimi
Default EnterprisePublishing
Write-Warning
[-Message] <String>
[<CommonParameters>]
Description
Write-Warning cmdlet'i PowerShell barındırıcısı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'ya geçirin
Bu komut, bir dizeyi |'e göndermek için işlem hattı işlecini (Write-Warning) 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, $WarningPreferenceolan Continue 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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Msg |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
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
$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.
