Get-Alias

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

Obtient l'alias pour la session active.

Syntax

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

Description

L’applet Get-Alias de commande obtient les alias dans 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 les noms d’alias sans trait d’union dans un <alias> -> <definition> format pour faciliter encore la recherche des informations dont vous avez besoin.

Exemples

Exemple 1 : Obtenir tous les alias de 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 dans la session active.

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

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 Get-ChildItem commande.

Par défaut, l’applet de Get-Alias commande 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 : 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 fournit un moyen rapide de rechercher 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 des 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 les alias des commandes qui ont des noms se terminant 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 quand vous souhaitez obtenir les alias figurant dans la session.

Paramètres

-Definition

Obtient les alias pour 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, car il recherche le nom de l’élément dans la propriété Definition de l’objet alias.

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

-Exclude

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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 Name est facultatif. Vous pouvez également diriger les noms d’alias vers Get-Alias.

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

-Scope

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

  • Global
  • Local
  • Script
  • Nombre relatif à l’étendue actuelle (0 par le 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
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Vous pouvez diriger une chaîne contenant un nom d’alias vers cette applet de commande.

Sorties

AliasInfo

Cette applet de commande retourne un objet qui représente chaque alias. Il retourne le même type d’objet pour chaque alias, mais PowerShell utilise un format basé sur des flèches pour afficher les noms des alias sans trait d’union.

Notes

PowerShell inclut les alias suivants pour Get-Alias:

  • Toutes les plateformes :

    • gal

  • 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 les flèches n'est pas utilisé pour les alias qui comportent un trait d'union. Ceux-ci sont susceptibles d'être des noms de remplacement par défaut pour les applets de commande et les fonctions, au lieu d'être des abréviations ou des surnoms standard.