powershell verbose что это

Windows PowerShell: Создание командлетов в сценарии

Одна из классных новинок Windows PowerShell версии 2 — возможность создавать расширенные функции. Такие функции полностью создаются на языке сценариев, но обладают такими же возможностями, что и «настоящий» командлет, написанный на C# или Visual Basic и скомпилированный в Visual Studio. Поддержка этих расширенных функций (на ранних этапах разработки версии 2 их называли «сценарными командлетами») позволяет создавать более гибкие функции, которые в дальнейшем можно легко использовать вместе с настоящими командлетами.

Все дело в привязке

Реальное различие между простой функцией и полнофункциональным командлетом заключается в мощных возможностях командлета по привязке параметров. Поддерживаются позиционные, именованные, обязательные параметры, и даже можно выполнять базовую проверку правильности параметров — нужно только правильно описать параметр для оболочки. Вот пример:

Работайте со своими модулями

Как правило, модуль сценария полностью состоит из функций. А это значит, что при импорте модуля на самом деле ничего не происходит – функции в модуле сценария загружаются в оболочку и становятся доступными в ее пределах. Предположим, что у вас есть модуль сценария, который выглядит примерно так:

Здесь я объявил три параметра:

Есть еще больше атрибутов и посвященных им примеров — их описание вы найдете в справке, для чего надо выполнить команду help about_Functions_Advanced_Parameters.

Доступ к общим параметрам

Подтверждение действий

$pscmdlet — встроенная переменная, которую можно использовать в блоке PROCESS сценария для доступа к функциональности командлета, в том числе к методу ShouldProcess. Надо передать описание того, что вы собираетесь изменить, а оболочка сама позаботится об отображении подтверждения или сообщении «что, если».

Помогите! Помогите! Помогите!

Как вы помните, функции, даже самые сложные, могут содержать собственную встроенную справочную информацию в особым образом отформатированных комментариях, о чем я рассказывал в выпуске рубрики за март 2010 г.. Как правило, сначала я размещаю основанную на комментариях справку, затем идет инструкция CmdletBinding, потом — параметры, и лишь затем блоки сценария: BEGIN<>, PROCESS<> и END<>. Всегда полезно включать справку в код функций — никогда, ведь, не знаешь, кому она может оказаться полезной.

Если вы уже создавали функции для конвейера (их еще называют «функции с фильтрами»), то уже знаете все необходимое для создания «сценарных командлетов». В блоке PROCESS<> сценария размещается код, и он будет выполнен по разу для каждого объекта, поступившего по конвейеру в командлет. Все остальное в этих расширенных функциях похоже на содержимое более простых функций.

Разнообразие целевой аудитории

Команда Windows PowerShell справедливо гордится широтой аудитории, использующей Windows PowerShell, — от простого пользователя до матерого программиста. Расширенные функции — пример того, что пригодится только самым опытным.

Если вы только познакомились с оболочкой и каждый раз забываете выполнят команду Help, расширенные функции, скорее всего, не для вас. Вы можете успешно использовать оболочку, никогда не создавая ни одной расширенной функции. Но как только ваш опыт вырастет и вы начнете писать собственные повторно используемые компоненты, вот тогда расширенные функции окажутся как нельзя более кстати.

Запись в блоге здесь является отличным примером: Автор начинает с простой команды, выполняющей важную задачу — одну из тысяч выполняемых администраторами каждый день Далее автор постепенно расширяет функциональные возможности своей команды, превращая ее в функцию, затем — в фильтрующую функцию, и, наконец, — в расширенную функцию, демонстрируя, как оболочка PowerShell стимулирует рост потребностей и навыков.

Источник

about_CommonParameters

Краткое описание

Описывает параметры, которые можно использовать с любым командлетом.

Подробное описание

Общие параметры — это набор параметров командлета, которые можно использовать с любым командлетом. Они реализуются с помощью PowerShell, а не разработчика командлетов и автоматически доступны любому командлету.

Общие параметры можно использовать с любыми командлетами, но они могут не влиять на все командлеты. Например, если командлет не создает подробные выходные данные, использование Verbose параметра Common не оказывает никакого влияния.

Несколько общих параметров переопределяют системные значения по умолчанию или настройки, заданные с помощью переменных предпочтений PowerShell. В отличие от привилегированных переменных, общие параметры влияют только на те команды, в которых они используются.

Дополнительные сведения см. в разделе about_Preference_Variables.

В следующем списке отображаются общие параметры. Их псевдонимы перечислены в скобках.

Можно использовать имя или значение с параметром.

Помимо общих параметров, многие командлеты предлагают параметры устранения рисков. Командлеты, которые подразумевают риск для системы или для пользовательских данных, обычно предлагают эти параметры.

Параметры устранения рисков:

Общие описания параметров

-Debug

Отображает сведения на уровне программиста об операции, выполняемой командой. Этот параметр работает только в том случае, если команда создает сообщение отладки. Например, этот параметр работает, если команда содержит Write-Debug командлет.

-ErrorAction

Определяет реакцию командлета на неустранимую ошибку команды. Этот параметр работает только в том случае, если команда создает неустранимую ошибку, например из Write-Error командлета.

Параметр ErrorAction не влияет на завершающие ошибки (такие как отсутствующие данные, недопустимые параметры или недостаточные разрешения), препятствующие успешному выполнению команды.

-ErrorAction:Inquire Отображает сообщение об ошибке и запрашивает подтверждение перед продолжением выполнения. Это значение используется редко.

-ErrorAction:SilentlyContinue Подавляет сообщение об ошибке и возобновляет выполнение команды.

-ErrorAction:Stop Отображает сообщение об ошибке и останавливает выполнение команды.

-ErrorAction:Suspend доступно только для рабочих процессов, которые не поддерживаются в PowerShell 6 и более поздних версиях.

-ErrorVariable

По умолчанию новые сообщения об ошибках переписывают сообщения об ошибках, которые уже хранятся в переменной. Чтобы добавить сообщение об ошибке в содержимое переменной, введите знак плюс ( + ) перед именем переменной.

Пользовательская переменная ошибки содержит все ошибки, сформированные командой, включая ошибки вызовов вложенных функций или скриптов.

-InformationAction

-InformationAction:Stop Останавливает команду или скрипт при возникновении Write-Information команды.

-InformationAction:Ignore подавляет информационное сообщение и возобновляет выполнение команды. В отличие от SilentlyContinue, Ignore полностью забыл информационное сообщение. оно не добавляет информационное сообщение в информационный поток.

-InformationAction:Inquire отображает информационное сообщение, указанное в Write-Information команде, а затем спрашивает, нужно ли продолжить.

-InformationAction:Continue отображает информационное сообщение и продолжит выполнение.

-InformationAction:Suspend не поддерживается в PowerShell Core, так как он доступен только для рабочих процессов.

-InformationAction:SilentlyContinue не действует, так как информационное сообщение не отображается (по умолчанию), и сценарий продолжается без прерывания.

-InformationVariable

Информационная переменная содержит все информационные сообщения, созданные командой, включая информационные сообщения от вызовов вложенных функций или скриптов.

-OutBuffer

Определяет количество объектов, которые должны накапливаться в буфере перед отправкой объектов через конвейер. Если опустить этот параметр, то объекты будут отправляться по мере их создания.

-OutVariable

Сохраняет выходные объекты из команды в указанной переменной в дополнение к отправке выходных данных в конвейере.

Чтобы добавить выходные данные в переменную, вместо того, чтобы заменять выходные данные, которые могут быть уже сохранены, введите знак плюса ( + ) перед именем переменной.

-PipelineVariable

PipelineVariable сохраняет значение текущего конвейера как переменную для любой именованной команды в том виде, в каком она проходит через конвейер.

Допустимые значения — строки, такие же, как и для имен переменных.

Результаты первой Foreach-Object команды передаются во вторую Foreach-Object команду, которая фильтрует объекты, возвращаемые первой Foreach-Object командой. Результаты второй команды хранятся в переменной с именем right.

В третьей Foreach-Object команде результаты первых двух Foreach-Object команд, представленных переменными слева и справа, обрабатываются с помощью оператора умножения. Команда указывает, что необходимо умножить объекты, хранящиеся в левой и правой переменных, и указать, что результаты должны отображаться как «левый диапазон член * правый диапазон Member = продукт».

-Verbose

Отображает подробные сведения об операции, выполненной командой. Эти сведения похожи на сведения в трассировке или в журнале транзакций. Этот параметр работает, только если команда создает подробное сообщение. Например, этот параметр работает, если команда содержит Write-Verbose командлет.

-WarningAction

Определяет реакцию командлета на предупреждение от команды. Значение Continue является значением по умолчанию. Этот параметр работает, только если команда создает предупреждающее сообщение. Например, этот параметр работает, если команда содержит Write-Warning командлет.

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

-WarningAction:SilentlyContinue подавляет предупреждающее сообщение и возобновляет выполнение команды.

-WarningAction:Stop отображает предупреждающее сообщение и прекращает выполнение команды.

-WarningVariable

Хранит предупреждения о команде в указанной переменной.

Все созданные предупреждения сохраняются в переменной, даже если они не отображаются для пользователя.

Чтобы добавить предупреждения в содержимое переменной, вместо того, чтобы заменять все предупреждения, которые могут быть уже сохранены, введите знак плюс ( + ) перед именем переменной.

Переменная предупреждения содержит все предупреждения, созданные командой, включая предупреждения о вызовах вложенных функций или скриптов.

Описания параметров управления рисками

-WhatIf

Отображает сообщение, описывающее результат выполнения команды, а не выполнение команды.

Вместо удаления элемента в PowerShell перечислены выполняемые операции и элементы, которые были бы затронуты. Эта команда выдает следующий результат:

-Confirm

Выводит приглашение для подтверждения перед выполнением команды.

Например, следующая команда использует Confirm параметр с Remove-Item командой. Перед удалением элемента в PowerShell будут перечислены выполняемые операции и элементы, которые будут затронуты, и запрашивается утверждение.

ConfirmВозможны следующие варианты ответа.

В следующем примере параметры приостановки используются для временной остановки команды, в то время как пользователь проверяет справку для параметра команды. После получения необходимой информации пользователь вводит «Exit» для завершения вложенного запроса, а затем выбирает ответ «Да» (y) для Confirm запроса.

Источник

Что такое Windows PowerShell и с чем его едят? Часть 3: передача параметров в скрипты и функции, создание командлетов

Во второй части цикла рассматривались основы языка программирования PowerShell, а сейчас стоит разобраться с использованием написанного на нем кода для задач администрирования. Самый очевидный способ это сделать — запустить сценарий. Кроме него существует возможность создания собственных командлетов.

Оглавление:

Позиционные параметры

В функциях позиционные параметры используются аналогично:

Print-Args «Ноль» «Один»

Описанный выше способ позволяет передать в сценарий или функцию любое количество параметров, но при вызове необходимо соблюдать порядок их следования, а обращаться к ним можно только по индексу массива — это не всегда удобно.

Блок Param()

В сценариях и функциях намного удобнее использовать именованные параметры. В предыдущей статье мы рассказывали об одном способе их описания:

Корпорация Microsoft рекомендует использовать блок Param() — этот синтаксис более универсален и позволяет задавать не только аргументы функций, но и параметры сценариев:

В теле функции это выглядит так:

Если список аргументов функции невелик, блок Param() только загромоздит конструкцию, но во многих случаях он делает код более читаемым и является помимо прочего элементом хорошего стиля программирования.

Дополнительные атрибуты параметров

При описании аргументов функции или параметров скрипта можно задать их дополнительные атрибуты. Самый простой пример — принудительная установка типа:

Помимо приведения типов можно использовать атрибут [parameter()]:

С его помощью нетрудно сделать параметр обязательным. Обратите внимание на одновременное использование нескольких атрибутов — в этом случае они идут друг за другом:

Position позволяет указать порядок следования параметра (по умолчанию он соответствует порядку объявления):

У атрибута [Parameter()] есть и другие аргументы, полный список которых доступен на сайте Microsoft. Там же описаны прочие атрибуты, с помощью которых можно провести валидацию переданных значений, проверить их с использованием регулярных выражений и т.д. Перечислим некоторые:

[Alias()] устанавливает псевдоним для параметра:

Оператор приведения типов [string[]] означает, что значение параметра — строковый массив.

[AllowEmptyString()] разрешает пустую строку в качестве обязательного параметра:

[AllowEmptyCollection()] разрешает пустой массив в качестве обязательного параметра:

[ValidatePattern()] проверка с использованием регулярного выражения:

[ValidateLength()] проверяет длину строкового параметра:

Передача параметров через конвейер

В первой статье цикла мы рассказывали о возможности передачи данных в командлеты через конвейер (pipeline). В PowerShell командлеты и функции возвращают объекты или массивы объектов (результаты стейтментов), а также получают их на входе. Чтобы это увидеть, препарируем один из командлетов при помощи Get-Help:

ValueFromPipelineByPropertyName обычно используют при необходимости передать несколько параметров, чтобы не возникало путаницы, при этом аргумент можно применять одновременно с ValueFromPipeline:

Как видите, получать параметры через конвейер могут и скрипты, но все же практическое применение описанных выше атрибутов характерно скорее для расширенных функций, которые будут рассмотрены ниже.

Структура тела функции

В языке PowerShell функция может включать три необязательных блока заключенного в операторные скобки кода — Begin, Process и End. Выглядит она примерно так:

Атрибут [CmdletBinding()] и расширенные функции

Параметр -Force применяется для подавления запросов на проведение различных операций;

-WhatIf нужен для эмуляции запуска и отображения информации о последствиях выполнения функции (команды) без этого параметра. Обычно используется, если функция может выполнить деструктивные действия.

-Confirm требует подтверждения и также используется, если функция может выполнить деструктивные действия.

Low — функция незначительно воздействует на систему и не создает существенных рисков потери данных.

Medium — среднее воздействие с незначительным риском потери данных в результате деструктивных действий.

High — код создает высокий риск потери данных в результате деструктивных действий.

Модули сценариев и создание командлетов

Стандартный набор выглядит примерно так:

C:\Users\%UserName%\Documents\WindowsPowerShell\Modules
C:\Program Files\WindowsPowerShell\Modules
C:\Windows\System32\WindowsPowerShell\v1.0\Modules

В этой статье мы достаточно подробно разобрали передачу параметров в функции и скрипты. Следующая часть цикла будет посвящена объектно-ориентированному программированию.

Источник

about_Preference_Variables

Краткое описание

Переменные, которые настраивают поведение PowerShell.

Подробное описание

PowerShell включает набор переменных, которые позволяют настроить его поведение. Эти переменные предпочтений работают подобно параметрам в системах на основе графического пользовательского интерфейса.

Переменные предпочтений влияют на операционную среду PowerShell, и все команды выполняются в среде. Во многих случаях командлеты имеют параметры, которые можно использовать для переопределения поведения предпочтений для конкретной команды.

В следующей таблице перечислены переменные предпочтений и их значения по умолчанию.

PowerShell включает в себя следующие переменные среды, в которых хранятся пользовательские настройки. Дополнительные сведения об этих переменных среды см. в разделе about_Environment_Variables.

Изменения в привилегированной переменной вступают в силу только в скриптах и функциях, если эти скрипты или функции определены в той же области видимости, в которой использовалась предпочтение. Дополнительные сведения см. в разделе about_Scopes.

Работа с переменными предпочтений

В этом документе описываются все переменные предпочтений.

Заданные значения относятся к текущему сеансу PowerShell. Чтобы сделать переменные эффективными во всех сеансах PowerShell, добавьте их в профиль PowerShell. Дополнительные сведения см. в разделе about_Profiles.

Работа в удаленном режиме

Дополнительные сведения об удаленных командах см. в разделе about_Remote.

$ConfirmPreference

Определяет, будет ли PowerShell автоматически запрашивать подтверждение перед запуском командлета или функции.

$ConfirmPreference Переменная принимает одно из ConfirmImpact значения перечисления: » высокий«, » средний«, » низкий» или » нет«.

Подробное описание

PowerShell может автоматически запрашивать подтверждение перед выполнением действия. Например, если командлет или функция значительно затронет систему, чтобы удалить данные или использовать значительный объем системных ресурсов.

Оценка риска — это атрибут командлета или функции, известный как его ConfirmImpact. Пользователи не могут изменить этот параметр.

Примеры

$DebugPreference

Определяет реакцию PowerShell на отладку сообщений, созданных скриптом, командлетом или поставщиком, или с помощью Write-Debug команды в командной строке.

$DebugPreference Переменная принимает одно из ActionPreference значения перечисления: SilentlyContinue, Остановка, продолжение, запрос, пропуск, приостановка или Останов.

Для отображения или скрытия сообщений об отладке для определенной команды можно использовать параметр отладки Common командлета. См. сведения в разделе about_CommonParameters.

Допустимы следующие значения.

Примеры

$ErrorActionPreference

Определяет, как PowerShell реагирует на устранимую ошибку, которая не останавливает обработку командлетов. Например, в командной строке или в скрипте, командлете или поставщике, например в ошибках, создаваемых Write-Error командлетом.

$ErrorActionPreference Переменная принимает одно из ActionPreference значения перечисления: SilentlyContinue, Остановка, продолжение, запрос, пропуск, приостановка или Останов.

Допустимы следующие значения.

$ErrorActionPreference и параметр ErrorAction не влияет на то, как PowerShell реагирует на прерывание ошибок, которые останавливают обработку командлетов. Дополнительные сведения об общем параметре ErrorAction см. в разделе about_CommonParameters.

Примеры

$еррорвиев

Определяет формат вывода сообщений об ошибках в PowerShell.

$ErrorView Переменная принимает одно из ErrorView значений перечисления: нормалвиев, категоривиев или конЦисевиев.

Допустимы следующие значения.

КонЦисевиев был добавлен в PowerShell 7.

Нормалвиев: подробное представление, предназначенное для большинства пользователей. Состоит из описания ошибки и имени объекта, участвующего в ошибке.

Категоривиев: краткое структурированное представление, предназначенное для рабочих сред. Используется следующий формат:

Примеры

$форматенумератионлимит

Допустимые значения: целые числа ( Int32 )

Значение по умолчанию: 4

Примеры

В этом примере команда создает таблицу, в которой перечислены все службы, выполняющиеся на компьютере, в двух группах: одна для запуска служб, а другая для остановленных служб. Он использует Get-Service команду для получения всех служб, а затем отправляет результаты по конвейеру в Group-Object командлет, который группирует результаты по состоянию службы.

Используйте Format-Table с параметром Wrap для вывода списка служб.

$InformationPreference

$InformationPreference Переменная принимает одно из ActionPreference значения перечисления: SilentlyContinue, Остановка, продолжение, запрос, пропуск, приостановка или Останов.

Допустимы следующие значения.

$Событие log *

Переменные настройки **события log *** определяют, какие типы событий записываются в журнал событий PowerShell в Просмотр событий. По умолчанию регистрируются только события подсистемы и поставщика. Но вы можете использовать переменные настройки **событий Log *** для настройки журнала, например ведения журнала событий о командах.

Включенные события вступают в силу только для текущей консоли PowerShell. Чтобы применить конфигурацию ко всем консолям, сохраните параметры переменной в профиле PowerShell. Дополнительные сведения см. в разделе about_Profiles.

$максимумхисторикаунт

Определяет, сколько команд сохраняется в журнале команд для текущего сеанса.

Допустимые значения: 1-32768 ( Int32 )

По умолчанию: 4096

Чтобы определить количество команд, сохраненных в журнале команд, введите:

Чтобы просмотреть команды, сохраненные в журнале сеанса, используйте Get-History командлет. Дополнительные сведения см. в разделе about_History.

Разделитель полей вывода (OFS) определяет символ, разделяющий элементы массива, которые преобразуются в строку.

Допустимые значения: любая строка.

По умолчанию: пробел

Примеры

В этом примере показано, что пространство используется для разделения значений при преобразовании массива в строку. В этом случае массив целых чисел хранится в переменной, а переменная преобразуется в строку.

$OutputEncoding

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

Примеры

в этом примере показано, как сделать Windows findstr.exe командой работать в PowerShell на компьютере, который локализован для языка, использующего символы юникода, например китайский.

В этом примере используется команда findstr.exe для поиска двух китайских символов, которые содержатся в Test.txt файле. при выполнении этой findstr.exe команды в Windows командной строке (cmd.exe) findstr.exe находит символы в текстовом файле. Однако при выполнении той findstr.exe же команды в PowerShell символы не найдены, так как PowerShell отправляет их в findstr.exe в тексте ASCII, а не в тексте в Юникоде.

После изменения кодировки команда findstr.exe находит символы Юникода.

$прогресспреференце

$ProgressPreference Переменная принимает одно из ActionPreference значения перечисления: SilentlyContinue, Остановка, продолжение, запрос, пропуск, приостановка или Останов.

Допустимы следующие значения.

$псдефаултпараметервалуес

$PSDefaultParameterValues впервые появился в PowerShell 3,0.

Дополнительные сведения об этой переменной предпочтений см. в разделе about_Parameters_Default_Values.

$Привилегированной PSEmailServer

$PSModuleAutoloadingPreference

$PSModuleAutoloadingPreference Переменная принимает одно из PSModuleAutoLoadingPreference значения перечисления: None, модулекуалифиед или ALL.

Дополнительные сведения об автоматическом импорте модулей см. в разделе about_Modules.

$PSSessionApplicationName

Указывает имя приложения по умолчанию для удаленной команды, которая использует веб-службы для технологии управления (WS-Management). дополнительные сведения см. в разделе About служба удаленного управления Windows.

Имя приложения по умолчанию используется, если в удаленной команде не указан универсальный код ресурса (URI) соединения или имя приложения.

Служба WinRM использует имя приложения для выбора прослушивателя, который будет обслуживать запрос на подключение. Значение параметра должно соответствовать значению свойства URLPrefix прослушивателя на удаленном компьютере.

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

$PSSessionConfigurationName

Эта переменная предпочтений задается на локальном компьютере, но она указывает конфигурацию сеанса, расположенную на удаленном компьютере.

Значение по умолчанию http://schemas.microsoft.com/PowerShell/microsoft.PowerShell указывает на конфигурацию сеанса Microsoft. PowerShell на удаленном компьютере.

Если указано только имя конфигурации, в начале добавляется следующий URI схемы:

Можно переопределить значение по умолчанию и выбрать другую конфигурацию сеанса для конкретного сеанса с помощью параметра configurationName New-PSSession Enter-PSSession Invoke-Command командлетов, или.

Значение этой переменной можно изменить в любое время. В этом случае следует помнить, что выбранная конфигурация сеанса должна существовать на удаленном компьютере. В противном случае команда для создания сеанса, использующего конфигурацию сеанса, завершится ошибкой.

Эта переменная предпочтений не определяет, какие конфигурации локального сеанса используются, когда удаленные пользователи создают сеанс, который подключается к этому компьютеру. Однако можно использовать разрешения для конфигураций локального сеанса, чтобы определить, какие пользователи могут их использовать.

$PSSessionOption

Устанавливает значения по умолчанию для дополнительных параметров пользователя в удаленном сеансе. Эти настройки параметров переопределяют системные значения по умолчанию для параметров сеанса.

Описание этих параметров и дополнительные сведения см. в разделе New-PSSessionOption. Дополнительные сведения об удаленных командах и сеансах см. в разделе about_Remote и about_PSSessions.

$Transcript

$VerbosePreference

$VerbosePreference Переменная принимает одно из ActionPreference значения перечисления: SilentlyContinue, Остановка, продолжение, запрос, пропуск, приостановка или Останов.

Допустимы следующие значения.

Для отображения или скрытия подробных сообщений для определенной команды можно использовать параметр verbose Common. См. сведения в разделе about_CommonParameters.

Примеры

При использовании параметра verbose сообщение записывается.

$WarningPreference

$WarningPreference Переменная принимает одно из ActionPreference значения перечисления: SilentlyContinue, Остановка, продолжение, запрос, пропуск, приостановка или Останов.

Допустимы следующие значения.

Вы можете использовать общий параметр WarningAction командлета, чтобы определить реакцию PowerShell на предупреждения от определенной команды. См. сведения в разделе about_CommonParameters.

Примеры

В этом примере показано воздействие значения по умолчанию на Continue.

В этом примере параметр WarningAction используется для отмены при создании предупреждения.

В этом примере используется параметр WarningAction со значением SilentlyContinue. Команда продолжит выполняться, и сообщение не будет выводиться.

$вхатифпреференце

Определяет, включается ли параметр WhatIf автоматически для каждой команды, поддерживающей эту возможность. Если параметр WhatIf включен, командлет сообщает о ожидаемом результате команды, но не выполняет команду.

Допустимы следующие значения.

Примеры

Убедитесь, что файл существует.

Используйте параметр WhatIf для определения результата попытки удаления файла.

Убедитесь, что файл не был удален.

Попытка удаления файла. Появится сообщение о том, что произойдет при Remove-Item запуске, но файл не будет удален.

Используйте Get-ChildItem для проверки того, что файл не был удален.

Stop-Process поддерживает WhatIf. Процесс Winword не остановлен.

Источник