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

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

Примечание

Эти параметры также добавляются в командлеты поставщика и в функции, снабженные CmdletBinding атрибутом.

Общие общие параметры

Следующие параметры добавляются во все командлеты и доступны при каждом запуске командлета. Эти параметры определяются классом System. Management. Automation. internal. общиепараметры .

Подтверждение (псевдоним: CF)

Тип данных: переключатель

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

Отладка (псевдоним: DB)

Тип данных: переключатель

Этот параметр указывает, могут ли сообщения отладки на уровне программиста отображаться в командной строке. Эти сообщения предназначены для устранения неполадок в работе командлета и создаются вызовами метода System. Management. Automation. командлета. вритедебуг . Сообщения отладки не обязательно должны быть локализованы.

ErrorAction (псевдоним: EA)

Тип данных: перечисление

Этот параметр указывает, какое действие должно выполняться при возникновении ошибки. Возможные значения для этого параметра определяются перечислением System. Management. Automation. действие .

ErrorVariable (псевдоним: EV)

Тип данных: строковый

Этот параметр задает переменную, в которой должны размещаться объекты при возникновении ошибки. Чтобы добавить к этой переменной, используйте +имя_переменной вместо очистки и задания переменной.

Буфер (псевдоним: OB)

Тип данных: Int32

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

Переменная (Alias: OV)

Тип данных: строковый

Этот параметр задает переменную, в которой должны размещаться все выходные объекты, созданные командлетом. Чтобы добавить к этой переменной, используйте +имя_переменной вместо очистки и задания переменной.

PipelineVariable (псевдоним: ПС)

Тип данных: строковый

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

Подробный (псевдоним: VB)

Тип данных: переключатель

Этот параметр указывает, записывает ли командлет пояснительные сообщения, которые могут отображаться в командной строке. Эти сообщения предназначены для предоставления пользователю дополнительной справки и создаются вызовами метода System. Management. Automation. командлет. вритевербосе .

WarningAction (псевдоним: WA)

Тип данных: перечисление

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

WarningVariable (псевдоним: WV)

Тип данных: строковый

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

Параметры Risk-Mitigation

Следующие параметры добавляются в командлеты, которые запрашивают подтверждение перед выполнением действия. Дополнительные сведения о запросах на подтверждение см. в разделе запрос подтверждения. Эти параметры определяются классом System. Management. Automation. internal. шаулдпроцесспараметерс .

WhatIf (псевдоним: Wi-in)

Тип данных: переключатель

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

Параметры транзакции

Следующий параметр добавляется в командлеты, которые поддерживают транзакции. Эти параметры определяются классом System. Management. Automation. internal. трансактионпараметерс . Поддержка транзакций появилась в PowerShell 3,0 и прекращена в PowerShell 6,0.

UseTransaction (псевдоним: усеткс)

Тип данных: переключатель

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

См. также:

System. Management. Automation. internal. Общиепараметры

System. Management. Automation. internal. Шаулдпроцесспараметерс

System. Management. Automation. internal. Трансактионпараметерс

Запись командлета Windows PowerShell

Пакет SDK для Windows PowerShell