Partager via

Remove-Alias

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

Supprimez un alias de la session active.

Syntaxe

Remove-Alias
      [-Name] <String[]>
      [-Scope <String>]
      [-Force]
      [<CommonParameters>]

Description

L’applet de commande Remove-Alias supprime un alias de la session PowerShell actuelle. Pour supprimer un alias avec la propriété Option définie sur ReadOnly, utilisez le paramètre force.

L’applet de commande Remove-Alias a été introduite dans PowerShell 6.0.

Exemples

Exemple 1 - Supprimer un alias

Cet exemple supprime un alias nommé del qui représente l’applet de commande Remove-Item.

Remove-Alias -Name del

Exemple 2 - Supprimer tous les alias non constants

Cet exemple supprime tous les alias de la session PowerShell actuelle, à l’exception des alias avec la propriété Options définie sur constante. Une fois la commande exécutée, les alias sont disponibles dans d’autres sessions PowerShell ou de nouvelles sessions PowerShell.

Get-Alias | Where-Object { $_.Options -NE "Constant" } | Remove-Alias -Force

Get-Alias obtient tous les alias de la session PowerShell et envoie les objets vers le bas du pipeline. Where-Object utilise un bloc de script et la variable automatique ($_) et propriété Options représentent l’objet de pipeline actuel. Le paramètre NE (pas égal), sélectionne les objets qui n’ont pas de valeur Options définie sur constante. Remove-Alias utilise le paramètre Forcer pour supprimer des alias, y compris des alias en lecture seule, de la session PowerShell. Le paramètre Forcer ne peut pas supprimer alias de constante.

Paramètres

-Force

Indique que l’applet de commande supprime un alias, y compris les alias avec la propriété Option définie sur ReadOnly. Le paramètre Forcer ne peut pas supprimer d’alias avec une propriété Option définie sur constante.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Spécifie le nom de l’alias à supprimer.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Scope

Affecte uniquement les alias dans l’étendue spécifiée. L’étendue par défaut est local . Pour plus d’informations, consultez about_Scopes.

Les valeurs acceptables pour ce paramètre sont les suivantes :

  • Global
  • Local
  • Script
  • Nombre relatif à l’étendue actuelle (0 au nombre d’étendues, où 0 est l’étendue actuelle et 1 est son parent)
Type:String
Position:Named
Valeur par défaut:Local
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

String[]

Vous pouvez diriger un objet alias vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne aucune sortie.

Notes

Les modifications affectent uniquement l’étendue actuelle. Pour supprimer un alias de toutes les sessions, ajoutez une commande Remove-Alias à votre profil PowerShell.

Pour plus d’informations, consultez about_Aliases.