Get-Command

Syntax

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

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

Beschreibung

Das Get-Command Cmdlet ruft alle Befehle ab, die auf dem Computer installiert sind, einschließlich Cmdlets, Aliase, Funktionen, Filter, Skripts und Anwendungen. Get-Command ruft die Befehle aus PowerShell-Modulen und -Befehlen ab, die aus anderen Sitzungen importiert wurden. Verwenden Sie den Parameter ListImported , um nur Befehle abzurufen, die in die aktuelle Sitzung importiert wurden.

Ohne Parameter Get-Command werden alle Cmdlets, Funktionen und Aliase auf dem Computer installiert. Get-Command * ruft alle Arten von Befehlen ab, einschließlich aller Nicht-PowerShell-Dateien in der Path-Umgebungsvariable ($env:PATH), die im Befehlstyp "Anwendung" aufgeführt wird.

Get-Command die den genauen Namen des Befehls ohne Wildcardzeichen verwendet, importiert automatisch das Modul, das den Befehl enthält, damit Sie den Befehl sofort verwenden können. Verwenden Sie die $PSModuleAutoLoadingPreference Einstellungsvariable, um den automatischen Import von Modulen zu aktivieren, zu deaktivieren und zu konfigurieren. Weitere Informationen finden Sie unter about_Preference_Variables.

Get-Command ruft seine Daten direkt aus dem Befehlscode ab, im Gegensatz dazu Get-Help, der seine Informationen aus Hilfethemen abruft.

Ab Windows PowerShell 5.0 zeigen die Ergebnisse des Get-Command Cmdlets standardmäßig eine Versionsspalte an. Der CommandInfo-Klasse wurde eine neue Version-Eigenschaft hinzugefügt.

Beispiele

Beispiel 1: Abrufen von Cmdlets, Funktionen und Aliasen

Dieser Befehl ruft die PowerShell-Cmdlets, Funktionen und Aliase ab, die auf dem Computer installiert sind.

Get-Command

Beispiel 2: Abrufen von Befehlen in der aktuellen Sitzung

Dieser Befehl verwendet den Parameter ListImported , um nur die Befehle in der aktuellen Sitzung abzurufen.

Get-Command -ListImported

Beispiel 3: Abrufen von Cmdlets und Anzeigen dieser Cmdlets in der reihenfolge

Dieser Befehl ruft alle Cmdlets ab, sortiert sie alphabetisch nach dem Substantiv im Cmdlet-Namen und zeigt sie dann in substantivbasierten Gruppen an. Diese Anzeige hilft Ihnen dabei, die Cmdlets für eine Aufgabe zu finden.

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

Beispiel 4: Abrufen von Befehlen in einem Modul

Dieser Befehl verwendet den Parameter "Module ", um die Befehle in den Modulen "Microsoft.PowerShell.Security" und "Microsoft.PowerShell.Utility" abzurufen.

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

Beispiel 5: Abrufen von Informationen zu einem Cmdlet

Dieser Befehl ruft Informationen zum Get-AppLockerPolicy Cmdlet ab. Außerdem wird das AppLocker-Modul importiert, das alle Befehle im AppLocker-Modul zur aktuellen Sitzung hinzufügt.

Get-Command Get-AppLockerPolicy

Wenn ein Modul automatisch importiert wird, entspricht der Effekt der Verwendung des Cmdlets "Import-Module". Das Modul kann Befehle, Typen und Formatierungsdateien hinzufügen und Skripts in der Sitzung ausführen. Verwenden Sie die $PSModuleAutoLoadingPreference Einstellungsvariable, um den automatischen Import von Modulen zu aktivieren, zu deaktivieren und zu konfigurieren. Weitere Informationen finden Sie unter about_Preference_Variables.

Beispiel 6: Abrufen der Syntax eines Cmdlets

Dieser Befehl verwendet die Parameter ArgumentList und Syntax , um die Syntax des Get-ChildItem Cmdlets abzurufen, wenn es im Cert:-Laufwerk verwendet wird. Das Zertifikat: Laufwerk ist ein PowerShell-Laufwerk, das der Zertifikatanbieter der Sitzung hinzufügt.

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

Wenn Sie die in der Ausgabe angezeigte Syntax mit der Syntax vergleichen, die angezeigt wird, wenn Sie den Parameter Args (ArgumentList) weglassen, sehen Sie, dass der Zertifikatanbieter dem Get-ChildItem Cmdlet einen dynamischen Parameter hinzufügt.

Weitere Informationen zum Zertifikatanbieter finden Sie unter about_Certificate_Provider.

Beispiel 7: Abrufen dynamischer Parameter

Der Befehl im Beispiel verwendet die Get-DynamicParameters Funktion, um die dynamischen Parameter abzurufen, die der Zertifikatanbieter dem Get-ChildItem Cmdlet hinzufügt, wenn er im Cert:-Laufwerk verwendet wird.

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

Die Get-DynamicParameters Funktion in diesem Beispiel ruft die dynamischen Parameter eines Cmdlets ab. Dies ist eine Alternative zu der Methode, die im vorherigen Beispiel verwendet wurde. Der dynamische Parameter kann durch andere Cmdlets oder einen Anbieter zu einem Cmdlet hinzugefügt werden.

Beispiel 8: Abrufen aller Befehle aller Typen

Dieser Befehl ruft alle Befehle aller Typen auf dem lokalen Computer ab, einschließlich ausführbarer Dateien in den Pfaden der Path-Umgebungsvariable ($env:PATH).

Get-Command *

Es gibt ein ApplicationInfo-Objekt (System.Management.Automation.ApplicationInfo) für jede Datei, kein FileInfo-Objekt (System.IO.FileInfo) zurück.

Beispiel 9: Abrufen von Cmdlets mithilfe eines Parameternamens und -typs

Dieser Befehl ruft Cmdlets ab, deren Name Auth enthält und deren Typ "AuthenticationMechanism" ist.

Get-Command -ParameterName *Auth* -ParameterType AuthenticationMechanism

Sie können einen Befehl wie diesen verwenden, um Cmdlets zu finden, mit denen Sie die Methode angeben können, die zum Authentifizieren des Benutzers verwendet wird.

Der Parameter "ParameterType " unterscheidet Parameter, die einen AuthenticationMechanism-Wert von denen verwenden, die einen AuthenticationLevel-Parameter verwenden, auch wenn sie ähnliche Namen haben.

Beispiel 10: Abrufen eines Alias

In diesem Beispiel wird gezeigt, wie Sie das Get-Command Cmdlet mit einem Alias verwenden.

Get-Command -Name dir

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

Obwohl sie in der Regel für Cmdlets und Funktionen verwendet wird, Get-Command werden auch Skripts, Funktionen, Aliase und ausführbare Dateien abgerufen.

Die Ausgabe des Befehls zeigt die spezielle Ansicht des Namenseigenschaftswerts für Aliase an. Die Ansicht zeigt den Alias und den vollständigen Befehlsnamen.

Beispiel 11: Abrufen einer Syntax aus einem Alias

In diesem Beispiel wird gezeigt, wie Die Syntax zusammen mit dem Standardnamen eines Alias abgerufen wird.

Die Ausgabe des Befehls zeigt den beschrifteten Alias mit dem Standardnamen gefolgt von der Syntax an.

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>]

Beispiel 12: Abrufen aller Instanzen des Editor-Befehls

In diesem Beispiel wird der Parameter "All " des Get-Command Cmdlets verwendet, um alle Instanzen des Notepad Befehls auf dem lokalen Computer anzuzeigen.

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

Der Parameter "All " ist nützlich, wenn mehrere Befehle mit demselben Namen in der Sitzung vorhanden sind.

Ab Windows PowerShell 3.0 ruft standardmäßig, wenn die Sitzung mehrere Befehle mit demselben Namen enthält, nur den Befehl ab, Get-Command der ausgeführt wird, wenn Sie den Befehlsnamen eingeben. Ruft mit dem Parameter Get-Command "All" alle Befehle mit dem angegebenen Namen ab und gibt sie in der Reihenfolge der Ausführungsrangfolge zurück. Um einen anderen Befehl als den ersten in der Liste auszuführen, geben Sie den vollqualifizierten Pfad zu dem Befehl ein.

Weitere Informationen zur Rangfolge von Befehlen finden Sie unter about_Command_Precedence.

Beispiel 13: Abrufen des Namens eines Moduls, das ein Cmdlet enthält

Dieser Befehl ruft den Namen des Moduls ab, in dem das Get-Date Cmdlet stammt. Der Befehl verwendet die ModuleName-Eigenschaft aller Befehle.

(Get-Command Get-Date).ModuleName

Microsoft.PowerShell.Utility

Dieses Befehlsformat funktioniert bei Befehlen in PowerShell-Modulen, auch wenn sie nicht in die Sitzung importiert werden.

Beispiel 14: Abrufen von Cmdlets und Funktionen mit einem Ausgabetyp

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

Dieser Befehl ruft die Cmdlets und Funktionen ab, die über einen Ausgabetyp verfügen, und den Typ der Objekte, die sie zurückgeben.

Der erste Teil des Befehls ruft alle Cmdlets ab. Ein Pipelineoperator (|) sendet die Cmdlets an das Where-Object Cmdlet, das nur diejenigen auswählt, in denen die OutputType-Eigenschaft aufgefüllt wird. Ein anderer Pipelineoperator sendet die ausgewählten Cmdlet-Objekte an das Format-List Cmdlet, das den Namen und Ausgabetyp der einzelnen Cmdlets in einer Liste anzeigt.

Die OutputType-Eigenschaft eines CommandInfo-Objekts weist nur dann einen Wert ungleich NULL auf, wenn der Cmdlet-Code das OutputType-Attribut für das Cmdlet definiert.

Beispiel 15: Abrufen von Cmdlets, die einen bestimmten Objekttyp als Eingabe verwenden

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

Mit diesem Befehl wird nach Cmdlets gesucht, die Netzwerkadapterobjekte als Eingabe akzeptieren. Verwenden Sie dieses Befehlsformat, um nach den Cmdlets zu suchen, die den Typ von Objekten akzeptieren, die ein beliebiger Befehl zurückgibt.

Der Befehl verwendet die systeminterne PSTypeNames-Eigenschaft aller Objekte, die die Typen abrufen, die das Objekt beschreiben. Zum Abrufen der PSTypeNames-Eigenschaft eines Netzadapters und nicht der PSTypeNames-Eigenschaft einer Auflistung von Netzadaptern verwendet der Befehl arraynotation, um den ersten vom Cmdlet zurückgegebenen Netzadapter abzurufen.

Beispiel 16: Abrufen von Befehlen mithilfe einer Fuzzy-Übereinstimmung

In diesem Beispiel weist der Name des Befehls absichtlich einen Tippfehler als "get-commnd" auf. Mit dem -UseFuzzyMatching Switch hat das Cmdlet festgestellt, dass auf die beste Übereinstimmung Get-Command andere systemeigene Befehle im System folgt, die eine ähnliche Übereinstimmung hatten.

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

Parameter

-All

-ArgumentList

-CommandType

-FullyQualifiedModule

-FuzzyMinimumDistance

-ListImported

-Module

-Name

-Noun

-ParameterName

-ParameterType

-ShowCommandInfo

-Syntax

-TotalCount

-UseAbbreviationExpansion

-UseFuzzyMatching

-Verb

Eingaben

String

Sie können Befehlsnamen an dieses Cmdlet weiterleiten.

Ausgaben

CommandInfo

Dieses Cmdlet gibt Objekte zurück, die von der CommandInfo-Klasse abgeleitet sind. Der Typ des zurückgegebenen Objekts hängt vom Befehlstyp ab, Get-Command der zurückgegeben wird.

AliasInfo

Stellt Aliase dar.

ApplicationInfo

Stellt Anwendungen und Dateien dar.

CmdletInfo

Stellt Cmdlets dar.

FunctionInfo

Stellt Funktionen und Filter dar.

Hinweise

PowerShell enthält die folgenden Aliase für Get-Command:

• Alle Plattformen:

  • gcm

• Wenn mehr als ein Befehl mit demselben Namen für die Sitzung verfügbar ist, wird der Befehl zurückgegeben, der ausgeführt wird, Get-Command wenn Sie den Befehlsnamen eingeben. Verwenden Sie den Parameter "All ", um Befehle mit demselben Namen abzurufen, die in der Ausführungsreihenfolge aufgeführt sind. Weitere Informationen finden Sie unter about_Command_Precedence.

• Wenn ein Modul automatisch importiert wird, entspricht der Effekt der Verwendung des Cmdlets Import-Module . Das Modul kann Befehle, Typen und Formatierungsdateien hinzufügen und Skripts in der Sitzung ausführen. Verwenden Sie die $PSModuleAutoLoadingPreference Einstellungsvariable, um den automatischen Import von Modulen zu aktivieren, zu deaktivieren und zu konfigurieren. Weitere Informationen finden Sie unter about_Preference_Variables.

Ähnliche Themen

• Export-PSSession
• Get-Help
• Get-Member
• Get-PSDrive
• Import-PSSession
• about_Command_Precedence