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

Утвержденные команды для 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. Append, , AttachConcatenateInsert
Clear (cl) Удаляет все ресурсы из контейнера, но не удаляет контейнер. Например, Clear-Content командлет удаляет содержимое файла, но не удаляет файл. Flush, , EraseUnmarkReleaseUnset,Nullify
Close (cs) Изменяет состояние ресурса, чтобы сделать его недоступным, недоступным или неиспользуемым. Эта команда связана с Open.
Copy (cp) Копирует ресурс в другое имя или в другой контейнер. Например, командлет Copy-Item копирует элемент (например, файл) из одного расположения в хранилище данных в другое расположение. Duplicate, , CloneReplicateSync
Enter (et) Указывает действие, позволяющее пользователю перемещаться в ресурс. Например, командлет Enter-PSSession помещает пользователя в интерактивный сеанс. Эта команда связана с Exit. Push, Into
Exit (ex) Задает текущую среду или контекст для последнего используемого контекста. Например, командлет Exit-PSSession помещает пользователя в сеанс, который использовался для запуска интерактивного сеанса. Эта команда связана с Enter. Pop, Out
Find (fd) Ищет объект в контейнере, который является неизвестным, подразумеваемым, необязательным или указанным. Search
Format (f) Упорядочивает объекты в указанной форме или макете
Get (g) Указывает действие, которое извлекает ресурс. Эта команда связана с Set. Read, Open, CatTypeDirObtainDumpAcquireExamineFindSearch
Hide (h) Делает ресурс неизменяемым. Например, командлет, имя которого включает команду Hide, может скрыть службу от пользователя. Эта команда связана с Show. Block
Join (j) Объединяет ресурсы в один ресурс. Например, командлет Join-Path объединяет путь с одним из дочерних путей для создания одного пути. Эта команда связана с Split. Combine, , UniteConnectAssociate
Lock (lk) Защищает ресурс. Эта команда связана с Unlock. Restrict, Secure
Move (m) Перемещает ресурс из одного расположения в другое. Например, командлет Move-Item перемещает элемент из одного расположения в хранилище данных в другое расположение. Transfer, , NameMigrate
New (n) Создает ресурс. (Команда Set также может использоваться при создании ресурса, включающего данные, например командлет Set-Variable.) Create, Generate, , Build, MakeAllocate
Open (op) Изменяет состояние ресурса, чтобы сделать его доступным, доступным или доступным для использования. Эта команда связана с Close.
Optimize (om) Повышает эффективность ресурса.
Pop (pop) Удаляет элемент из верхней части стека. Например, командлет Pop-Location изменяет текущее расположение в расположение, которое было недавно отправлено в стек.
Push (pu) Добавляет элемент в верхнюю часть стека. Например, командлет Push-Location отправляет текущее расположение в стек.
Redo (re) Сбрасывает ресурс в состояние, которое было отменено.
Remove (r) Удаляет ресурс из контейнера. Например, командлет Remove-Variable удаляет переменную и его значение. Эта команда связана с Add. Clear, Cut, , Dispose, DiscardErase
Rename (rn) Изменяет имя ресурса. Например, командлет Rename-Item, который используется для доступа к сохраненным данным, изменяет имя элемента в хранилище данных. Change
Reset (rs) Задает ресурс обратно в исходное состояние.
Resize (rz) Изменяет размер ресурса.
Search (sr) Создает ссылку на ресурс в контейнере. Find, Locate
Select (sc) Находит ресурс в контейнере. Например, командлет Select-String находит текст в строках и файлах. Find, Locate
Set (s) Заменяет данные существующего ресурса или создает ресурс, содержащий некоторые данные. Например, командлет Set-Date изменяет системное время на локальном компьютере. (Для создания ресурса также можно использовать команду New.) Эта команда связана с Get. Write, Reset, , Assign, ConfigureUpdate
Show (sh) Делает ресурс видимым для пользователя. Эта команда связана с Hide. Display, Produce
Skip (sk) Обход одного или нескольких ресурсов или точек в последовательности. Bypass, Jump
Split (sl) Отделяет части ресурса. Например, командлет Split-Path возвращает различные части пути. Эта команда связана с Join. Separate
Step (st) Перемещается к следующей точке или ресурсу в последовательности.
Switch (sw) Указывает действие, альтернативное между двумя ресурсами, например изменение между двумя расположениями, обязанностями или состояниями.
Undo (un) Задает ресурс для предыдущего состояния.
Unlock (uk) Освобождает заблокированный ресурс. Эта команда связана с Lock. Release, , UnrestrictUnsecure
Watch (wc) Постоянно проверяет или отслеживает ресурс для изменения.

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

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

Глагол (псевдоним) Действие Синонимы, чтобы избежать
Connect (cc) Создает связь между источником и назначением. Эта команда связана с Disconnect. Join, , TelnetLogin
Disconnect (dc) Разрывает связь между источником и назначением. Эта команда связана с Connect. Break, Logoff
Read (rd) Получает сведения из источника. Эта команда связана с Write. Acquire, , PromptGet
Receive (rc) Принимает сведения, отправленные из источника. Эта команда связана с Send. Read, , AcceptPeek
Send (sd) Предоставляет сведения в место назначения. Эта команда связана с Receive. Put, , BroadcastMailFax
Write (wr) Добавляет сведения в целевой объект. Эта команда связана с Read. Put, Print

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

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

Имя команды (псевдоним) Действие Синонимы, чтобы избежать
Backup (ba) Сохраняет данные путем репликации. Save, , BurnReplicateSync
Checkpoint (ch) Создает моментальный снимок текущего состояния данных или его конфигурации. Diff
Compare (cr) Вычисляет данные из одного ресурса по данным из другого ресурса. Diff
Compress (cm) Сжимает данные ресурса. Пары с Expand. Compact
Convert (cv) Изменяет данные из одного представления в другое, если командлет поддерживает двунаправленное преобразование или когда командлет поддерживает преобразование между несколькими типами данных. Change, , ResizeResample
ConvertFrom (cf) Преобразует один основной тип входных данных (существительное командлета указывает входные данные) в один или несколько поддерживаемых типов выходных данных. Export, , OutputOut
ConvertTo (ct) Преобразуется из одного или нескольких типов входных данных в первичный тип выходных данных (существительное командлета указывает тип вывода). Import, , InputIn
Dismount (dm) Отсоединяет именованную сущность от расположения. Эта команда связана с Mount. Unmount, Unlink
Edit (ed) Изменяет существующие данные, добавляя или удаляя содержимое. Change, , UpdateModify
Expand (en) Восстанавливает данные ресурса, который был сжатым до исходного состояния. Эта команда связана с Compress. Explode, Uncompress
Export (ep) Инкапсулирует первичные входные данные в постоянное хранилище данных, например файл или в формат обмена. Эта команда связана с Import. Extract, Backup
Group (gp) Упорядочивает или связывает один или несколько ресурсов
Import (ip) Создает ресурс из данных, хранящихся в постоянном хранилище данных (например, в файле) или в формате обмена. Например, Import-Csv командлет импортирует данные из файла с разделиемыми запятыми (CSV) в объекты, которые могут использоваться другими командлетами. Эта команда связана с Export. BulkLoad, Load
Initialize (in) Подготавливает ресурс для использования и задает для него состояние по умолчанию. Erase, , InitRebuildRenewReinitialize,Setup
Limit (l) Применяет ограничения к ресурсу. Quota
Merge (mg) Создает один ресурс из нескольких ресурсов. Combine, Join
Mount (mt) Присоединяет именованную сущность к расположению. Эта команда связана с Dismount. Connect
Out (o) Отправляет данные из среды. Например, командлет Out-Printer отправляет данные на принтер.
Publish (pb) Делает ресурс доступным для других пользователей. Эта команда связана с Unpublish. Deploy, , ReleaseInstall
Restore (rr) Задает для ресурса предопределенное состояние, например состояние, заданное Checkpoint. Например, командлет Restore-Computer запускает восстановление системы на локальном компьютере. Repair, , ReturnUndoFix
Save (sv) Сохраняет данные, чтобы избежать потери.
Sync (sy) Гарантирует, что два или более ресурсов находятся в одном состоянии. Replicate, , CoerceMatch
Unpublish (ub) Делает ресурс недоступным другим пользователям. Эта команда связана с Publish. Uninstall, , RevertHide
Update (ud) Приносит ресурс up-to-date для поддержания состояния, точности, соответствия или соответствия требованиям. Например, Update-FormatData обновления командлета и добавляет файлы форматирования в текущую консоль PowerShell. Refresh, , RenewRecalculateRe-index

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

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

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

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

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

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

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

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

Глагол (псевдоним) Действие Синонимы, чтобы избежать
Block (bl) Ограничивает доступ к ресурсу. Эта команда связана с Unblock. Prevent, , LimitDeny
Grant (gr) Разрешает доступ к ресурсу. Эта команда связана с Revoke. Allow, Enable
Protect (pt) Защищает ресурс от атак или потери. Эта команда связана с Unprotect. Encrypt, , SafeguardSeal
Revoke (rk) Указывает действие, которое не разрешает доступ к ресурсу. Эта команда связана с Grant. Remove, Disable
Unblock (ul) Удаляет ограничения для ресурса. Эта команда связана с Block. Clear, Allow
Unprotect (up) Удаляет меры защиты из ресурса, добавленного для предотвращения атаки или потери. Эта команда связана с Protect. Decrypt, Unseal

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

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

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

См. также

  • Last updated on