Remove-Alias
Supprimez un alias de la session active.
Syntax
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 de Remove-Item
commande.
Remove-Alias -Name del
Exemple 2 - Supprimer tous les alias non constants
Cet exemple supprime tous les alias de la session PowerShell active, à l’exception des alias dont la propriété Options est 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 dans le pipeline.
Where-Object
utilise un bloc de script, et la variable automatique ($_
) et la propriété Options représentent l’objet pipeline actuel. Le paramètre NE (différent de la valeur) sélectionne les objets dont la valeur Options n’est pas définie sur Constante. Remove-Alias
utilise le paramètre Force pour supprimer les alias, y compris les alias en lecture seule, de la session PowerShell. Le paramètre Force ne peut pas supprimer les 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 Force ne peut pas supprimer un alias avec une propriété Option définie sur Constante.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifie le nom de l’alias à supprimer.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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 valides pour ce paramètre sont :
Global
Local
Script
- Nombre relatif à l’étendue actuelle (de 0 au nombre d’étendues, où 0 est l’étendue actuelle et 1 est son parent)
Type: | String |
Position: | Named |
Default value: | Local |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.