Write-Warning

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

Командлет Write-Warning выводит предупреждающее сообщение в консоль PowerShell. Ответ на предупреждение зависит от значения переменной $WarningPreference пользователя и использования общего параметра WarningAction.

Эта команда отображает сообщение "ПРЕДУПРЕЖДЕНИЕ: это только тестовое предупреждение".

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

Эта команда показывает, что для отправки строки в |можно использовать оператор конвейера (Write-Warning). Строку можно сохранить в переменной, как показано в этой команде, или передать строку непосредственно в Write-Warning.

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

В этом примере показан эффект значения переменной $WarningPreference в команде 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.

Первая команда отображает значение по умолчанию переменной $WarningPreference, которая Continue. В результате при написании предупреждения отображается предупреждение и продолжается выполнение.

При изменении значения переменной $WarningPreference действие команды Write-Warning изменяется снова. Значение SilentlyContinue подавляет предупреждение. Значение Stop отображает предупреждение, а затем останавливает выполнение команды.

Дополнительные сведения об переменной $WarningPreference см. в about_Preference_Variables.

В этом примере показано влияние общего параметра WarningAction на команду Write-Warning. Вы можете использовать общий параметр WarningAction с любым командлетом, чтобы определить, как PowerShell реагирует на предупреждения, вызванные этой командой. Общий параметр WarningAction переопределяет значение $WarningPreference только для этой конкретной команды.

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

Эта команда использует командлет Write-Warning для отображения предупреждения. WarningAction общий параметр со значением Inquire побуждает систему опрашивать пользователя при отображении предупреждения.

Дополнительную информацию о параметре WarningAction см. в разделе about_CommonParameters.

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Можно направить строку, содержащую предупреждение, в этот командлет.

Этот командлет не возвращает выходные данные. Он записывает только в поток предупреждений.

Значение по умолчанию для переменной $WarningPreference равно Continue, которая отображает предупреждение, а затем продолжает выполнять команду. Чтобы определить допустимые значения переменной предпочтения, например $WarningPreference, задайте для нее строку случайных символов, например abc. Полученное сообщение об ошибке содержит допустимые значения.