Командлеты используют стандартные параметры

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

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

Примечание

При использовании параметров перед их именами всегда стоит «-», что позволяет оболочке Windows PowerShell легко идентифицировать их как параметры. В примере Get-Command -Name Clear-Host именем параметра является Name, но оно вводится как -Name.

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

Параметр справки (?)

При указании параметра -? в каком-либо командлете командлет не исполняется. Вместо этого Windows PowerShell отображает справку для командлета.

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

Оболочка Windows PowerShell содержит несколько параметров, называемых общими параметрами. Так как эти параметры контролируются механизмом Windows PowerShell, при каждом их использовании командлетом их поведение будет всегда одинаковым. Общими параметрами являются параметры WhatIf, Confirm, Verbose, Debug, Warn, ErrorAction, ErrorVariable, OutVariable и OutBuffer.

Рекомендуемые к использованию параметры

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

Например, рекомендуется именовать параметры, обращающиеся к компьютеру по имени как ComputerName, а не как Server (сервер), Host (узел), System (система), Nod (узел) или другие общие альтернативные слова. Важными рекомендуемыми именами параметров являются Force, Exclude, Include, PassThru, Path и CaseSensitive.

Сводные сведения о командах

Командлет Windows PowerShell Get-Command извлекает имена всех имеющихся команд. При вводе команды Get-Command в командную строку Windows PowerShell отображаются данные, подобные следующим:

PS> Get-Command CommandType Name                       Definition ----------- ----                       ---------- Cmdlet     Add-Content                Add-Content [-Path] <String[... Cmdlet     Add-History                Add-History [[-InputObject]... Cmdlet     Add-Member                 Add-Member [-MemberType] <PS... ...

 

Этот вывод выглядит очень похоже на вывод справки интерфейса Cmd.exe: сводка внутренних команд в табличной форме. В показанном выше фрагменте для вывода команды Get-Command каждая команда имеет значение параметра CommandType, равное Cmdlet (командлет). Командлет является типом внутренней команды оболочки Windows PowerShell, грубо соответствующим командам dir и cd интерфейса Cmd.exe и командам, встраиваемым в оболочки ОС UNIX, например BASH.

В выводе команды Get-Command все определения заканчиваются троеточием (...), указывающим на то, что PowerShell не может отобразить все содержание в доступном пространстве. Когда оболочка Windows PowerShell отображает конечные данные, она форматирует вывод как текст и затем выстраивает его таким образом, чтобы данные точно умещались в окне консоли. Это будет рассмотрено позднее в разделе, посвященном механизмам форматирования.

Командлет Get-Command имеет параметр Syntax, позволяющий извлекать только синтаксис каждого командлета. Для отображения полного вывода введите команду Get-Command -Syntax:

PS> Get-Command -Syntax Add-Content [-Path] <String[]> [-Value] <Object[]> [-PassThru] [-Filter <String>] [-Include <String[]>] [-Exclude <String[]>] [-Force] [Credential <PSCredential>] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-ErrorVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>] [-WhatIf] [-Confirm] [-Encoding <FileSystemCmdletProviderEncoding>]   Add-History [[-InputObject] <PSObject[]>] [-Passthru] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-ErrorVariable <String>] [-OutVariable <String>][-OutBuffer <Int32>]...