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

Утвержденные команды для PowerShell

PowerShell использует пару глаголов-существительных для имен командлетов и производных классов .NET. Часть команды имени определяет действие, которое выполняет командлет. Существительное часть имени определяет сущность, в которой выполняется действие. Например, командлет Get-Command извлекает все команды, зарегистрированные в PowerShell.

Примечание.

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

Каждая утвержденная команда имеет соответствующий префикс псевдонима. Этот префикс псевдонима используется в псевдонимах для команд, использующих эту команду. Например, префикс псевдонима для Importip и, соответственно, псевдоним для Import-Moduleipmo. Это рекомендация, но не правило; В частности, не требуется уважать псевдонимы команд, имитирующие известные команды из других сред.

Рекомендации по именованию команд

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

  • Используйте одно из предопределенных имен команд, предоставляемых PowerShell
  • Используйте команду, чтобы описать общую область действия и использовать параметры для дальнейшего уточнения действия командлета.
  • Не используйте синоним утвержденной команды. Например, всегда используйте Remove, никогда не используйте Delete или Eliminate.
  • Используйте только форму каждой команды, указанной в этом разделе. Например, используйте, но не используйте GetGetting илиGets.
  • Не используйте следующие зарезервированные команды или псевдонимы. Язык PowerShell и редкие несколько командлетов используют эти команды в исключительных обстоятельствах.
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

Вы можете получить полный список команд с помощью командлета Get-Verb.

Аналогичные команды для различных действий

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

New и Add

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

New и Set

Используйте команду New для создания нового ресурса. Set Используйте команду для изменения существующего ресурса, при необходимости создав его, если он не существует, например Set-Variable командлет.

Используйте команду Find для поиска объекта. Используйте команду Search для создания ссылки на ресурс в контейнере.

Get и Read

Используйте команду Get для получения сведений о ресурсе (например, файле) или для получения объекта, с помощью которого можно получить доступ к ресурсу в будущем. Используйте команду Read, чтобы открыть ресурс и извлечь информацию, содержащуюся в ней.

Invoke и Start

Используйте команду Invoke для выполнения синхронных операций, таких как выполнение команды и ожидание завершения. Используйте команду Start для запуска асинхронных операций, таких как запуск автономного процесса.

Ping и Test

Используйте команду Test.

Общие команды

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

Глагол (псевдоним) Действие Синонимы, чтобы избежать
Add (a) Добавляет ресурс в контейнер или присоединяет элемент к другому элементу. Например, командлет Add-Content добавляет содержимое в файл. Эта команда связана с Remove. Добавление, присоединение, объединение, вставка
Clear (cl) Удаляет все ресурсы из контейнера, но не удаляет контейнер. Например, Clear-Content командлет удаляет содержимое файла, но не удаляет файл. Сброс, Стереть, Отпустить, Снять пометку, Отменить, Аннулировать
Close (cs) Изменяет состояние ресурса, чтобы сделать его недоступным, недоступным или неиспользуемым. Эта команда связана с Open.
Copy (cp) Копирует ресурс в другое имя или в другой контейнер. Например, командлет Copy-Item копирует элемент (например, файл) из одного расположения в хранилище данных в другое расположение. Дубликаты, клонирование, репликация, синхронизация
Enter (et) Указывает действие, позволяющее пользователю перемещаться в ресурс. Например, командлет Enter-PSSession помещает пользователя в интерактивный сеанс. Эта команда связана с Exit. Push, в
Exit (ex) Задает текущую среду или контекст для последнего используемого контекста. Например, командлет Exit-PSSession помещает пользователя в сеанс, который использовался для запуска интерактивного сеанса. Эта команда связана с Enter. Всплывающее, выход
Find (fd) Ищет объект в контейнере, который является неизвестным, подразумеваемым, необязательным или указанным. Искать
Format (f) Упорядочивает объекты в указанной форме или макете
Get (g) Указывает действие, которое извлекает ресурс. Эта команда связана с Set. Read, Open, Cat, Type, Dir, Get, Dump, Get, Get, Examine, Find, Search
Hide (h) Делает ресурс неизменяемым. Например, командлет, имя которого включает команду Hide, может скрыть службу от пользователя. Эта команда связана с Show. Блокировка
Join (j) Объединяет ресурсы в один ресурс. Например, командлет Join-Path объединяет путь с одним из дочерних путей для создания одного пути. Эта команда связана с Split. Объединение, объединение, подключение, связывание
Lock (lk) Защищает ресурс. Эта команда связана с Unlock. Ограничение, безопасность
Move (m) Перемещает ресурс из одного расположения в другое. Например, командлет Move-Item перемещает элемент из одного расположения в хранилище данных в другое расположение. Передача, имя, миграция
New (n) Создает ресурс. (Команда Set также может использоваться при создании ресурса, включающего данные, например командлет Set-Variable.) Создание, создание, сборка, создание, выделение
Open (op) Изменяет состояние ресурса, чтобы сделать его доступным, доступным или доступным для использования. Эта команда связана с Close.
Optimize (om) Повышает эффективность ресурса.
Pop (pop) Удаляет элемент из верхней части стека. Например, командлет Pop-Location изменяет текущее расположение в расположение, которое было недавно отправлено в стек.
Push (pu) Добавляет элемент в верхнюю часть стека. Например, командлет Push-Location отправляет текущее расположение в стек.
Redo (re) Сбрасывает ресурс в состояние, которое было отменено.
Remove (r) Удаляет ресурс из контейнера. Например, командлет Remove-Variable удаляет переменную и его значение. Эта команда связана с Add. Очистить, вырезать, удалить, удалить, удалить
Rename (rn) Изменяет имя ресурса. Например, командлет Rename-Item, который используется для доступа к сохраненным данным, изменяет имя элемента в хранилище данных. Изменение
Reset (rs) Задает ресурс обратно в исходное состояние.
Resize(rz) Изменяет размер ресурса.
Search (sr) Создает ссылку на ресурс в контейнере. Поиск, поиск
Select (sc) Находит ресурс в контейнере. Например, командлет Select-String находит текст в строках и файлах. Поиск, поиск
Set (s) Заменяет данные существующего ресурса или создает ресурс, содержащий некоторые данные. Например, командлет Set-Date изменяет системное время на локальном компьютере. (Для создания ресурса также можно использовать команду New.) Эта команда связана с Get. Запись, сброс, назначение, настройка, обновление
Show (sh) Делает ресурс видимым для пользователя. Эта команда связана с Hide. Отображение, создание
Skip (sk) Обход одного или нескольких ресурсов или точек в последовательности. Обход, переход
Split (sl) Отделяет части ресурса. Например, командлет Split-Path возвращает различные части пути. Эта команда связана с Join. Отделять
Step (st) Перемещается к следующей точке или ресурсу в последовательности.
Switch (sw) Указывает действие, альтернативное между двумя ресурсами, например изменение между двумя расположениями, обязанностями или состояниями.
Undo (un) Задает ресурс для предыдущего состояния.
Unlock (uk) Освобождает заблокированный ресурс. Эта команда связана с Lock. Выпуск, Unsecrict, Небезопасный
Watch (wc) Постоянно проверяет или отслеживает ресурс для изменения.

Команды связи

PowerShell использует класс System.Management.Automation.VerbsCommunications для определения действий, применяемых к обмену данными. В следующей таблице перечислены большинство определенных команд.

Глагол (псевдоним) Действие Синонимы, чтобы избежать
Connect (cc) Создает связь между источником и назначением. Эта команда связана с Disconnect. Присоединение, Telnet, Login
Disconnect (dc) Разрывает связь между источником и назначением. Эта команда связана с Connect. Разрыв, выход
Read (rd) Получает сведения из источника. Эта команда связана с Write. Получение, запрос, получение
Receive (rc) Принимает сведения, отправленные из источника. Эта команда связана с Send. Чтение, принятие, просмотр
Send (sd) Предоставляет сведения в место назначения. Эта команда связана с Receive. Put, Broadcast, Mail, Факс
Write (wr) Добавляет сведения в целевой объект. Эта команда связана с Read. Поставить, Распечатать

Команды данных

PowerShell использует класс System.Management.Automation.VerbsData для определения действий, применяемых к обработке данных. В следующей таблице перечислены большинство определенных команд.

Имя команды (псевдоним) Действие Синонимы, чтобы избежать
Backup (ba) Сохраняет данные путем репликации. Сохранение, запись, репликация, синхронизация
Checkpoint (ch) Создает моментальный снимок текущего состояния данных или его конфигурации. Дифф
Compare (cr) Вычисляет данные из одного ресурса по данным из другого ресурса. Дифф
Compress (cm) Сжимает данные ресурса. Пары с Expand. Компактный
Convert (cv) Изменяет данные из одного представления в другое, если командлет поддерживает двунаправленное преобразование или когда командлет поддерживает преобразование между несколькими типами данных. Изменение, изменение размера, resample
ConvertFrom (cf) Преобразует один основной тип входных данных (существительное командлета указывает входные данные) в один или несколько поддерживаемых типов выходных данных. Экспорт, вывод, выход
ConvertTo (ct) Преобразуется из одного или нескольких типов входных данных в первичный тип выходных данных (существительное командлета указывает тип вывода). Импорт, ввод, в
Dismount (dm) Отсоединяет именованную сущность от расположения. Эта команда связана с Mount. Отключение, отмена связи
Edit (ed) Изменяет существующие данные, добавляя или удаляя содержимое. Изменение, обновление, изменение
Expand (en) Восстанавливает данные ресурса, который был сжатым до исходного состояния. Эта команда связана с Compress. Взрыв, распаковка
Export (ep) Инкапсулирует первичные входные данные в постоянное хранилище данных, например файл или в формат обмена. Эта команда связана с Import. Извлечение, резервное копирование
Group (gp) Упорядочивает или связывает один или несколько ресурсов
Import (ip) Создает ресурс из данных, хранящихся в постоянном хранилище данных (например, в файле) или в формате обмена. Например, Import-Csv командлет импортирует данные из файла с разделиемыми запятыми (CSV) в объекты, которые могут использоваться другими командлетами. Эта команда связана с Export. BulkLoad, Load
Initialize (in) Подготавливает ресурс для использования и задает для него состояние по умолчанию. Удаление, инициализация, продление, перестроение, повторная инициализация, настройка
Limit (l) Применяет ограничения к ресурсу. Квота
Merge (mg) Создает один ресурс из нескольких ресурсов. Объединение, присоединение
Mount (mt) Присоединяет именованную сущность к расположению. Эта команда связана с Dismount. Подключиться
Out (o) Отправляет данные из среды. Например, командлет Out-Printer отправляет данные на принтер.
Publish (pb) Делает ресурс доступным для других пользователей. Эта команда связана с Unpublish. Развертывание, выпуск, установка
Restore (rr) Задает для ресурса предопределенное состояние, например состояние, заданное Checkpoint. Например, командлет Restore-Computer запускает восстановление системы на локальном компьютере. Восстановление, возврат, отмена, исправление
Save (sv) Сохраняет данные, чтобы избежать потери.
Sync (sy) Гарантирует, что два или более ресурсов находятся в одном состоянии. Репликация, Coerce, Match
Unpublish (ub) Делает ресурс недоступным другим пользователям. Эта команда связана с Publish. Удаление, восстановление, скрытие
Update (ud) Приносит ресурс up-to-date для поддержания состояния, точности, соответствия или соответствия требованиям. Например, Update-FormatData обновления командлета и добавляет файлы форматирования в текущую консоль PowerShell. Обновление, продление, пересчет, повторное индексирование

Диагностические команды

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

Глагол (псевдоним) Действие Синонимы, чтобы избежать
Debug (db) Проверяет ресурс для диагностики операционных проблем. Диагностировать
Measure (ms) Определяет ресурсы, потребляемые указанной операцией, или извлекает статистику о ресурсе. Вычисление, определение, анализ
Ping (pi) Не рекомендуется. Вместо этого используйте команду test.
Repair (rp) Восстановление ресурса в допустимом состоянии Исправление, восстановление
Resolve (rv) Сопоставляет сокращенное представление ресурса с более полным представлением. Развернуть, определить
Test (t) Проверяет операцию или согласованность ресурса. Диагностика, анализ, спасение, проверка
Trace (tr) Отслеживает действия ресурса. Отслеживать, следовать, проверять, копать

Команды жизненного цикла

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

Глагол (псевдоним) Действие Синонимы, чтобы избежать
Approve (ap) Подтверждает или соглашается с состоянием ресурса или процесса.
Assert (as) Подтверждает состояние ресурса. Удостоверять
Build (bd) Создает артефакт (обычно двоичный или документ) из некоторого набора входных файлов (обычно исходный код или декларативные документы).) Эта команда была добавлена в PowerShell 6.
Complete (cp) Завершает операцию.
Confirm (cn) Подтверждает, проверяет или проверяет состояние ресурса или процесса. Подтверждение, согласие, сертификация, проверка, проверка
Deny (dn) Отказывается, объекты, блоки или выступает против состояния ресурса или процесса. Блокировать, объект, отказаться, отклонить
Deploy (dp) Отправляет приложение, веб-сайт или решение в удаленный целевой объект таким образом, чтобы потребитель этого решения смог получить доступ к нему после завершения развертывания. Эта команда была добавлена в PowerShell 6.
Disable (d) Настраивает ресурс для недоступного или неактивного состояния. Например, командлет Disable-PSBreakpoint делает точку останова неактивной. Эта команда связана с Enable. Остановка, скрытие
Enable (e) Настраивает ресурс в доступное или активное состояние. Например, командлет Enable-PSBreakpoint делает точку останова активной. Эта команда связана с Disable. Начало, начало
Install (is) Помещает ресурс в расположение и при необходимости инициализирует его. Эта команда связана с Uninstall. Настройка
Invoke (i) Выполняет действие, например выполнение команды или метода. Запуск, запуск, запуск
Register (rg) Создает запись для ресурса в репозитории, например базы данных. Эта команда связана с Unregister.
Request (rq) Запрашивает ресурс или запрашивает разрешения.
Restart (rt) Останавливает операцию, а затем снова запускает ее. Например, командлет Restart-Service останавливается, а затем запускает службу. Рециркулировать
Resume (ru) Запускает операцию, которая была приостановлена. Например, командлет Resume-Service запускает службу, которая была приостановлена. Эта команда связана с Suspend.
Start (sa) Инициирует операцию. Например, командлет Start-Service запускает службу. Эта команда связана с Stop. Запуск, инициирование, загрузка
Stop (sp) Отменяет действие. Эта команда связана с Start. End, Kill, End,
Submit (sb) Представляет ресурс для утверждения. Пост
Suspend (ss) Приостанавливает действие. Например, командлет Suspend-Service приостанавливает службу. Эта команда связана с Resume. Пауза
Uninstall (us) Удаляет ресурс из указанного расположения. Эта команда связана с Install.
Unregister (ur) Удаляет запись для ресурса из репозитория. Эта команда связана с Register. Удалить
Wait (w) Приостанавливает операцию до тех пор, пока не будет выполнено указанное событие. Например, командлет Wait-Job приостанавливает операции до завершения одного или нескольких фоновых заданий. Спящий режим, пауза

Команды безопасности

PowerShell использует класс System.Management.Automation.VerbsSecurity для определения действий, применяемых к безопасности. В следующей таблице перечислены большинство определенных команд.

Глагол (псевдоним) Действие Синонимы, чтобы избежать
Block (bl) Ограничивает доступ к ресурсу. Эта команда связана с Unblock. Предотвращение, ограничение, запрет
Grant (gr) Разрешает доступ к ресурсу. Эта команда связана с Revoke. Разрешить, включить
Protect (pt) Защищает ресурс от атак или потери. Эта команда связана с Unprotect. Шифрование, защита, печать
Revoke (rk) Указывает действие, которое не разрешает доступ к ресурсу. Эта команда связана с Grant. Удаление, отключение
Unblock (ul) Удаляет ограничения для ресурса. Эта команда связана с Block. Очистить, разрешить
Unprotect (up) Удаляет меры защиты из ресурса, добавленного для предотвращения атаки или потери. Эта команда связана с Protect. Расшифровка, unseal

Другие команды

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

Глагол (псевдоним) Действие Синонимы, чтобы избежать
Use (u) Использует или включает ресурс для выполнения действий.

См. также