Get-Command

Get-Command
    [[-ArgumentList] <Object[]>]
    [-Verb <String[]>]
    [-Noun <String[]>]
    [-Module <String[]>]
    [-FullyQualifiedModule <ModuleSpecification[]>]
    [-TotalCount <Int32>]
    [-Syntax]
    [-ShowCommandInfo]
    [-All]
    [-ListImported]
    [-ParameterName <String[]>]
    [-ParameterType <PSTypeName[]>]
    [<CommonParameters>]

Get-Command
    [[-Name] <String[]>]
    [[-ArgumentList] <Object[]>]
    [-Module <String[]>]
    [-FullyQualifiedModule <ModuleSpecification[]>]
    [-CommandType <CommandTypes>]
    [-TotalCount <Int32>]
    [-Syntax]
    [-ShowCommandInfo]
    [-All]
    [-ListImported]
    [-ParameterName <String[]>]
    [-ParameterType <PSTypeName[]>]
    [-UseFuzzyMatching]
    [-FuzzyMinimumDistance <UInt32>]
    [-UseAbbreviationExpansion]
    [<CommonParameters>]

Командлет Get-Command получает все команды, установленные на компьютере, включая командлеты, псевдонимы, функции, фильтры, скрипты и приложения. Get-Command получает команды из модулей и команд PowerShell, импортированных из других сеансов. Чтобы получить только команды, импортированные в текущий сеанс, используйте параметр ListImported.

Без параметров Get-Command получает все командлеты, функции и псевдонимы, установленные на компьютере. Get-Command * получает все типы команд, включая все файлы, отличные от PowerShell, в переменной среды PATH ($Env:PATH), которые он перечисляет в типе команды Application.

Get-Command, которая использует точное имя команды без подстановочных знаков, автоматически импортирует модуль, содержащий команду, чтобы сразу же использовать команду. Чтобы включить, отключить и настроить автоматический импорт модулей, используйте переменную предпочтения $PSModuleAutoLoadingPreference. Дополнительные сведения см. в разделе about_Preference_Variables.

Get-Command получает данные непосредственно из кода команды, в отличие от Get-Help, которая получает информацию из разделов справки.

Начиная с Windows PowerShell 5.0 результаты командлета Get-Command отображают столбец версии по умолчанию. В класс commandInfo добавлено новое свойство Version.

Эта команда получает командлеты, функции и псевдонимы PowerShell, установленные на компьютере.

Get-Command

Эта команда использует параметр ListImported для получения только команд в текущем сеансе.

Get-Command -ListImported

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

Get-Command -Type Cmdlet | Sort-Object -Property Noun | Format-Table -GroupBy Noun

Эта команда использует параметр модуля для получения команд в модулях Microsoft.PowerShell.Security и Microsoft.PowerShell.Utility.

Get-Command -Module Microsoft.PowerShell.Security, Microsoft.PowerShell.Utility

Эта команда получает сведения о командлете Get-AppLockerPolicy. Он также импортирует модуль AppLocker, который добавляет все команды в модуль AppLocker в текущий сеанс.

Get-Command Get-AppLockerPolicy

При автоматическом импорте модуля эффект совпадает с использованием командлета Import-Module. Модуль может добавлять команды, типы и файлы форматирования, а также запускать скрипты в сеансе. Чтобы включить, отключить и настроить автоматическое импортирование модулей, используйте переменную предпочтения $PSModuleAutoLoadingPreference. Дополнительные сведения см. в разделе about_Preference_Variables.

Эта команда использует параметры ArgumentList и Синтаксиса для получения синтаксиса командлета Get-ChildItem при его использовании на диске Cert. Сертификат: диск PowerShell — это диск PowerShell, который поставщик сертификатов добавляет в сеанс.

Get-Command  -Name Get-ChildItem -Args Cert: -Syntax

При сравнении синтаксиса, отображаемого в выходных данных, с синтаксисом, отображаемым при пропуске параметра Args (ArgumentList), вы увидите, что поставщик сертификатов добавляет динамический параметр CodeSigningCert в Get-ChildItem командлет.

Дополнительные сведения о поставщике сертификатов см. в about_Certificate_Provider.

Команда в примере использует Get-DynamicParameters функцию для получения динамических параметров, которые поставщик сертификатов добавляет в Get-ChildItem командлет при его использовании на диске Cert.

function Get-DynamicParameters
{
    param ($Cmdlet, $PSDrive)
    (Get-Command -Name $Cmdlet -ArgumentList $PSDrive).ParameterSets |
      ForEach-Object {$_.Parameters} |
        Where-Object { $_.IsDynamic } |
          Select-Object -Property Name -Unique
}
Get-DynamicParameters -Cmdlet Get-ChildItem -PSDrive Cert:

Name
----
CodeSigningCert

Функция Get-DynamicParameters в этом примере получает динамические параметры командлета. Это альтернатива методу, используемому в предыдущем примере. Динамический параметр можно добавить в командлет другим командлетом или поставщиком.

Эта команда получает все команды всех типов на локальном компьютере, включая исполняемые файлы в путях переменной среды PATH ($Env:PATH).

Get-Command *

Он возвращает объект ApplicationInfo (System.Management.Automation.ApplicationInfo) для каждого файла, а не объект FileInfo (System.IO.FileInfo).

Эта команда получает командлеты с параметром, имя которого включает проверку подлинности и тип которого AuthenticationMechanism.

Get-Command -ParameterName *Auth* -ParameterType AuthenticationMechanism

Для поиска командлетов можно использовать команду, которая позволяет указать метод, используемый для проверки подлинности пользователя.

Параметр ParameterType отличает параметры, которые принимают значение AuthenticationMechanism от тех, кто принимает параметр AuthenticationLevel, даже если они имеют похожие имена.

В этом примере показано, как использовать командлет Get-Command с псевдонимом.

Get-Command -Name dir

CommandType     Name                                               ModuleName
-----------     ----                                               ----------
Alias           dir -> Get-ChildItem

Хотя он обычно используется для командлетов и функций, Get-Command также получает скрипты, функции, псевдонимы и исполняемые файлы.

Выходные данные команды показывают специальное представление значения свойства Name для псевдонимов. В представлении показаны псевдоним и полное имя команды.

В этом примере показано, как получить синтаксис вместе со стандартным именем псевдонима.

Выходные данные команды показывают помеченный псевдоним со стандартным именем, а затем синтаксис.

Get-Command -Name dir -Syntax

dir (alias) -> Get-ChildItem

dir [[-Path] <string[]>] [[-Filter] <string>] [-Include <string[]>] [-Exclude <string[]>] [-Recurse]
[-Depth <uint>] [-Force] [-Name] [-Attributes <FlagsExpression[FileAttributes]>] [-FollowSymlink]
[-Directory] [-File] [-Hidden] [-ReadOnly] [-System] [<CommonParameters>]

dir [[-Filter] <string>] -LiteralPath <string[]> [-Include <string[]>] [-Exclude <string[]>] [-Recurse]
[-Depth <uint>] [-Force] [-Name] [-Attributes <FlagsExpression[FileAttributes]>] [-FollowSymlink]
[-Directory] [-File] [-Hidden] [-ReadOnly] [-System] [<CommonParameters>]

В этом примере используется параметр All командлета Get-Command для отображения всех экземпляров Notepad команды на локальном компьютере.

Get-Command Notepad -All | Format-Table CommandType, Name, Definition

CommandType     Name           Definition
-----------     ----           ----------
Application     notepad.exe    C:\WINDOWS\system32\notepad.exe
Application     NOTEPAD.EXE    C:\WINDOWS\NOTEPAD.EXE

Параметр All полезен при наличии нескольких команд с одинаковым именем в сеансе.

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

Дополнительные сведения о приоритете команд см. в about_Command_Precedence.

Эта команда получает имя модуля, в котором был создан командлет Get-Date. Команда использует свойство ModuleName всех команд.

(Get-Command Get-Date).ModuleName

Microsoft.PowerShell.Utility

Этот формат команд работает над командами в модулях PowerShell, даже если они не импортируются в сеанс.

Get-Command -Type Cmdlet | Where-Object OutputType | Format-List -Property Name, OutputType

Эта команда получает командлеты и функции с типом выходных данных и типом возвращаемых объектов.

Первая часть команды получает все командлеты. Оператор конвейера (|) отправляет командлеты Where-Object в командлет, который выбирает только те, в которых заполняется свойство OutputType . Другой оператор конвейера отправляет выбранные объекты командлета в командлет Format-List, который отображает имя и выходной тип каждого командлета в списке.

Свойство outputType OutputType объекта CommandInfo commandInfo имеет значение, отличное от NULL, только если код командлета определяет атрибут OutputType для командлета.

Get-Command -ParameterType (((Get-NetAdapter)[0]).pstypenames)

CommandType     Name                                               ModuleName
-----------     ----                                               ----------
Function        Disable-NetAdapter                                 NetAdapter
Function        Enable-NetAdapter                                  NetAdapter
Function        Rename-NetAdapter                                  NetAdapter
Function        Restart-NetAdapter                                 NetAdapter
Function        Set-NetAdapter                                     NetAdapter

Эта команда находит командлеты, которые принимают объекты net adapter в качестве входных данных. Этот формат команды можно использовать для поиска командлетов, которые принимают тип объектов, возвращаемых любой командой.

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

В этом примере имя команды намеренно имеет опечатку как get-commnd. -UseFuzzyMatching Используя переключатель, командлет определил, что за лучшим совпадением последовали Get-Command другие собственные команды в системе, которые были аналогичным совпадением.

Get-Command get-commnd -UseFuzzyMatching

CommandType     Name             Version    Source
-----------     ----             -------    ------
Cmdlet          Get-Command      6.2.0.0    Microsoft.PowerShell.Core
Application     getconf          0.0.0.0    /usr/bin/getconf
Application     command          0.0.0.0    /usr/bin/command

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

Вы можете передать имена команд в этот командлет.

Этот командлет возвращает объекты, производные от класса CommandInfo . Тип возвращаемого объекта зависит от типа команды, которая Get-Command получает.

Представляет псевдонимы.

Представляет приложения и файлы.

Представляет командлеты.

Представляет функции и фильтры.

PowerShell включает следующие псевдонимы для Get-Command:

• Все платформы:

  • gcm

• Если для сеанса доступно несколько команд с одинаковым именем, Get-Command возвращает команду, которая выполняется при вводе имени команды. Чтобы получить команды с одинаковым именем, перечисленным в порядке выполнения, используйте параметр All. Дополнительные сведения см. в разделе about_Command_Precedence.

• При автоматическом импорте модуля эффект совпадает с использованием командлета Import-Module. Модуль может добавлять команды, типы и файлы форматирования, а также запускать скрипты в сеансе. Чтобы включить, отключить и настроить автоматическое импортирование модулей, используйте переменную предпочтения $PSModuleAutoLoadingPreference. Дополнительные сведения см. в разделе about_Preference_Variables.