Compartir a través de

Get-Alias

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Obtiene los alias de la sesión actual.

Sintaxis

Get-Alias
   [[-Name] <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]
Get-Alias
   [-Exclude <String[]>]
   [-Scope <String>]
   [-Definition <String[]>]
   [<CommonParameters>]

Description

El cmdlet Get-Alias obtiene los alias de la sesión actual. Esto incluye alias integrados, alias que ha establecido o importado y alias que ha agregado al perfil de PowerShell.

De forma predeterminada, Get-Alias toma un alias y devuelve el nombre del comando. Al usar el parámetro Definition, Get-Alias toma un nombre de comando y devuelve sus alias.

A partir de Windows PowerShell 3.0, Get-Alias muestra nombres de alias sin guiones en un formato de <alias> -> <definition> para facilitar aún más la búsqueda de la información que necesita.

Ejemplos

Ejemplo 1: Obtención de todos los alias en la sesión actual

PS C:\> Get-Alias

CommandType     Name
-----------     ----
Alias           % -> ForEach-Object
Alias           ? -> Where-Object
Alias           ac -> Add-Content
Alias           asnp -> Add-PSSnapin
Alias           cat -> Get-Content
Alias           cd -> Set-Location
Alias           chdir -> Set-Location
Alias           clc -> Clear-Content
Alias           clear -> Clear-Host
Alias           clhy -> Clear-History
...

Este comando obtiene todos los alias de la sesión actual.

La salida muestra el formato <alias> -> <definition> que se introdujo en Windows PowerShell 3.0. Este formato solo se usa para alias que no incluyen guiones, ya que los alias con guiones suelen ser nombres preferidos para cmdlets y funciones, en lugar de alias.

Ejemplo 2: Obtener alias por nombre

Get-Alias -Name gp*, sp* -Exclude *ps

Este comando obtiene todos los alias que comienzan con gp o sp, excepto los alias que terminan con ps.

Ejemplo 3: Obtención de alias para un cmdlet

Get-Alias -Definition Get-ChildItem

Este comando obtiene los alias del cmdlet Get-ChildItem.

De forma predeterminada, el cmdlet Get-Alias obtiene el nombre del elemento cuando conoce el alias. El parámetro Definition obtiene el alias cuando conoce el nombre del elemento.

Ejemplo 4: Obtener alias por propiedad

Get-Alias | Where-Object {$_.Options -Match "ReadOnly"}

Este comando obtiene todos los alias en los que el valor de la propiedad Options es ReadOnly. Este comando proporciona una manera rápida de encontrar los alias integrados en PowerShell, ya que tienen la opción ReadOnly.

Las opciones son solo una propiedad de los objetos AliasInfo que obtiene el Get-Alias. Para buscar todas las propiedades y métodos de objetos AliasInfo, escriba Get-Alias | get-member.

Ejemplo 5: Obtener alias por nombre y filtrar por letra inicial

Get-Alias -Definition "*-PSSession" -Exclude e* -Scope Global

En este ejemplo se obtienen alias para los comandos que tienen nombres que terminan en "-PSSession", excepto aquellos que comienzan por "e".

El comando usa el parámetro Scope para aplicar el comando en el ámbito global. Esto resulta útil en los scripts cuando desea obtener los alias en la sesión.

Parámetros

-Definition

Obtiene los alias del elemento especificado. Escriba el nombre de un cmdlet, una función, un script, un archivo o un archivo ejecutable.

Este parámetro se denomina Definición, porque busca el nombre del elemento en la propiedad Definition del objeto alias.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Exclude

Omite los elementos especificados. El valor de este parámetro califica los parámetros Name y Definition. Escriba un nombre, una definición o un patrón, como "s*". Se permiten caracteres comodín.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Name

Especifica los alias que obtiene este cmdlet. Se permiten caracteres comodín. De forma predeterminada, Get-Alias recupera todos los alias definidos para la sesión actual. El nombre del parámetro Nombre es opcional. También puede canalizar nombres de alias para Get-Alias.

Tipo:String[]
Posición:0
Valor predeterminado:All aliases
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

-Scope

Especifica el ámbito para el que este cmdlet obtiene alias. Los valores aceptables para este parámetro son:

  • Global
  • Local
  • Guión
  • 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).

Local es el valor predeterminado. Para obtener más información, consulte about_Scopes.

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 nombres de alias a Get-Alias.

Salidas

AliasInfo

Get-Alias devuelve un objeto que representa cada alias. Get-Alias devuelve el mismo objeto para cada alias, pero PowerShell usa un formato basado en flechas para mostrar los nombres de alias sin guiones.

Notas

  • Para crear un alias, use Set-Alias o New-Alias. Para eliminar un alias, use Remove-Item.
  • El formato de nombre de alias basado en flechas no se usa para alias que incluyen un guión. Es probable que se prefieran nombres sustitutos de cmdlets y funciones, en lugar de abreviaturas o alias típicos.