Remove-Alias

Module:
Microsoft.PowerShell.Utility Module

Supprimez un alias de la session active.

Syntaxe

Default (Par défaut) 

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:0
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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 (de 0 jusqu'au nombre total d’étendues, où 0 est l’étendue actuelle et 1 est son parent)

Propriétés du paramètre

Type:String
Valeur par défaut:Local
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

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.

Entrées

String

Vous pouvez rediriger 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.