Get-Alias

Article
01/13/2010

Obtient les alias pour la session active.

Syntaxe

Get-Alias [[-Name] <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

Get-Alias [-Definition <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]

Description

L'applet de commande Get-Alias obtient les alias (autres noms des commandes et fichiers exécutables) de la session active. Ceci inclut les alias intégrés, les alias définis ou importés, ainsi que les alias que vous avez ajoutés à votre profil Windows 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.

Paramètres

-Definition <string[]>

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é Definition, parce qu'il recherche le nom de l'élément dans la propriété Definition de l'objet alias.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	true

-Exclude <string[]>

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

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

-Name <string[]>

Spécifie les alias à récupérer. 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 de paramètre (« Name ») est facultatif. Vous pouvez également diriger les noms d'alias vers Get-Alias.

Obligatoire ?	false
Position ?	1
Valeur par défaut
Accepter l'entrée de pipeline ?	true (ByValue, ByPropertyName)
Accepter les caractères génériques ?	false

-Scope <string>

Obtient uniquement les alias de la portée spécifiée. Les valeurs valides sont « Global », « Local » ou « Script », ou un nombre relatif à la portée actuelle (0 jusqu'au nombre de portées, où 0 est la portée actuelle et 1 son parent). « Local » est la valeur par défaut. Pour plus d'informations, consultez about_Scopes.

Obligatoire ?	false
Position ?	named
Valeur par défaut
Accepter l'entrée de pipeline ?	false
Accepter les caractères génériques ?	false

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Entrées

System.String

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

Sorties

System.Management.Automation.AliasInfo

Get-Alias retourne un objet représentant chaque alias.

Remarques

Un alias est un autre nom ou surnom pour une applet de commande, une fonction ou un fichier exécutable. Pour exécuter l'applet de commande, la fonction ou le fichier exécutable, utilisez son nom complet ou tout alias. Pour plus d'informations, consultez about_Aliases.

Pour créer un alias, utilisez Set-Alias ou New-Alias. Pour supprimer un alias, utilisez Remove-Item.

Exemple 1

C:\PS>get-alias

Description
-----------
Cette commande obtient tous les alias de la session active.

Exemple 2

C:\PS>get-alias -name g*, s* -exclude get-*

Description
-----------
Cette commande obtient tous les alias qui commencent par « g » ou « s », à l'exception des alias commençant par « get- ».

Exemple 3

C:\PS>get-alias -definition Get-ChildItem

Description
-----------
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 Definition obtient l'alias lorsque vous connaissez le nom de l'élément.

Exemple 4

C:\PS>get-alias | where-object {$_.Options -match "ReadOnly"}

Description
-----------
Cette commande récupère tous les alias dans lesquels la valeur de la propriété Options est ReadOnly. Cette commande offre un moyen rapide de rechercher les alias qui sont intégrées à Windows PowerShell, parce qu'ils ont l'option ReadOnly.

Options constitue l'une des propriétés des objets AliasInfo obtenus par Get-Alias. Pour rechercher toutes les propriétés et méthodes des objets AliasInfo, tapez « get-alias | get-member ».

Exemple 5

C:\PS>get-alias -definition "*-pssession" -exclude e* -scope global

Description
-----------
Cet exemple obtient les alias des commandes dont le nom se termine par « -pssession », à l'exception de celles commençant par un « e ». 

La commande utilise le paramètre Scope pour appliquer la commande dans la portée globale. Ceci est utile dans les scripts lorsque vous souhaitez obtenir les alias de la session.

Voir aussi

Concepts

about_Aliases
Set-Alias
New-Alias
Export-Alias
Import-Alias
Alias Provider

Partager via