Share via

Remove-Alias

  • Reference
Module:
Microsoft.PowerShell.Utility

Remove an alias from the current session.

Syntax

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

Description

The Remove-Alias cmdlet removes an alias from the current PowerShell session. To remove an alias with the Option property set to ReadOnly, use the Force parameter.

The Remove-Alias cmdlet was introduced in PowerShell 6.0.

Examples

Example 1 - Remove an alias

This example removes an alias named del that represents the Remove-Item cmdlet.

Remove-Alias -Name del

Example 2 - Remove all non-Constant aliases

This example removes all aliases from the current PowerShell session, except for aliases with the Options property set to Constant. After the command is run, the aliases are available in other PowerShell sessions or new PowerShell sessions.

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

Get-Alias gets all the aliases in the PowerShell session and sends the objects down the pipeline. Where-Object uses a script block, and the automatic variable ($_) and Options property represent the current pipeline object. The parameter NE (not equal), selects objects that don't have an Options value set to Constant. Remove-Alias uses the Force parameter to remove aliases, including read-only aliases, from the PowerShell session. The Force parameter can't remove Constant aliases.

Parameters

-Force

Indicates that the cmdlet removes an alias, including aliases with the Option property set to ReadOnly. The Force parameter can't remove an alias with an Option property set to Constant.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specifies the name of the alias to remove.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Scope

Affects only the aliases in the specified scope. The default scope is Local. For more information, see about_Scopes.

The acceptable values for this parameter are:

  • Global
  • Local
  • Script
  • A number relative to the current scope (0 through the number of scopes, where 0 is the current scope and 1 is its parent)
Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

String[]

You can pipe an alias object to this cmdlet.

Outputs

None

This cmdlet returns no output.

Notes

Changes only affect the current scope. To remove an alias from all sessions, add a Remove-Alias command to your PowerShell profile.

For more information, see about_Aliases.