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

Met de Get-Command-cmdlet worden alle opdrachten opgehaald die op de computer zijn geïnstalleerd, waaronder cmdlets, aliassen, functies, filters, scripts en toepassingen. Get-Command haalt de opdrachten op uit PowerShell-modules en -opdrachten die beschikbaar zijn op uw systeem. Als u alleen opdrachten wilt ophalen die zijn geïmporteerd in de huidige sessie, gebruikt u de parameter ListImported.

Zonder parameters Get-Command worden alle cmdlets, functies en aliassen opgehaald die op de computer zijn geïnstalleerd. Get-Command * worden alle typen opdrachten opgehaald, inclusief alle niet-PowerShell-bestanden in de omgevingsvariabele PATH ($Env:PATH), die worden vermeld in het opdrachttype Toepassing.

Get-Command die de exacte naam van de opdracht gebruikt, zonder jokertekens, importeert automatisch de module die de opdracht bevat, zodat u de opdracht onmiddellijk kunt gebruiken. Als u het automatisch importeren van modules wilt inschakelen, uitschakelen en configureren, gebruikt u de $PSModuleAutoLoadingPreference voorkeursvariabele. Zie about_Preference_Variablesvoor meer informatie.

Get-Command haalt de gegevens rechtstreeks op uit de opdrachtcode, in tegenstelling tot Get-Help, die de informatie ophaalt uit Help-onderwerpen.

Vanaf Windows PowerShell 5.0 worden in de resultaten van de cmdlet Get-Command standaard een kolom versie weergegeven. Er is een nieuwe eigenschap Version toegevoegd aan de klasse CommandInfo.

Met deze opdracht worden de PowerShell-cmdlets, -functies en -aliassen opgehaald die op de computer zijn geïnstalleerd.

Get-Command

Deze opdracht maakt gebruik van de parameter ListImported om alleen de opdrachten in de huidige sessie op te halen.

Get-Command -ListImported

Met deze opdracht haalt u alle cmdlets op, sorteert u ze alfabetisch op het zelfstandig naamwoord in de naam van de cmdlet en geeft u ze vervolgens weer in groepen op basis van zelfstandig naamwoorden. Met deze weergave kunt u de cmdlets voor een taak vinden.

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

Deze opdracht maakt gebruik van de parameter Module om de opdrachten op te halen in de modules Microsoft.PowerShell.Security en Microsoft.PowerShell.Utility.

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

Met deze opdracht wordt informatie opgehaald over de cmdlet Get-AppLockerPolicy. Ook wordt de AppLocker-module geïmporteerd, waarmee alle opdrachten in de AppLocker-module worden toegevoegd aan de huidige sessie.

Get-Command Get-AppLockerPolicy

Wanneer een module automatisch wordt geïmporteerd, is het effect hetzelfde als het gebruik van de cmdlet Import-Module. De module kan opdrachten, typen en opmaakbestanden toevoegen en scripts uitvoeren in de sessie. Als u het automatisch importeren van modules wilt inschakelen, uitschakelen en configureren, gebruikt u de $PSModuleAutoLoadingPreference voorkeursvariabele. Zie about_Preference_Variablesvoor meer informatie.

Met deze opdracht worden de parameters ArgumentList en Syntaxis gebruikt om de syntaxis van de Get-ChildItem cmdlet op te halen wanneer deze wordt gebruikt in het certificaat: station. Het certificaat: station is een PowerShell-station dat de certificaatprovider aan de sessie toevoegt.

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

Wanneer u de syntaxis vergelijkt die in de uitvoer wordt weergegeven met de syntaxis die wordt weergegeven wanneer u de parameter Args (ArgumentList) weglaat, ziet u dat de certificaatprovider een dynamische parameter, CodeSigningCert, toevoegt aan de Get-ChildItem cmdlet.

Zie about_Certificate_Providervoor meer informatie over de certificaatprovider.

De opdracht in het voorbeeld gebruikt de Get-DynamicParameters functie om de dynamische parameters op te halen die de certificaatprovider toevoegt aan de Get-ChildItem cmdlet wanneer deze wordt gebruikt in het station 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

De Get-DynamicParameters-functie in dit voorbeeld haalt de dynamische parameters van een cmdlet op. Dit is een alternatief voor de methode die in het vorige voorbeeld wordt gebruikt. Dynamische parameter kan worden toegevoegd aan een cmdlet door een andere cmdlet of een provider.

Met deze opdracht worden alle opdrachten van alle typen op de lokale computer opgehaald, inclusief uitvoerbare bestanden in de paden van de PATH omgevingsvariabele ($Env:PATH).

Get-Command *

Het retourneert een ApplicationInfo-object (System.Management.Automation.ApplicationInfo) voor elk bestand, niet een FileInfo-object (System.IO.FileInfo).

Met deze opdracht worden cmdlets met een parameter met de naam Auth en waarvan het type is AuthenticationMechanism.

Get-Command -ParameterName *Auth* -ParameterType AuthenticationMechanism

U kunt een opdracht zoals deze gebruiken om cmdlets te vinden waarmee u de methode kunt opgeven die wordt gebruikt om de gebruiker te verifiëren.

De parameter ParameterType onderscheidt parameters die een AuthenticationMechanism waarde gebruiken van parameters die een parameter AuthenticationLevel gebruiken, zelfs als ze vergelijkbare namen hebben.

In dit voorbeeld ziet u hoe u de cmdlet Get-Command gebruikt met een alias.

Get-Command -Name dir

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

Hoewel deze doorgaans wordt gebruikt voor cmdlets en functies, Get-Command worden ook scripts, functies, aliassen en uitvoerbare bestanden opgeslagen.

In de uitvoer van de opdracht ziet u de speciale weergave van de eigenschapswaarde Name voor aliassen. In de weergave worden de alias en de volledige opdrachtnaam weergegeven.

In dit voorbeeld ziet u hoe u de syntaxis samen met de standaardnaam van een alias kunt ophalen.

In de uitvoer van de opdracht wordt de gelabelde alias weergegeven met de standaardnaam, gevolgd door de syntaxis.

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

In dit voorbeeld wordt de parameter All van de Get-Command cmdlet gebruikt om alle exemplaren van de Notepad opdracht op de lokale computer weer te geven.

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

De parameter Alle is handig wanneer er meer dan één opdracht met dezelfde naam in de sessie is.

Vanaf Windows PowerShell 3.0, standaard wanneer de sessie meerdere opdrachten met dezelfde naam bevat, krijgt Get-Command alleen de opdracht die wordt uitgevoerd wanneer u de opdrachtnaam typt. Met de parameter Alle haalt Get-Command alle opdrachten met de opgegeven naam op en retourneert deze in de volgorde van de uitvoeringsprioriteit. Als u een andere opdracht dan de eerste in de lijst wilt uitvoeren, typt u het volledig gekwalificeerde pad naar de opdracht.

Zie about_Command_Precedencevoor meer informatie over prioriteit van opdrachten.

Met deze opdracht wordt de naam opgehaald van de module waarin de Get-Date cmdlet afkomstig is. De opdracht maakt gebruik van de eigenschap ModuleName van alle opdrachten.

(Get-Command Get-Date).ModuleName

Microsoft.PowerShell.Utility

Deze opdrachtindeling werkt op opdrachten in PowerShell-modules, zelfs als ze niet in de sessie worden geïmporteerd.

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

Met deze opdracht worden de cmdlets en functies opgehaald die een uitvoertype en het type objecten hebben dat ze retourneren.

Het eerste deel van de opdracht haalt alle cmdlets op. Een pijplijnoperator (|) verzendt de cmdlets naar de Where-Object cmdlet, waarmee alleen de cmdlets worden geselecteerd waarin de eigenschap OutputType is ingevuld. Een andere pijplijnoperator verzendt de geselecteerde cmdlet-objecten naar de Format-List-cmdlet, waarin de naam en het uitvoertype van elke cmdlet in een lijst worden weergegeven.

De eigenschap OutputType van een CommandInfo-object heeft alleen een niet-null-waarde wanneer de cmdlet-code het kenmerk OutputType voor de cmdlet definieert.

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

Met deze opdracht worden cmdlets gevonden die netadapterobjecten als invoer gebruiken. U kunt deze opdrachtindeling gebruiken om de cmdlets te vinden die het type objecten accepteren dat door elke opdracht wordt geretourneerd.

De opdracht maakt gebruik van de pstypenames intrinsieke eigenschap van alle objecten, waarmee de typen worden opgehaald die het object beschrijven. Voor het ophalen van de pstypenames eigenschap van een netadapter, en niet de pstypenames eigenschap van een verzameling netadapters, gebruikt de opdracht matrix-notatie om de eerste netadapter op te halen die de cmdlet retourneert.

In dit voorbeeld heeft de naam van de opdracht opzettelijk een typefout als 'get-commnd'. Met behulp van de -UseFuzzyMatching switch heeft de cmdlet vastgesteld dat de beste overeenkomst werd Get-Command gevolgd door andere systeemeigen opdrachten op het systeem die vergelijkbaar waren.

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

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

U kunt opdrachtnamen doorsluisen naar deze cmdlet.

Met deze cmdlet worden objecten geretourneerd die zijn afgeleid van de klasse CommandInfo. Het type object dat wordt geretourneerd, is afhankelijk van het type opdracht dat Get-Command wordt opgehaald.

Vertegenwoordigt aliassen.

Vertegenwoordigt toepassingen en bestanden.

Vertegenwoordigt cmdlets.

Vertegenwoordigt functies en filters.

PowerShell bevat de volgende aliassen voor Get-Command:

• Alle platforms:
  • gcm

Wanneer er meer dan één opdracht met dezelfde naam beschikbaar is voor de sessie, retourneert Get-Command de opdracht die wordt uitgevoerd wanneer u de opdrachtnaam typt. Als u opdrachten met dezelfde naam wilt ophalen, vermeld in de uitvoeringsvolgorde, gebruikt u de parameter Alle. Zie about_Command_Precedencevoor meer informatie.

Als u deze uitvoert Get-Command met de exacte naam van de opdracht, zonder jokertekens, zoekt PowerShell naar de opdracht in alle beschikbare modules. Als de module met de opdracht nog niet is geladen, bevat het resultaat dat alleen wordt geretourneerd door Get-Command informatie die kan worden gedetecteerd vanuit het modulemanifest. De eigenschap ScriptBlock wordt bijvoorbeeld mogelijk niet ingevuld in het eerste resultaat. PowerShell importeert de module echter automatisch nadat deze het eerste resultaat heeft geretourneerd.

Wanneer een module automatisch wordt geïmporteerd, is het effect hetzelfde als het gebruik van de cmdlet Import-Module. De module kan opdrachten, typen en opmaakbestanden toevoegen en scripts uitvoeren in de sessie. Als u het automatisch importeren van modules wilt inschakelen, uitschakelen en configureren, gebruikt u de $PSModuleAutoLoadingPreference voorkeursvariabele. Zie about_Preference_Variablesvoor meer informatie.