Leer en inglés

Compartir a través de

Remove-Alias

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Quite un alias de la sesión actual.

Sintaxis

PowerShell 
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.

PowerShell 
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.

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 parámetro NE (no es igual), selecciona los objetos que no tienen un valor Options establecido en Constant. 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.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre del alias que se va a quitar.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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).
Tipo:String
Posición:Named
Valor predeterminado:Local
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

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.