Partager via

Get-Alias

  • Référence
Module:
Microsoft.PowerShell.Utility

Obtient les alias de la session active.

Syntaxe

Get-Alias
   [[-Name] <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]
Get-Alias
   [-Exclude <String[]>]
   [-Scope <String>]
   [-Definition <String[]>]
   [<CommonParameters>]

Description

L’applet de commande Get-Alias obtient les alias de la session active. Cela inclut les alias intégrés, les alias que vous avez définis ou importés et les alias que vous avez ajoutés à votre profil PowerShell.

Par défaut, Get-Alias prend un alias et retourne le nom de la commande. Lorsque vous utilisez le paramètre Definition, Get-Alias prend un nom de commande et retourne ses alias.

À compter de Windows PowerShell 3.0, Get-Alias affiche des noms d’alias non traits d’union dans un format <alias> -> <definition> pour faciliter la recherche des informations dont vous avez besoin.

Exemples

Exemple 1 : Obtenir tous les alias dans la session active

Get-Alias

CommandType     Name
-----------     ----
Alias           % -> ForEach-Object
Alias           ? -> Where-Object
Alias           ac -> Add-Content
Alias           asnp -> Add-PSSnapin
Alias           cat -> Get-Content
Alias           cd -> Set-Location
Alias           chdir -> Set-Location
Alias           clc -> Clear-Content
Alias           clear -> Clear-Host
Alias           clhy -> Clear-History
...

Cette commande obtient tous les alias de la session active.

La sortie affiche le format <alias> -> <definition> introduit dans Windows PowerShell 3.0. Ce format est utilisé uniquement pour les alias qui n’incluent pas de traits d’union, car les alias avec des traits d’union sont généralement des noms préférés pour les applets de commande et les fonctions, plutôt que pour les surnoms.

Exemple 2 : Obtenir des alias par nom

Get-Alias -Name gp*, sp* -Exclude *ps

Cette commande obtient tous les alias qui commencent par gp ou sp, à l’exception des alias qui se terminent par ps.

Exemple 3 : Obtenir des alias pour une applet de commande

Get-Alias -Definition Get-ChildItem

Cette commande obtient les alias de l’applet de commande Get-ChildItem.

Par défaut, l’applet de commande Get-Alias obtient le nom de l’élément lorsque vous connaissez l’alias. Le paramètre Définition obtient l’alias lorsque vous connaissez le nom de l’élément.

Exemple 4 : Obtenir des alias par propriété

Get-Alias | Where-Object {$_.Options -Match "ReadOnly"}

Cette commande obtient tous les alias dans lesquels la valeur de la propriété options est ReadOnly. Cette commande permet de trouver rapidement les alias intégrés à PowerShell, car ils disposent de l’option ReadOnly.

Options n’est qu’une propriété des objets AliasInfo qui Get-Alias obtient. Pour rechercher toutes les propriétés et méthodes d’objets AliasInfo, tapez Get-Alias | get-member.

Exemple 5 : Obtenir des alias par nom et filtrer par lettre de début

Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global

Cet exemple obtient des alias pour les commandes qui ont des noms qui se terminent par « -PSSession », à l’exception de ceux qui commencent par « e ».

La commande utilise le paramètre Scope pour appliquer la commande dans l’étendue globale. Cela est utile dans les scripts lorsque vous souhaitez obtenir les alias dans la session.

Paramètres

-Definition

Obtient les alias de l’élément spécifié. Entrez le nom d’une applet de commande, d’une fonction, d’un script, d’un fichier ou d’un fichier exécutable.

Ce paramètre est appelé Définition, car il recherche le nom de l’élément dans la propriété Definition de l’objet alias.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Exclude

Omettez les éléments spécifiés. La valeur de ce paramètre qualifie les paramètres Name et Définition. Entrez un nom, une définition ou un modèle, tel que « s* ». Les caractères génériques sont autorisés.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

-Name

Spécifie les alias que cette applet de commande obtient. Les caractères génériques sont autorisés. Par défaut, Get-Alias récupère tous les alias définis pour la session active. Le nom du paramètre Nom est facultatif. Vous pouvez également diriger les noms d’alias vers Get-Alias.

Type:String[]
Position:0
Valeur par défaut:All aliases
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-Scope

Spécifie l’étendue pour laquelle cette applet de commande obtient des alias. Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Global
  • Local
  • Script
  • Nombre relatif à l’étendue actuelle (0 au nombre d’étendues, où 0 est l’étendue actuelle et 1 est son parent)

Local est la valeur par défaut. Pour plus d’informations, consultez about_Scopes.

Type:String
Position:Named
Valeur par défaut:Local
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String

Vous pouvez diriger les noms d’alias vers Get-Alias.

Sorties

AliasInfo

Get-Alias retourne un objet qui représente chaque alias. Get-Alias retourne le même objet pour chaque alias, mais PowerShell utilise un format basé sur des flèches pour afficher les noms d’alias non traits d’union.

Notes

  • Pour créer un alias, utilisez Set-Alias ou New-Alias. Pour supprimer un alias, utilisez Remove-Item.
  • Le format de nom d’alias basé sur la flèche n’est pas utilisé pour les alias qui incluent un trait d’union. Ils sont susceptibles d’être des noms de substitution préférés pour les applets de commande et les fonctions, au lieu d’abréviations ou de surnoms classiques.