13. Командлеты

Редакционная заметка

Важный

Спецификация языка Windows PowerShell 3.0 была опубликована в декабре 2012 года и основана на Windows PowerShell 3.0. Эта спецификация не отражает текущее состояние PowerShell. Нет плана обновить эту документацию, чтобы отразить текущее состояние. Эта документация представлена здесь для получения исторической справки.

Документ спецификации доступен в формате Microsoft Word из Центра загрузки Microsoft: https://www.microsoft.com/download/details.aspx?id=36389. Этот документ Word был преобразован для представления здесь, на платформе Microsoft Learn. Во время преобразования некоторые редакционные изменения были внесены в соответствии с форматированием платформы Docs. Исправлены некоторые опечатки и незначительные ошибки.

Командлет — это однофункциональная команда, которая управляет объектами в PowerShell. Командлеты можно распознать по формату их имени: глагол и существительное, разделяемые дефисом (-), например Get-Help, Get-Processи Start-Service. Шаблон глагола — это глагол, который выражен с помощью подстановочных знаков, как в W*. шаблон существительного — это существительное, выраженное с помощью подстановочных знаков, как в событие.

Командлеты должны быть простыми и должны использоваться в сочетании с другими командлетами. Например, командлеты Get должны получать только данные, командлеты Set должны только устанавливать или изменять данные, командлеты Format должны форматировать только данные, а командлеты Out должны направлять только выходные данные в указанное назначение.

Для каждого командлета укажите файл справки, к которому можно получить доступ, введя следующее:

Get-Help *cmdlet-name* -Detailed

Подробное представление файла справки командлета должно содержать описание командлета, синтаксис команды, описания параметров и пример использования этого командлета.

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

Заметка

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

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

Универсальные параметры — это набор параметров командлета, которые можно использовать с любым командлетом. Они реализуются самой средой выполнения PowerShell, а не разработчиком командлетов, и они автоматически доступны для любого командлета или функции, использующего атрибут Parameter (§12.3.7) или атрибут CmdletBinding (§12.3.5).

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

Несколько распространенных параметров переопределяют системные значения по умолчанию или предпочтения, которые можно задать с помощью переменных предпочтения (§2.3.2.3). В отличие от переменных предпочтения, общие параметры влияют только на команды, в которых они используются.

Заметка

Примечание редактора: исходный документ содержит список общих параметров. Эта информация является неполной и устаревшей. Текущие сведения см. в about_CommonParameters.