Share via

Get-Command

  • Referens
Modul:
Microsoft.PowerShell.Core

Hämtar alla kommandon.

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

Anger att denna cmdlet hämtar alla kommandon, inklusive kommandon av samma typ som har samma namn. Som standard Get-Command hämtar endast de kommandon som körs när du skriver kommandonamnet.

Mer information om den metod som PowerShell använder för att välja kommandot som ska köras när flera kommandon har samma namn finns i about_Command_Precedence. Information om modulkvalificerade kommandonamn och kommandon som inte körs som standard på grund av en namnkonflikt finns i about_Modules.

Den här parametern introducerades i Windows PowerShell 3.0.

I Windows PowerShell 2.0 Get-Command hämtar alla kommandon som standard.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ArgumentList

Anger en matris med argument. Den här cmdleten hämtar information om en cmdlet eller funktion när den används med de angivna parametrarna ("argument"). Aliaset för ArgumentList är Args.

Om du vill identifiera dynamiska parametrar som endast är tillgängliga när vissa andra parametrar används anger du värdet för ArgumentList till de parametrar som utlöser de dynamiska parametrarna.

Om du vill identifiera de dynamiska parametrar som en provider lägger till i en cmdlet anger du värdet för parametern ArgumentList till en sökväg på providerenheten, till exempel WSMan:, HKLM:, eller Cert:. När kommandot är en PowerShell-provider-cmdlet anger du bara en sökväg i varje kommando. Provider-cmdletarna returnerar endast dynamiska parametrar för den första sökvägen värdet för ArgumentList. Information om provider-cmdletar finns i about_Providers.

Type:Object[]
Aliases:Args
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CommandType

Anger vilka typer av kommandon som den här cmdleten hämtar. Ange en eller flera kommandotyper. Använd CommandType eller dess alias, Typ. Som standard Get-Command hämtar alla cmdletar, funktioner och alias.

De acceptabla värdena för den här parametern är:

  • Alias: Hämtar alias för alla PowerShell-kommandon. Mer information finns i about_Aliases.

  • All: Hämtar alla kommandotyper. Det här parametervärdet motsvarar Get-Command *.

  • Application: Hämtar icke-PowerShell-filer i sökvägar som anges i variabeln Sökvägsmiljö ($env:path), inklusive .txt, .exeoch .dll filer. Mer information om variabeln Sökvägsmiljö finns i about_Environment_Variables.

  • Cmdlet: Hämtar alla cmdletar.

  • ExternalScript: Hämtar alla .ps1 filer i sökvägarna som anges i variabeln Sökvägsmiljö ($env:path).

  • Filter och Function: Hämtar alla avancerade och enkla Funktioner och filter i PowerShell.

  • Script: Hämtar alla skriptblock. Använd värdet för att hämta PowerShell-skript (.ps1 filer ExternalScript ).

Dessa värden definieras som en flaggbaserad uppräkning. Du kan kombinera flera värden för att ange flera flaggor med den här parametern. Värdena kan skickas till parametern CommandType som en matris med värden eller som en kommaavgränsad sträng för dessa värden. Cmdleten kombinerar värdena med hjälp av en binär-OR-åtgärd. Att skicka värden som en matris är det enklaste alternativet och gör att du även kan använda tab-completion på värdena.

Type:CommandTypes
Aliases:Type
Accepted values:Alias, Function, Filter, Cmdlet, ExternalScript, Application, Script, Workflow, Configuration, All
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-FullyQualifiedModule

Värdet kan vara ett modulnamn, en fullständig modulspecifikation eller en sökväg till en modulfil.

När värdet är en sökväg kan sökvägen vara fullständigt kvalificerad eller relativ. En relativ sökväg matchas i förhållande till skriptet som innehåller instruktionen using.

När värdet är ett namn eller en modulspecifikation söker PowerShell i PSModulePath efter den angivna modulen.

En modulspecifikation är en hashtable som har följande nycklar.

  • ModuleName - Krävs Anger modulnamnet.

  • GUID - Valfri Anger GUID för modulen.

  • Det är också Obligatoriskt att ange minst en av de tre nycklarna nedan.

    • ModuleVersion – Anger en lägsta godtagbar version av modulen.

    • MaximumVersion – Anger den högsta godkända versionen av modulen.

    • RequiredVersion – Anger en exakt version av modulen som krävs. Detta kan inte användas med de andra versionsnycklarna.

Du kan inte ange parametern FullyQualifiedModule i samma kommando som en modulparameter . De två parametrarna är ömsesidigt uteslutande.

Type:ModuleSpecification[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ListImported

Anger att den här cmdleten bara hämtar kommandon i den aktuella sessionen.

Från och med PowerShell 3.0 hämtas som standard Get-Command alla installerade kommandon, inklusive, men inte begränsat till, kommandona i den aktuella sessionen. I PowerShell 2.0 hämtas endast kommandon i den aktuella sessionen.

Den här parametern introducerades i Windows PowerShell 3.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Module

Anger en matris med moduler. Den här cmdleten hämtar kommandona som kom från de angivna modulerna. Ange namnen på moduler eller modulobjekt.

Den här parametern tar strängvärden, men värdet för den här parametern kan också vara ett PSModuleInfo-objekt , till exempel de objekt som Get-Module cmdletarna och Import-PSSession returnerar.

Type:String[]
Aliases:PSSnapin
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Name

Anger en matris med namn. Den här cmdleten hämtar endast kommandon som har det angivna namnet. Ange ett namn- eller namnmönster. Jokertecken tillåts.

Om du vill hämta kommandon som har samma namn använder du parametern Alla . När två kommandon har samma namn får som standard Get-Command kommandot som körs när du skriver kommandonamnet.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Noun

Anger en matris med kommando substantiv. Den här cmdleten hämtar kommandon, som innehåller cmdletar, funktioner och alias, som har namn som innehåller det angivna substantivet. Ange ett eller flera substantiv eller substantivmönster. Jokertecken tillåts.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-ParameterName

Anger en matris med parameternamn. Den här cmdleten hämtar kommandon i sessionen som har de angivna parametrarna. Ange parameternamn eller parameteralias. Jokertecken stöds.

Parametrarna ParameterName och ParameterType söker bara efter kommandon i den aktuella sessionen.

Den här parametern introducerades i Windows PowerShell 3.0.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ParameterType

Anger en matris med parameternamn. Den här cmdleten hämtar kommandon i sessionen som har parametrar av den angivna typen. Ange det fullständiga namnet eller det partiella namnet på en parametertyp. Jokertecken stöds.

Parametrarna ParameterName och ParameterType söker bara efter kommandon i den aktuella sessionen.

Den här parametern introducerades i Windows PowerShell 3.0.

Type:PSTypeName[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-ShowCommandInfo

Anger att den här cmdleten visar kommandoinformation.

Den här parametern introducerades i Windows PowerShell 5.0.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Syntax

Anger att den här cmdleten bara hämtar följande angivna data om kommandot:

  • Alias. Hämtar standardnamnet.
  • Cmdlets. Hämtar syntaxen.
  • Funktioner och filter. Hämtar funktionsdefinitionen.
  • Skript och program eller filer. Hämtar sökvägen och filnamnet.
Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-TotalCount

Anger antalet kommandon som ska hämtas. Du kan använda den här parametern för att begränsa utdata för ett kommando.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UseAbbreviationExpansion

Anger hur du använder matchning av tecknen i kommandot för att hitta med versaler i ett kommando. Skulle till exempel i-psdf matcha Import-PowerShellDataFile eftersom vart och ett av tecknen för att hitta matchar ett versalt tecken i resultatet. När du använder den här typen av matchning resulterar jokertecken inte i några matchningar.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-UseFuzzyMatching

Anger hur du använder en fuzzy-matchande algoritm när du hittar kommandon. Utdataordningen är från närmaste matchning till minst sannolika matchning. Jokertecken ska inte användas med fuzzy-matchning eftersom det försöker matcha kommandon som kan innehålla dessa jokertecken.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Verb

Anger en matris med kommandoverb. Den här cmdleten hämtar kommandon, som innehåller cmdletar, funktioner och alias, som har namn som innehåller det angivna verbet. Ange ett eller flera verb- eller verbmönster. Jokertecken tillåts.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

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.