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 Remove-Alias de commande 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 Remove-Item de commande.

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 propriété Variable automatique ($_) et 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 Force pour supprimer des alias, y compris des alias en lecture seule, de la session PowerShell. Le paramètre Force ne peut pas supprimer les alias constants .

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 Force 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 Locale. Pour plus d’informations, consultez about_Scopes.

Les valeurs valides pour ce paramètre sont :

  • 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 pas de sortie.

Notes

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

Pour plus d’informations, consultez about_Aliases.