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 * は、PATH 環境変数 ($Env:PATH) 内のすべての PowerShell ファイルを含む、すべての種類のコマンドを取得します。このファイルは Application コマンドの種類で一覧表示されます。

コマンドの正確な名前をワイルドカード文字なしで使用する Get-Command は、コマンドをすぐに使用できるように、コマンドを含むモジュールを自動的にインポートします。 モジュールの自動インポートを有効、無効、および構成するには、$PSModuleAutoLoadingPreference 基本設定変数を使用します。 詳細については、about_Preference_Variablesを参照してください。

Get-Command は、ヘルプ トピックから情報を取得する Get-Helpとは異なり、コマンド コードから直接データを取得します。

Windows PowerShell 5.0 以降、Get-Command コマンドレットの結果には、既定で Version 列が表示されます。 新しい Version プロパティが、CommandInfo クラスに追加されました。

このコマンドは、コンピューターにインストールされている PowerShell コマンドレット、関数、エイリアスを取得します。

Get-Command

このコマンドは、ListImported パラメーターを使用して、現在のセッションのコマンドのみを取得します。

Get-Command -ListImported

このコマンドは、すべてのコマンドレットを取得し、コマンドレット名の名詞でアルファベット順に並べ替え、名詞ベースのグループに表示します。 この表示は、タスクのコマンドレットを見つけるのに役立ちます。

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

このコマンドでは、Module パラメーターを使用して、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 パラメーターと Syntax パラメーターを使用して、Cert: ドライブで使用される Get-ChildItem コマンドレットの構文を取得します。 Cert: ドライブは、証明書プロバイダーがセッションに追加する PowerShell ドライブです。

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

出力に表示される構文を、Args (ArgumentList) パラメーターを省略したときに表示される構文と比較すると、証明書プロバイダー 動的パラメーター CodeSigningCertが Get-ChildItem コマンドレットに追加されることがわかります。

証明書プロバイダーの詳細については、「about_Certificate_Provider」を参照してください。

この例のコマンドでは、Get-DynamicParameters 関数を使用して、証明書プロバイダーが Cert: ドライブで使用されるときに Get-ChildItem コマンドレットに追加する動的パラメーターを取得します。

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 *

FileInfo オブジェクト (System.IO.FileInfo) ではなく、各ファイルの ApplicationInfo オブジェクト (System.Management.Automation.ApplicationInfo) を返します。

このコマンドは、名前に認証が含まれており、種類が 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>]

この例では、 コマンドレットの 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 はコマンド名を入力したときに実行されるコマンドのみを取得します。 All パラメーターを使用すると、Get-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 コマンドレットに送信し、各コマンドレットの名前と出力の種類を一覧に表示します。

CommandInfo オブジェクトの OutputType プロパティには、コマンドレット コードでコマンドレットの OutputType 属性が定義されている場合にのみ null 以外の値があります。

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

このコマンドは、ネット アダプター オブジェクトを入力として受け取るコマンドレットを検索します。 このコマンド形式を使用すると、任意のコマンドが返すオブジェクトの種類を受け入れるコマンドレットを見つけることができます。

このコマンドでは、pstypenames すべてのオブジェクトの組み込みプロパティを使用します。このプロパティは、オブジェクトを記述する型を取得します。 net アダプターのコレクションの pstypenames プロパティではなく、net アダプターの 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を参照してください。