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 de la session active. Cela inclut des alias intégrés, des alias que vous avez définis ou importés et des 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 Définition , Get-Alias prend un nom de commande et retourne ses alias.

À compter de Windows PowerShell 3.0, Get-Alias affiche les noms d’alias non trait d’union dans un <alias> -> <definition> format 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 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 Get-ChildItem de commande.

Par défaut, l’applet Get-Alias de commande 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 fournit un moyen rapide de trouver les alias intégrés à PowerShell, car ils ont l’option ReadOnly .

Les options ne sont qu’une propriété des objets AliasInfo qui Get-Alias obtiennent. 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é Définition, 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 est facultatif. Vous pouvez également diriger des 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 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
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

String

Vous pouvez diriger des 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 une flèche pour afficher les noms des alias non traités.

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