Nom du fournisseur

Alias

Lecteurs

Alias :

Description courte

Donne accès aux alias Windows PowerShell et aux valeurs qu'ils représentent.

Description détaillée

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

Un alias est un autre nom attribué à une applet de commande, une fonction ou un fichier exécutable. Windows PowerShell inclut un jeu d'alias intégrés. En outre, vous pouvez ajouter vos propres alias à la session active et à votre profil Windows PowerShell.

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

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

Le fournisseur Alias expose son magasin de données sur le lecteur Alias: Pour utiliser des alias, vous pouvez redéfinir votre emplacement pour qu'il corresponde au lecteur Alias: en utilisant la commande suivante :

Set-Location alias:

Vous avez également la possibilité de travailler à partir de tout autre lecteur Windows PowerShell. Pour référencer un alias à partir d'un autre emplacement, utilisez le nom de lecteur Alias: dans le chemin d'accès.

Windows PowerShell inclut un jeu d'applets de commande conçues pour afficher et modifier les alias :

Export-Alias

Get-Alias

Import-Alias

New-Alias

Set-Alias

Lorsque vous utilisez ces applets de commande, vous n'avez pas besoin de spécifier le lecteur Alias: dans le nom.

Le fournisseur Alias prend en charge toutes les applets de commande portant le nom Item à l'exception de l'applet de commande Invoke-Item. Il prend également en charge les applets de commande Get-Content et Set-Content. Le fournisseur Alias ne prend pas en charge les applets de commande portant le nom ItemProperty. En outre, il ne prend en charge le paramètre Filter dans aucune applet de commande.

Toutes les modifications apportées aux alias affectent uniquement la session active. Pour enregistrer les modifications, ajoutez-les au profil Windows PowerShell. Vous pouvez également utiliser les applets de commande Export-Alias et Import-Alias.

Exemples

Accès au lecteur Alias:

-------------------------- EXEMPLE 1 --------------------------

La commande suivante remplace l'emplacement actuel par le lecteur Alias:. Vous pouvez utiliser cette commande depuis n'importe quel lecteur dans Windows PowerShell. Pour revenir à un lecteur de système de fichiers, tapez le nom du lecteur. Par exemple, tapez « set-location c: ».

set-location alias:

Obtention des alias

-------------------------- EXEMPLE 1 --------------------------

La commande suivante permet d'obtenir la liste de tous les alias de la session active. Vous pouvez l'utiliser sur n'importe quel lecteur Windows PowerShell.

get-item -path alias:

-------------------------- EXEMPLE 2 --------------------------

La commande suivante obtient l'alias « ls ». Étant donné qu'elle inclut le chemin d'accès, vous pouvez l'utiliser dans tout lecteur Windows PowerShell.

get-item -path alias:ls

Si vous vous trouvez sur le lecteur Alias:, vous pouvez omettre le nom du lecteur dans le chemin d'accès.

-------------------------- EXEMPLE 3 --------------------------

La commande suivante permet d'obtenir la liste des alias associés à l'applet de commande Get-ChildItem. Elle utilise la propriété Definition, qui stocke le nom de l'applet de commande.

get-item -path alias:* | where-object {$_.Definition -eq "Get-Childitem"}

Lorsque l'élément défini par un alias est un fichier exécutable, la propriété Definition contient le chemin d'accès complet du fichier.

-------------------------- EXEMPLE 4 --------------------------

La commande suivante permet d'obtenir la liste de tous les alias lorsque l'emplacement actuel est le lecteur Alias:. Elle utilise un caractère générique (*) pour indiquer tout le contenu de l'emplacement actuel.

get-item -path *

Sur le lecteur Alias:, un point (.), qui représente l'emplacement actuel, et un caractère générique (*), qui représente tous les éléments contenus dans l'emplacement actuel, ont le même effet. Par exemple, « get-item -path . » ou « get-item * » produit le même résultat.

Création d'un alias

-------------------------- EXEMPLE 1 --------------------------

La commande suivante crée l'alias « serv » pour l'applet de commande Get-Service. L'emplacement actuel étant situé sur le lecteur Alias:, la valeur du paramètre Path est un point (.). Le point représente l'emplacement actuel.

Cette commande utilise également le paramètre dynamique Options pour définir les options AllScope et Constant sur l'alias. Le paramètre Options est disponible dans l'applet de commande New-Item uniquement lorsque vous vous trouvez sur le lecteur Alias:

new-item -path . -name serv -value Get-Service -Options "AllScope,Constant"

Si vous vous trouvez sur le lecteur Alias:, vous pouvez omettre le nom du lecteur dans le chemin d'accès.

-------------------------- EXEMPLE 2 --------------------------

Vous pouvez créer un alias pour n'importe quel élément qui appelle une commande. La commande suivante crée l'alias « np » pour Notepad.exe.

new-item -path alias:np -value c:\windows\notepad.exe

-------------------------- EXEMPLE 3 --------------------------

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 fonction CD32 qui définit le répertoire System32 comme répertoire actif. La deuxième commande crée l'alias « go » pour la fonction CD32. Le point-virgule (;) est le séparateur de commande.

Une fois la commande exécutée, vous pouvez utiliser « CD32 » ou « go » pour appeler la fonction.

function CD32 {set-location -path c:\windows\system32} set-item -path alias:go -value CD32

Affichage des propriétés et méthodes des alias

-------------------------- EXEMPLE 1 --------------------------

La commande suivante utilise l'applet de commande Get-Item pour obtenir tous les alias. L'opérateur de pipeline (|) envoie les résultats à l'applet de commande Get-Member, laquelle affiche les méthodes et propriétés de l'objet.

get-item -path alias:* | get-member

Lorsque vous dirigez une collection d'objets vers Get-Member, telle que la collection d'alias du lecteur Alias:, Get-Member évalue chaque objet de la collection séparément. Get-Member retourne ensuite les informations relatives à chaque type d'objet trouvé. Si tous les objets sont de même type, elle retourne les informations relatives à ce type d'objet. Dans le cas présent, tous les alias sont des objets AliasInfo. Pour obtenir des informations sur la collection d'objets AliasInfo, faites appel au paramètre InputObject de Get-Member. Par exemple, utilisez la commande suivante : Get-Member -InputObject (Get-Item alias:*) Lorsque vous utilisez InputObject, Get-Member évalue la collection, et non pas les objets qu'elle contient.

-------------------------- EXEMPLE 2 --------------------------

La commande suivante répertorie les valeurs des propriétés de l'alias « dir ». Elle utilise l'applet de commande Get-Item pour obtenir un objet qui représente l'alias « dir ». L'opérateur de pipeline (|) envoie les résultats à la commande Format-List. La commande Format-List utilise le paramètre Property avec un caractère générique (*) afin de mettre en forme et d'afficher les valeurs de toutes les propriétés de l'alias « dir ».

get-item alias:dir | format-list -property *

Modification des propriétés d'un alias

-------------------------- EXEMPLE 1 --------------------------

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 « dir ». Elle utilise le paramètre dynamique Options de l'applet de commande Set-Item. Le paramètre Options est disponible dans Set-Item uniquement lorsque vous l'employez avec le fournisseur Alias ou Function.

set-item -path alias:dir -options "AllScope,ReadOnly"

-------------------------- EXEMPLE 2 --------------------------

La commande suivante utilise l'applet de commande Set-Item pour modifier l'alias « gp » afin qu'il représente l'applet de commande Get-Process, et non pas l'applet de commande Get-ItemProperty. Le paramètre Force est requis car la valeur de la propriété Options de l'alias « gp » a la valeur ReadOnly. Étant donné que la commande est envoyée à partir du lecteur Alias:, 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 vérifier l'effet de la modification, tapez la commande suivante : get-item -path gp | format-list -property *

-------------------------- EXEMPLE 3 --------------------------

La commande suivante utilise l'applet de commande Rename-Item pour remplacer l'alias « popd » par « pop ».

rename-item -path alias:popd -newname pop

Copie d'un alias

-------------------------- EXEMPLE 1 --------------------------

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

copy-item -path alias:pushd -destination alias:push

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

Suppression d'un alias

-------------------------- EXEMPLE 1 --------------------------

La commande suivante supprime l'alias serv de la session active. Vous pouvez l'utiliser sur n'importe quel lecteur Windows PowerShell.

remove-item -path alias:serv

Si vous vous trouvez sur le lecteur Alias:, vous pouvez omettre le nom du lecteur dans le chemin d'accès.

-------------------------- EXEMPLE 2 --------------------------

La commande suivante supprime les alias qui commencent par « s ». Elle ne supprime pas les alias en lecture seule.

clear-item -path alias:s*

-------------------------- EXEMPLE 3 --------------------------

La commande suivante supprime tous les alias de la session active, excepté ceux dont la propriété Options a la valeur Constant. Sans le paramètre Force, la commande ne supprime pas les 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 ajoutés par un fournisseur Windows PowerShell et qui sont disponibles uniquement lorsque l'applet de commande est utilisée dans le lecteur du fournisseur.

Options <System.Management.Automation.ScopedItemOptions>

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

Value Description

None

Aucune option. Il s'agit de la valeur par défaut.

Constant

L'alias ne peut pas être supprimé et ses propriétés ne peuvent pas être modifiées. La valeur Constant est disponible uniquement lorsque vous créez un alias. Vous ne pouvez pas redéfinir l'option d'un alias existant sur Constant.

Private

L'alias est visible uniquement dans la portée actuelle, et pas dans les portées enfants.

ReadOnly

Les propriétés de l'alias ne peuvent pas être modifiées, sauf si vous utilisez le paramètre Force. Vous pouvez utiliser Remove-Item pour supprimer l'alias.

AllScope

L'alias est copié dans toutes les nouvelles portées qui sont créées.

Applets de commande prises en charge

Voir aussi




Table des matières