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.

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

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.