Compartir a través de

Remove-Alias

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Quite un alias de la sesión actual.

Sintaxis

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 de 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 con la propiedad Options de 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 de la sesión de PowerShell y envía los objetos a la canalización. Where-Object usa un bloque de script y la variable automática ($_) y Options propiedad 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 constante.

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

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, vea 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 canalizar 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 obtener más información, vea about_Aliases.