Get-Command

Syntaxe

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

Description

L’applet Get-Command de commande obtient toutes les commandes installées sur l’ordinateur, notamment les applets de commande, les alias, les fonctions, les filtres, les scripts et les applications. Get-Command obtient les commandes des modules et commandes PowerShell importés à partir d’autres sessions. Pour obtenir uniquement les commandes qui ont été importées dans la session active, utilisez le paramètre ListImported .

Sans paramètres, Get-Command obtient toutes les applets de commande, fonctions et alias installés sur l’ordinateur. Get-Command * obtient tous les types de commandes, y compris tous les fichiers non-PowerShell dans la variable d’environnement Path ($env:PATH), qu’il répertorie dans le type de commande Application.

Get-Command qui utilise le nom exact de la commande, sans caractères génériques, importe automatiquement le module qui contient la commande afin que vous puissiez utiliser la commande immédiatement. Pour activer, désactiver et configurer l’importation automatique de modules, utilisez la $PSModuleAutoLoadingPreference variable de préférence. Pour plus d’informations, consultez about_Preference_Variables.

Get-Command obtient ses données directement à partir du code de commande, contrairement Get-Helpà ce qui obtient ses informations à partir de rubriques d’aide.

À compter de Windows PowerShell 5.0, les résultats de l’applet Get-Command de commande affichent une colonne Version par défaut. Une nouvelle propriété Version a été ajoutée à la classe CommandInfo .

Exemples

Exemple 1 : Obtenir des applets de commande, des fonctions et des alias

Cette commande permet d’obtenir les cmdlets, fonctions et alias PowerShell installés sur l’ordinateur.

Get-Command

Exemple 2 : Obtenir des commandes dans la session active

Cette commande utilise le paramètre ListImported pour obtenir uniquement les commandes de la session active.

Get-Command -ListImported

Exemple 3 : Obtenir des applets de commande et les afficher dans l’ordre

Cette commande obtient toutes les applets de commande, les trie par ordre alphabétique en fonction du nom de l’applet de commande, puis les affiche dans des groupes basés sur des noms. Cet affichage peut vous aider à trouver les applets de commande d'une tâche.

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

Exemple 4 : Obtenir des commandes dans un module

Cette commande utilise le paramètre Module pour obtenir les commandes dans les modules Microsoft.PowerShell.Security et Microsoft.PowerShell.Utility.

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

Exemple 5 : Obtenir des informations sur une applet de commande

Cette commande obtient des informations sur l’applet de Get-AppLockerPolicy commande. Il importe également le module AppLocker , qui ajoute toutes les commandes du module AppLocker à la session active.

Get-Command Get-AppLockerPolicy

Lorsqu’un module est importé automatiquement, l’effet est identique à l’utilisation de l’applet de commande Import-Module. Le module peut ajouter des commandes, des types et des fichiers de mise en forme, puis exécuter des scripts dans la session. Pour activer, désactiver et configurer l’importation automatique de modules, utilisez la $PSModuleAutoLoadingPreference variable de préférence. Pour plus d’informations, consultez about_Preference_Variables.

Exemple 6 : Obtenir la syntaxe d’une applet de commande

Cette commande utilise les paramètres ArgumentList et Syntax pour obtenir la syntaxe de l’applet Get-ChildItem de commande lorsqu’elle est utilisée dans le lecteur Cert : . Le lecteur Cert : est un lecteur PowerShell que le fournisseur de certificats ajoute à la session.

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

Lorsque vous comparez la syntaxe affichée dans la sortie à la syntaxe affichée lorsque vous omettez le paramètre Args (ArgumentList), vous verrez que le fournisseur de certificats ajoute un paramètre dynamique, CodeSigningCert, à l’applet Get-ChildItem de commande.

Pour plus d’informations sur le fournisseur de certificats, consultez about_Certificate_Provider.

Exemple 7 : Obtenir des paramètres dynamiques

La commande de l’exemple utilise la Get-DynamicParameters fonction pour obtenir les paramètres dynamiques que le fournisseur de certificats ajoute à l’applet Get-ChildItem de commande lorsqu’il est utilisé dans le lecteur 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

La Get-DynamicParameters fonction de cet exemple obtient les paramètres dynamiques d’une applet de commande. Il s'agit d'une alternative à la méthode utilisée dans l'exemple précédent. Un paramètre dynamique peut être ajouté à une applet de commande par une autre applet de commande ou un fournisseur.

Exemple 8 : Obtenir toutes les commandes de tous les types

Cette commande obtient toutes les commandes de tous les types sur l’ordinateur local, y compris les fichiers exécutables dans les chemins d’accès de la variable d’environnement Path ($env:PATH).

Get-Command *

Elle retourne un objet ApplicationInfo (System.Management.Automation.ApplicationInfo) pour chaque fichier, et non un objet FileInfo (System.IO.FileInfo).

Exemple 9 : Obtenir des applets de commande à l’aide d’un nom de paramètre et d’un type

Cette commande obtient les applets de commande qui ont un paramètre dont le nom inclut Auth et dont le type est AuthenticationMechanism.

Get-Command -ParameterName *Auth* -ParameterType AuthenticationMechanism

Vous pouvez utiliser une commande comme celle-ci pour rechercher des applets de commande qui vous permettent de spécifier la méthode utilisée pour authentifier l’utilisateur.

Le paramètre ParameterType distingue les paramètres qui prennent une valeur AuthenticationMechanism de ceux qui prennent un paramètre AuthenticationLevel , même lorsqu’ils ont des noms similaires.

Exemple 10 : Obtenir un alias

Cet exemple montre comment utiliser l’applet Get-Command de commande avec un alias.

Get-Command -Name dir

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

Bien qu’il soit généralement utilisé sur les applets de commande et les fonctions, Get-Command obtient également des scripts, des fonctions, des alias et des fichiers exécutables.

La sortie de la commande affiche l’affichage spécial de la valeur de propriété Name pour les alias. L'affichage montre l'alias et le nom de commande complet.

Exemple 11 : Obtenir la syntaxe à partir d’un alias

Cet exemple montre comment obtenir la syntaxe avec le nom standard d’un alias.

La sortie de la commande affiche l’alias étiqueté avec le nom standard, suivi de la syntaxe.

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

Exemple 12 : Obtenir toutes les instances de la commande Bloc-notes

Cet exemple utilise le paramètre All de l’applet Get-Command de commande pour afficher toutes les instances de la Notepad commande sur l’ordinateur local.

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

Le paramètre All est utile lorsqu’il existe plusieurs commandes portant le même nom dans la session.

À compter de Windows PowerShell 3.0, par défaut, lorsque la session inclut plusieurs commandes portant le même nom, Get-Command obtient uniquement la commande qui s’exécute lorsque vous tapez le nom de la commande. Avec le paramètre All , Get-Command obtient toutes les commandes avec le nom spécifié et les retourne dans l’ordre de priorité d’exécution. Pour exécuter une autre commande que la première de la liste, tapez le chemin d'accès complet de la commande.

Pour plus d’informations sur la priorité des commandes, consultez about_Command_Precedence.

Exemple 13 : Obtenir le nom d’un module qui contient une applet de commande

Cette commande obtient le nom du module dans lequel l’applet Get-Date de commande provient. La commande utilise la propriété ModuleName de toutes les commandes.

(Get-Command Get-Date).ModuleName

Microsoft.PowerShell.Utility

Ce format de commande fonctionne sur les commandes des modules PowerShell, même si elles ne sont pas importées dans la session.

Exemple 14 : Obtenir des applets de commande et des fonctions qui ont un type de sortie

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

Cette commande obtient les applets de commande et les fonctions qui ont un type de sortie, ainsi que le type d'objet qu'elles retournent.

La première partie de la commande obtient toutes les applets de commande. Un opérateur de pipeline (|) envoie les applets de commande à l’applet Where-Object de commande, qui sélectionne uniquement celles dans lesquelles la propriété OutputType est remplie. Un autre opérateur de pipeline envoie les objets d’applet de commande sélectionnés à l’applet Format-List de commande, qui affiche le nom et le type de sortie de chaque applet de commande dans une liste.

La propriété OutputType d’un objet CommandInfo a une valeur non null uniquement lorsque le code de l’applet de commande définit l’attribut OutputType pour l’applet de commande.

Exemple 15 : Obtenir des applets de commande qui prennent un type d’objet spécifique comme entrée

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

Cette commande recherche les applets de commande qui acceptent des objets de carte réseau en entrée. Vous pouvez utiliser ce format de commande pour rechercher les applets de commande qui acceptent le type d'objet retourné par une commande.

La commande utilise la propriété intrinsèque PSTypeNames de tous les objets, qui obtient les types qui décrivent l’objet. Pour obtenir la propriété PSTypeNames d’une carte réseau, et non la propriété PSTypeNames d’une collection d’adaptateurs net, la commande utilise la notation de tableau pour obtenir le premier adaptateur net retourné par l’applet de commande.

Exemple 16 : Obtenir des commandes à l’aide d’une correspondance approximative

Dans cet exemple, le nom de la commande a délibérément une faute de frappe comme « get-commnd ». À l’aide du -UseFuzzyMatching commutateur, l’applet de commande a déterminé que la meilleure correspondance a été Get-Command suivie d’autres commandes natives sur le système qui étaient une correspondance similaire.

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

Paramètres

-All

-ArgumentList

-CommandType

-FullyQualifiedModule

-FuzzyMinimumDistance

-ListImported

-Module

-Name

-Noun

-ParameterName

-ParameterType

-ShowCommandInfo

-Syntax

-TotalCount

-UseAbbreviationExpansion

-UseFuzzyMatching

-Verb

Entrées

String

Vous pouvez diriger les noms de commandes vers cette applet de commande.

Sorties

CommandInfo

Cette applet de commande retourne des objets dérivés de la classe CommandInfo . Le type d’objet retourné dépend du type de commande qui Get-Command obtient.

AliasInfo

Représente des alias.

ApplicationInfo

Représente les applications et les fichiers.

CmdletInfo

Représente des applets de commande.

FunctionInfo

Représente les fonctions et les filtres.

Notes

PowerShell inclut les alias suivants pour Get-Command:

• Toutes les plateformes :

  • gcm

• Lorsque plusieurs commandes portant le même nom sont disponibles pour la session, Get-Command retourne la commande qui s’exécute lorsque vous tapez le nom de la commande. Pour obtenir les commandes portant le même nom, répertoriées dans l’ordre d’exécution, utilisez le paramètre All . Pour plus d’informations, consultez about_Command_Precedence.

• Lorsqu’un module est importé automatiquement, l’effet est identique à l’utilisation de l’applet de Import-Module commande. Le module peut ajouter des commandes, des types et des fichiers de mise en forme, puis exécuter des scripts dans la session. Pour activer, désactiver et configurer l’importation automatique de modules, utilisez la $PSModuleAutoLoadingPreference variable de préférence. Pour plus d’informations, consultez about_Preference_Variables.

Liens associés

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