Set-Alias

Set-Alias
    [-Name] <string>
    [-Value] <string>
    [-Description <string>]
    [-Option <ScopedItemOptions>]
    [-PassThru]
    [-Scope <string>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

L’applet Set-Alias de commande crée ou modifie un alias pour une applet de commande ou une commande, telle qu’une fonction, un script, un fichier ou un autre exécutable. Un alias est un autre nom qui fait référence à une applet de commande ou une commande. Par exemple, sal est l’alias de l’applet de Set-Alias commande. Pour plus d’informations, consultez about_Aliases.

Une applet de commande peut avoir plusieurs alias, mais un alias ne peut être associé qu’à une seule applet de commande. Vous pouvez utiliser Set-Alias pour réaffecter un alias existant à une autre applet de commande ou modifier les propriétés d’un alias, telles que la description.

Un alias créé ou modifié par Set-Alias n’est pas permanent et n’est disponible que pendant la session PowerShell en cours. Lorsque la session PowerShell est fermée, l’alias est supprimé.

Cette commande crée un alias pour une applet de commande dans la session PowerShell actuelle.

PS> Set-Alias -Name list -Value Get-ChildItem

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

L’applet Set-Alias de commande crée un alias dans la session PowerShell actuelle. Le paramètre Name spécifie le nom de l’alias. list Le paramètre Value spécifie l’applet de commande que l’alias s’exécute.

Pour exécuter l’alias, tapez list sur la ligne de commande PowerShell.

Cette commande réaffecte un alias existant pour exécuter une autre applet de commande.

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

PS> Set-Alias -Name list -Value Get-Location

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-Location

L’applet Get-Alias de commande utilise le paramètre Name pour afficher l’alias list . L’alias list est associé à l’applet de Get-ChildItem commande. Lorsque l’alias list est exécuté, les éléments du répertoire actif sont affichés.

L’applet Set-Alias de commande utilise le paramètre Name pour spécifier l’alias list . Le paramètre Value associe l’alias à l’applet de Get-Location commande.

L’applet Get-Alias de commande utilise le paramètre Name pour afficher l’alias list . L’alias list est associé à l’applet de Get-Location commande. Lorsque l’alias list est exécuté, l’emplacement du répertoire actif s’affiche.

Cette commande crée un alias en lecture seule. L’option en lecture seule empêche les modifications involontaires apportées à un alias. Pour modifier ou supprimer un alias en lecture seule, utilisez le paramètre Force .

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         :
Name                : loc
CommandType         : Alias

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -Description 'Displays the current directory' -Force -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         : Displays the current directory
Name                : loc
CommandType         : Alias

L’applet Set-Alias de commande crée un alias dans la session PowerShell actuelle. Le paramètre Name spécifie le nom de l’alias. loc Le paramètre Value spécifie l’applet Get-Location de commande que l’alias s’exécute. Le paramètre Option spécifie la valeur ReadOnly . Le paramètre PassThru représente l’objet alias et envoie l’objet vers le bas du pipeline à l’applet Format-List de commande. Format-List utilise le paramètre Property avec un astérisque (*) pour que toutes les propriétés soient affichées. L’exemple de sortie montre une liste partielle de ces propriétés.

L’alias loc est modifié avec l’ajout de deux paramètres. La description ajoute du texte pour expliquer l’objectif de l’alias. Le paramètre Force est nécessaire, car l’alias loc est en lecture seule. Si le paramètre Force n’est pas utilisé, la modification échoue.

Cet exemple crée un alias dans un fichier exécutable sur l’ordinateur local.

PS> Set-Alias -Name np -Value C:\Windows\notepad.exe

PS> Get-Alias -Name np

CommandType     Name
-----------     ----
Alias           np -> notepad.exe

L’applet Set-Alias de commande crée un alias dans la session PowerShell actuelle. Le paramètre Name spécifie le nom de l’alias. np Le paramètre Value spécifie le chemin d’accès et le nom de l’application C:\Windows\notepad.exe. L’applet Get-Alias de commande utilise le paramètre Name pour indiquer que l’alias np est associé à notepad.exe.

Pour exécuter l’alias, tapez np sur la ligne de commande PowerShell pour ouvrir notepad.exe.

Cet exemple montre comment affecter un alias à une commande avec des paramètres.

Vous pouvez créer un alias pour une applet de commande, par Set-Locationexemple . Vous ne pouvez pas créer d’alias pour une commande avec des paramètres et des valeurs, tels que Set-Location -Path C:\Windows\System32. Pour créer un alias pour une commande, créez une fonction qui inclut la commande, puis créez un alias pour la fonction. Pour plus d’informations, consultez about_Functions.

PS> Function CD32 {Set-Location -Path C:\Windows\System32}

PS> Set-Alias -Name Go -Value CD32

Une fonction nommée CD32 est créée. La fonction utilise l’applet Set-Location de commande avec le paramètre Path pour spécifier le répertoire C :\Windows\System32.

L’applet Set-Alias de commande crée un alias pour la fonction dans la session PowerShell actuelle. Le paramètre Name spécifie le nom de l’alias. Go Le paramètre Value spécifie le nom de la fonction. CD32

Pour exécuter l’alias, tapez Go sur la ligne de commande PowerShell. La CD32 fonction s’exécute et passe au répertoire C :\Windows\System32.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Set-Alias n’accepte pas les entrées du pipeline.

Lorsque vous utilisez le paramètre PassThru , Set-Alias génère un objet System.Management.Automation.AliasInfo représentant l’alias. Sinon, Set-Alias ne génère aucune sortie.

PowerShell inclut des alias intégrés disponibles dans chaque session PowerShell. L’applet Get-Alias de commande affiche les alias disponibles dans une session PowerShell.

Pour créer un alias, utilisez Set-Alias ou New-Alias. Pour supprimer un alias, utilisez l’applet de commande Remove-Item. Par exemple : Remove-Item -Path Alias:aliasname.

Pour créer un alias disponible dans chaque session PowerShell, ajoutez-le à votre profil PowerShell. Pour plus d’informations, consultez about_Profiles.

Un alias peut être enregistré et réutilisé dans une autre session PowerShell en effectuant une exportation et une importation. Pour enregistrer un alias dans un fichier, utilisez Export-Alias. Pour ajouter un alias enregistré à une nouvelle session PowerShell, utilisez Import-Alias.