Partager via

about_Alias_Provider

  • Article

Nom du fournisseur

Alias

Lecteurs

Alias:

Fonctionnalités

ShouldProcess

Description courte

Fournit l’accès aux alias PowerShell et aux valeurs qu’ils représentent.

Description détaillée

Le fournisseur PowerShell Alias vous permet d’obtenir, d’ajouter, de modifier, d’effacer et de supprimer des alias dans PowerShell.

Un alias est un autre nom pour une applet de commande, une fonction, un fichier exécutable, y compris des scripts. PowerShell inclut un ensemble d’alias intégrés. Vous pouvez ajouter vos propres alias à la session active et à votre profil PowerShell.

Le lecteur Alias est un espace de noms plat qui contient uniquement les objets d'alias. Les alias n'ont pas d'éléments enfants.

Le Alias fournisseur prend en charge les applets de commande suivantes, qui sont abordées dans cet article.

PowerShell inclut un ensemble d’applets de commande conçues pour afficher et modifier les alias. Lorsque vous utilisez Alias des applets de commande, vous n’avez pas besoin de spécifier le Alias: lecteur dans le nom. Cet article ne couvre pas l’utilisation des Alias applets de commande.

Types exposés par ce fournisseur

Chaque alias est une instance de la classe System.Management.Automation.Alias Info.

Le Alias fournisseur expose son magasin de données dans le Alias: lecteur. Pour utiliser des alias, vous pouvez remplacer votre emplacement par le lecteur à l’aide de la Alias: commande suivante :

Set-Location Alias:

Pour revenir à un lecteur du système de fichiers, tapez le nom du lecteur. Par exemple, entrez :

Set-Location C:

Vous pouvez également utiliser le Alias fournisseur à partir de n’importe quel autre lecteur PowerShell. Pour référencer un alias à partir d'un autre emplacement, utilisez le nom du lecteur Alias: dans le chemin d'accès.

Remarque

PowerShell utilise des alias pour vous permettre d’utiliser des chemins d’accès de fournisseur familiers. Les commandes telles que dir et ls sont désormais des alias sur Windows et dir sur Linux et macOS pour Get-ChildItem , cd est un alias pour Set-Location et pwd est un alias pour Get-Location .

Affichage du contenu du Aliaslecteur :

Cette commande obtient la liste de tous les alias lorsque l’emplacement actuel est le Alias: lecteur. Il utilise un caractère * générique pour indiquer tout le contenu de l’emplacement actuel.

PS Alias:\> Get-Item -Path *

Dans le Alias: lecteur, un point ., qui représente l’emplacement actuel et un caractère *générique , qui représente tous les éléments de l’emplacement actuel, ont le même effet. Par exemple, Get-Item -Path . ou Get-Item \* produire le même résultat.

Le fournisseur n’a pas de conteneurs. La Alias commande ci-dessus a donc le même effet quand elle est utilisée avec Get-ChildItem.

Get-ChildItem -Path Alias:

Obtenir un alias sélectionné

Cette commande obtient l’alias ls. Comme il inclut le chemin d’accès, vous pouvez l’utiliser dans n’importe quel lecteur PowerShell.

Get-Item -Path Alias:ls

Si vous êtes dans le Alias: lecteur, vous pouvez omettre le nom du lecteur à partir du chemin d’accès.

Vous pouvez également récupérer la définition d’un alias en préfixant le chemin du fournisseur avec le signe dollar ($).

$Alias:ls

Obtenir tous les alias d’une applet de commande spécifique

Cette commande obtient la liste des alias associés à l’applet Get-ChildItem de commande. Elle utilise la Definition propriété, qui stocke le nom de l’applet de commande.

Get-Item -Path Alias:* | Where-Object {$_.Definition -eq "Get-ChildItem"}

Création d’alias

Créer un alias depuis le lecteur Alias:

Cette commande crée l’alias serv pour l’applet de commande Get-Service. Étant donné que l’emplacement actuel se trouve dans le Alias: lecteur, le -Path paramètre n’est pas nécessaire.

Cette commande utilise également le paramètre dynamique -Options pour définir l’option AllScope sur l’alias. Le -Options paramètre est disponible dans l’applet New-Item de commande uniquement lorsque vous êtes dans le Alias: lecteur. Le point (.) indique le répertoire actif, qui est le lecteur d’alias.

PS Alias:\> New-Item -Path . -Name serv -Value Get-Service -Options "AllScope"

Créer un alias avec un chemin absolu

Vous pouvez créer un alias pour n’importe quel élément qui appelle une commande. Cette commande crée l’alias np pour Notepad.exe.

New-Item -Path Alias:np -Value c:\windows\notepad.exe

Créer un alias dans une nouvelle fonction

Vous pouvez créer un alias pour n’importe quelle fonction. Vous pouvez utiliser cette fonctionnalité pour créer un alias qui inclut à la fois une applet de commande et ses paramètres.

La première commande crée la CD32 fonction, qui modifie le répertoire actif vers le System32 répertoire. La deuxième commande crée l’alias go pour la fonction CD32.

Une fois la commande terminée, vous pouvez utiliser ou CD32go appeler la fonction.

function CD32 {Set-Location -Path c:\windows\system32}
Set-Item -Path Alias:go -Value CD32

Modification des alias

Modifier les options d’un alias

Vous pouvez utiliser l’applet de commande Set-Item avec le paramètre dynamique -Options pour modifier la valeur de la propriété -Options d’un alias.

Cette commande définit les options AllScope et ReadOnly pour l’alias de dir. La commande utilise le -Options paramètre dynamique de l’applet Set-Item de commande. Le -Options paramètre est disponible Set-Item lorsque vous l’utilisez avec le Alias fournisseur de fonctions.

Set-Item -Path Alias:dir -Options "AllScope, ReadOnly"

Modifier une commande référencée d’alias

Cette commande utilise l’applet de commande Set-Item pour modifier l’alias gp afin qu’il représente l’applet de commande Get-Process au lieu de l’applet de commande Get-ItemProperty. Le paramètre -Force est requis, car la valeur de la propriété options de l’alias gp est définie sur ReadOnly. Étant donné que la commande est envoyée à partir du Alias: lecteur, le lecteur n’est pas spécifié dans le chemin d’accès.

Set-Item -Path gp -Value Get-Process -Force

La modification affecte les quatre propriétés qui définissent l’association entre l’alias et la commande. Pour afficher l’effet de la modification, tapez la commande suivante :

Get-Item -Path gp | Format-List -Property *

Renommer un alias

Cette commande utilise l’applet de commande Rename-Item pour modifier l’alias de popd en pop.

Rename-Item -Path Alias:popd -NewName pop

Copie d’un alias

Cette commande copie l’alias pushd afin qu’un nouvel alias de push soit créé pour l’applet de commande Push-Location.

Lorsque le nouvel alias est créé, sa propriété Description a une valeur Null. Et sa Option propriété a la valeur .None Si la commande est émise à partir du Alias: lecteur, vous pouvez omettre le nom du lecteur à partir de la valeur du -Path paramètre.

Copy-Item -Path Alias:pushd -Destination Alias:push

Suppression d’un alias

Cette commande supprime l’alias serv de la session active. Vous pouvez utiliser cette commande dans n’importe quel lecteur PowerShell.

Remove-Item -Path Alias:serv

Cette commande supprime les alias qui commencent par « s ». Il ne supprime pas les alias en lecture seule.

Clear-Item -Path Alias:s*

Supprimer des alias en lecture seule

Cette commande supprime tous les alias de la session active, à l’exception des alias dont Constantla propriété Options a la valeur. Le -Force paramètre permet à la commande de supprimer des alias dont la propriété Options a la valeur ReadOnly.

Remove-Item Alias:* -Force

Paramètres dynamiques

Les paramètres dynamiques sont des paramètres d’applet de commande qui sont ajoutés par un fournisseur PowerShell et sont disponibles uniquement lorsque l’applet de commande est utilisée dans le lecteur avec le fournisseur.

Options [System.Management.Automation.ScopedItemOptions]

Détermine la valeur de la propriété Options d’un alias.

  • None: Aucune option. Cette valeur est la valeur par défaut.
  • Constant:l’alias ne peut pas être supprimé et ses propriétés ne peuvent pas être modifiées. Constant est disponible uniquement lorsque vous créez un alias. Vous ne pouvez pas modifier l’option d’un alias existant pour Constant.
  • Private: L'alias est visible seulement dans l'étendue active, mais pas dans les étendues enfants.
  • ReadOnly:Les propriétés de l’alias ne peuvent pas être modifiées, sauf à l’aide du paramètre -Force. Vous pouvez utiliser Remove-Item pour supprimer l’alias.
  • AllScope:l’alias est copié dans toutes les nouvelles étendues créées.

Applets de commande prises en charge

Utilisation du pipeline

Les applets de commande du fournisseur acceptent l’entrée de pipeline. Vous pouvez utiliser le pipeline pour simplifier la tâche en envoyant des données de fournisseur d’une applet de commande à une autre applet de commande du fournisseur. Pour en savoir plus sur l’utilisation du pipeline avec des applets de commande de fournisseur, consultez les références d’applet de commande fournies dans cet article.

Obtenir de l’aide

Depuis Windows PowerShell 3.0, vous pouvez obtenir des rubriques d'aide personnalisées pour les applets de commande du fournisseur, qui expliquent comment ces applets de commande se comportent dans un lecteur du système de fichiers.

Pour obtenir les rubriques d’aide personnalisées pour le lecteur de système de fichiers, exécutez une commande Get-Help dans un lecteur de système de fichiers ou utilisez le -Path paramètre Get-Help pour spécifier un lecteur de système de fichiers.

Get-Help Get-ChildItem

Get-Help Get-ChildItem -Path alias:

Voir aussi