Compartir a través de

Remove-Alias

Módulo:
Microsoft.PowerShell.Utility Module

Quite un alias de la sesión actual.

Sintaxis

Default (Es el valor predeterminado). 

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

Description

El cmdlet Remove-Alias quita un alias de la sesión actual de PowerShell. Para quitar un alias con la propiedad Option establecida en ReadOnly, use el parámetro Force.

El cmdlet Remove-Alias se introdujo en PowerShell 6.0.

Ejemplos

Ejemplo 1: Eliminación de un alias

En este ejemplo se quita un alias denominado del que representa el cmdlet Remove-Item.

Remove-Alias -Name del

Ejemplo 2: Eliminación de todos los alias que no son constantes

En este ejemplo se quitan todos los alias de la sesión actual de PowerShell, excepto los alias en los que la propiedad Options está establecida en Constante. Una vez ejecutado el comando, los alias están disponibles en otras sesiones de PowerShell o nuevas sesiones de PowerShell.

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

Get-Alias obtiene todos los alias en la sesión de PowerShell y envía los objetos por la canalización. Where-Object usa un bloque de script, y la variable automática ($_) y la propiedad Options representan el objeto de canalización actual. El operador -ne (no igual) selecciona objetos que no tienen un valor Options establecido en Constante. Remove-Alias usa el parámetro Force para quitar alias, incluidos los alias de solo lectura, de la sesión de PowerShell. El parámetro Force no puede quitar alias de Constant.

Parámetros

-Force

Indica que el cmdlet quita un alias, incluidos los alias con la propiedad Option establecida en ReadOnly. El parámetro Force no puede quitar un alias con una propiedad Option establecida en Constant.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:False
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Name

Especifica el nombre del alias que se va a quitar.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:0
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Scope

Afecta solo a los alias del ámbito especificado. El ámbito predeterminado es Local. Para obtener más información, consulte about_Scopes.

Los valores aceptables para este parámetro son:

  • Global
  • Local
  • Script
  • Número relativo al ámbito actual (de 0 al número de ámbitos, donde 0 es el ámbito actual y 1 es su elemento primario).

Propiedades del parámetro

Tipo:String
Valor predeterminado:Local
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

Entradas

String

Puede redireccionar un objeto de alias a este cmdlet.

Salidas

None

Este cmdlet no devuelve ninguna salida.

Notas

Los cambios solo afectan al ámbito actual. Para quitar un alias de todas las sesiones, agregue un comando Remove-Alias al perfil de PowerShell.

Para más información, vea about_Aliases.