Поделиться через

Write-Warning

  • Ссылка
Модуль:
Microsoft.PowerShell.Utility

Записывает предупреждение.

Синтаксис

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

Описание

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

Примеры

Пример 1. Запись предупреждающего сообщения

PS C:\> Write-Warning "This is only a test warning."

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

Пример 2. Передача строки в Write-Warning

PS C:\> $w = "This is only a test warning."
PS C:\> $w | Write-Warning

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

Пример 3. Установка переменной $WarningPreference и запись предупреждения

PS C:\> $warningpreference
Continue PS C:\> Write-Warning "This is only a test warning."
This is only a test warning. PS C:\> $warningpreference = "SilentlyContinue"
PS C:\> Write-Warning "This is only a test warning."
PS C:\>
PS C:\> $warningpreference = "Stop"
PS C:\> 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."

В этом примере показан эффект значения переменной $WarningPreference в команде write-Warning.

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

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

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

Пример 4. Установка параметра WarningAction и запись предупреждения

PS C:\> 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"):

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

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

Дополнительные сведения о общем параметре WarningAction см. в about_CommonParameters.

Параметры

-Message

Указывает предупреждение.

Тип:String
Aliases:Msg
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

Входные данные

String

Можно передать строку, содержащую предупреждение, записи.

Выходные данные

None

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

Примечания

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