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 Remove-Alias cmdlet 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 Remove-Item cmdlet .

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

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 permitidos para este parámetro son los siguientes:

  • 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 ningún resultado.

Notas

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

Para más información, vea about_Aliases.