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]
   [-UseAbbreviationExpansion]
   [<CommonParameters>]

Description

Cmdleten Get-Command hämtar alla kommandon som är installerade på datorn, inklusive cmdletar, alias, funktioner, filter, skript och program. Get-Command hämtar kommandon från PowerShell-moduler och kommandon som har importerats från andra sessioner. Om du bara vill hämta kommandon som har importerats till den aktuella sessionen använder du parametern ListImported .

Utan parametrar Get-Command hämtar alla cmdletar, funktioner och alias installerade på datorn. Get-Command * hämtar alla typer av kommandon, inklusive alla icke-PowerShell-filer i miljövariabeln Sökväg ($env:Path), som visas i kommandotypen Program.

Get-Command som använder det exakta namnet på kommandot, utan jokertecken, importerar automatiskt modulen som innehåller kommandot så att du kan använda kommandot omedelbart. Om du vill aktivera, inaktivera och konfigurera automatisk import av moduler använder du $PSModuleAutoLoadingPreference inställningsvariabeln. Mer information finns i about_Preference_Variables.

Get-Command hämtar sina data direkt från kommandokoden, till skillnad från Get-Help, som hämtar sin information från hjälpavsnitt.

Från och med Windows PowerShell 5.0 visar resultatet av cmdleten Get-Command en versionkolumn som standard. En ny versionegenskap har lagts till i klassen CommandInfo .

Exempel

Exempel 1: Hämta cmdletar, funktioner och alias

Det här kommandot hämtar PowerShell-cmdletar, funktioner och alias som är installerade på datorn.

Get-Command

Exempel 2: Hämta kommandon i den aktuella sessionen

Det här kommandot använder parametern ListImported för att endast hämta kommandona i den aktuella sessionen.

Get-Command -ListImported

Exempel 3: Hämta cmdletar och visa dem i ordning

Det här kommandot hämtar alla cmdletar, sorterar dem alfabetiskt efter substantiv i cmdlet-namnet och visar dem sedan i substantivbaserade grupper. Den här visningen kan hjälpa dig att hitta cmdletar för en uppgift.

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

Exempel 4: Hämta kommandon i en modul

Det här kommandot använder modulparametern för att hämta kommandona i modulerna Microsoft.PowerShell.Security och Microsoft.PowerShell.Utility.

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

Exempel 5: Hämta information om en cmdlet

Det här kommandot hämtar information om cmdleten Get-AppLockerPolicy . Den importerar även AppLocker-modulen , som lägger till alla kommandon i AppLocker-modulen till den aktuella sessionen.

Get-Command Get-AppLockerPolicy

När en modul importeras automatiskt är effekten samma som med cmdleten Import-Module. Modulen kan lägga till kommandon, typer och formateringsfiler och köra skript i sessionen. Om du vill aktivera, inaktivera och konfigurera automatisk import av moduler använder du $PSModuleAutoLoadingPreference inställningsvariabeln. Mer information finns i about_Preference_Variables.

Exempel 6: Hämta syntaxen för en cmdlet

Det här kommandot använder parametrarna ArgumentList och Syntax för att hämta cmdletens Get-ChildItem syntax när den används i cert:-enheten. Enheten Cert: är en PowerShell-enhet som certifikatprovidern lägger till i sessionen.

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

När du jämför syntaxen som visas i utdata med syntaxen som visas när du utelämnar parametern Args (ArgumentList) ser du att certifikatprovidern lägger till en dynamisk parameter, CodeSigningCert, i cmdleten Get-ChildItem .

Mer information om certifikatprovidern finns i about_Certificate_Provider.

Exempel 7: Hämta dynamiska parametrar

Kommandot i exemplet använder Get-DynamicParameters funktionen för att hämta de dynamiska parametrar som certifikatprovidern lägger till i cmdleten Get-ChildItem när den används på cert:-enheten.

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

Funktionen Get-DynamicParameters i det här exemplet hämtar dynamiska parametrar för en cmdlet. Det här är ett alternativ till den metod som användes i föregående exempel. Dynamisk parameter kan läggas till i en cmdlet av en annan cmdlet eller en provider.

Exempel 8: Hämta alla kommandon av alla typer

Det här kommandot hämtar alla kommandon av alla typer på den lokala datorn, inklusive körbara filer i sökvägarna för miljövariabeln Sökväg ($env:path).

Get-Command *

Den returnerar ett ApplicationInfo-objekt (System.Management.Automation.ApplicationInfo) för varje fil, inte ett FileInfo-objekt (System.IO.FileInfo).

Exempel 9: Hämta cmdletar med hjälp av ett parameternamn och en typ

Det här kommandot hämtar cmdletar som har en parameter vars namn inkluderar Auth och vars typ är AuthenticationMechanism.

Get-Command -ParameterName *Auth* -ParameterType AuthenticationMechanism

Du kan använda ett kommando som det här för att hitta cmdletar som gör att du kan ange den metod som används för att autentisera användaren.

Parametertype-parametern skiljer parametrar som tar ett AuthenticationMechanism-värde från de som tar en AuthenticationLevel-parameter, även om de har liknande namn.

Exempel 10: Hämta ett alias

Det här exemplet visar hur du använder cmdleten Get-Command med ett alias.

Get-Command -Name dir

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

Även om det vanligtvis används på cmdletar och funktioner, Get-Command hämtar även skript, funktioner, alias och körbara filer.

Kommandots utdata visar den särskilda vyn för egenskapsvärdet Namn för alias. Vyn visar aliaset och det fullständiga kommandonamnet.

Exempel 11: Hämta syntax från ett alias

Det här exemplet visar hur du hämtar syntaxen tillsammans med standardnamnet för ett alias.

Kommandots utdata visar det märkta aliaset med standardnamnet följt av syntaxen.

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

Exempel 12: Hämta alla instanser av kommandot Anteckningar

I det här exemplet används parametern Alla för cmdleten Get-Command för att visa alla instanser av Notepad kommandot på den lokala datorn.

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

Parametern Alla är användbar när det finns fler än ett kommando med samma namn i sessionen.

Från och med Windows PowerShell 3.0 får sessionen som standard bara kommandot som körs när du skriver kommandonamnet när sessionen innehåller flera kommandon med samma namnGet-Command. Med parametern Get-CommandAlla hämtar alla kommandon med det angivna namnet och returnerar dem i körningsprioritetens ordning. Om du vill köra ett annat kommando än det första i listan skriver du den fullständigt kvalificerade sökvägen till kommandot .

Mer information om kommandoprioretens finns i about_Command_Precedence.

Exempel 13: Hämta namnet på en modul som innehåller en cmdlet

Det här kommandot hämtar namnet på modulen där cmdleten Get-Date kom från. Kommandot använder egenskapen ModuleName för alla kommandon.

(Get-Command Get-Date).ModuleName

Microsoft.PowerShell.Utility

Det här kommandoformatet fungerar på kommandon i PowerShell-moduler, även om de inte importeras till sessionen.

Exempel 14: Hämta cmdletar och funktioner som har en utdatatyp

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

Det här kommandot hämtar de cmdletar och funktioner som har en utdatatyp och vilken typ av objekt de returnerar.

Den första delen av kommandot hämtar alla cmdletar. En pipelineoperator (|) skickar cmdletarna till cmdleten Where-Object , som endast väljer de som outputType-egenskapen är ifylld i. En annan pipelineoperator skickar de valda cmdlet-objekten till cmdleten Format-List , som visar namnet och utdatatypen för varje cmdlet i en lista.

Egenskapen OutputType för ett CommandInfo-objekt har endast ett värde som inte är null när cmdlet-koden definierar attributet OutputType för cmdleten.

Exempel 15: Hämta cmdletar som använder en specifik objekttyp som indata

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

Det här kommandot hittar cmdletar som tar net adapter-objekt som indata. Du kan använda det här kommandoformatet för att hitta de cmdletar som accepterar den typ av objekt som alla kommandon returnerar.

Kommandot använder den inbyggda egenskapen PSTypeNames för alla objekt, som hämtar de typer som beskriver objektet. För att hämta egenskapen PSTypeNames för ett nätkort och inte egenskapen PSTypeNames för en samling net-kort använder kommandot matrisnotation för att hämta det första nettokortet som cmdleten returnerar.

Exempel 16: Hämta kommandon med en fuzzy-matchning

I det här exemplet har namnet på kommandot avsiktligt ett skrivfel som "get-commnd". Med hjälp av växeln -UseFuzzyMatching fastställde cmdleten att den bästa matchningen följdes Get-Command av andra interna kommandon i systemet som var en liknande matchning.

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

Parametrar

-All

-ArgumentList

-CommandType

-FullyQualifiedModule

-ListImported

-Module

-Name

-Noun

-ParameterName

-ParameterType

-ShowCommandInfo

-Syntax

-TotalCount

-UseAbbreviationExpansion

-UseFuzzyMatching

-Verb

Indata

String

Du kan skicka kommandonamn till den här cmdleten.

Utdata

CommandInfo

Den här cmdleten returnerar objekt som härletts från klassen CommandInfo . Vilken typ av objekt som returneras beror på vilken typ av kommando som Get-Command hämtas.

AliasInfo

Representerar alias.

ApplicationInfo

Representerar program och filer.

CmdletInfo

Representerar cmdletar.

FunctionInfo

Representerar funktioner och filter.

Kommentarer

PowerShell innehåller följande alias för Get-Command:

• Alla plattformar:

  • gcm

• När mer än ett kommando som har samma namn är tillgängligt för sessionen Get-Command returnerar det kommando som körs när du skriver kommandonamnet. Om du vill hämta kommandon som har samma namn, som anges i körningsordning, använder du parametern Alla . Mer information finns i about_Command_Precedence.

• När en modul importeras automatiskt är effekten samma som med cmdleten Import-Module . Modulen kan lägga till kommandon, typer och formateringsfiler och köra skript i sessionen. Om du vill aktivera, inaktivera och konfigurera automatisk import av moduler använder du $PSModuleAutoLoadingPreference inställningsvariabeln. Mer information finns i about_Preference_Variables.

Relaterade länkar

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