Remove-Alias (Microsoft.PowerShell.Utility)

Remove-Alias

Módulo:

Microsoft.PowerShell.Utility

Eliminar un alias de la sesión actual.

Sintaxis

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

Descripción

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

El cmdlet Remove-Alias se introdujo en PowerShell 6.0.

Ejemplos

Ejemplo 1: eliminar un alias

Este ejemplo elimina un alias denominado del que representa el cmdlet Remove-Item.

Remove-Alias -Name del

Ejemplo 2: eliminar todos los alias no constantes

Este ejemplo elimina todos los alias de la sesión actual de PowerShell, excepto los alias con la propiedad Opciones establecida en Constante. Después de ejecutar el comando, los alias están disponibles en otras sesiones de PowerShell o en 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 el proceso. Where-Object utiliza un bloque de secuencia de comandos, y la variable automática ($_) y la propiedad Options representan el objeto de canalización actual. El parámetro NE (no igual) selecciona objetos que no tienen un valor de Opciones establecido en Constante. Remove-Alias utiliza el parámetro Force para eliminar alias, incluidos los de solo lectura, de la sesión de PowerShell. El parámetro Force no puede eliminar los alias Constant.

Parámetros

-Force

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

Tipo :

SwitchParameter

Posición:

Nombrado

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

Tipo :

String[]

Posición:

0

Valor predeterminado:

None

Requerido:

True

Aceptar entrada de canalización:

True

Aceptar caracteres comodín:

False

-Scope

Afecta sólo a los alias en el á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

• Un número relativo al ámbito actual (de 0 al número de ámbitos, donde 0 es el ámbito actual y 1 es su padre)

Tipo :

String

Posición:

Nombrado

Valor predeterminado:

Local

Requerido:

False

Aceptar entrada de canalización:

False

Aceptar caracteres comodín:

False

Entradas

Cadena[]

Puede canalizar un objeto de alias a este cmdlet.

Salidas

Ninguno

Este cmdlet no devuelve ningún resultado.

Notas

Los cambios solo afectan el alcance actual. Para eliminar un alias de todas las sesiones, agregue un comando Remove-Alias a su perfil de PowerShell.

Para obtener más información, consulte about_Aliases.