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 Get-Alias cmdlet 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. Cuando se usa 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 <alias> -> <definition> formato para que sea aún más fácil encontrar la información que necesita.

Ejemplos

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

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 en la sesión actual.

La salida muestra el <alias> -> <definition> formato que se introdujo en Windows PowerShell 3.0. Este formato se usa solo para los alias que no incluyen guiones, ya que los alias con guiones son nombres que se suelen usar más bien en cmdlets y funciones, y no en 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 Get-ChildItem cmdlet .

De forma predeterminada, el Get-Alias cmdlet 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 Get-Alias obtiene. 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

Este ejemplo obtiene los alias de los comandos que tienen nombres que acaban en "-PSSession", excepto aquellos que comienzan por "e".

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

Parámetros

-Definition

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

Este parámetro se denomina Definition, ya que 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 los 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 los caracteres comodín. De forma predeterminada, Get-Alias recupera todos los alias definidos para la sesión actual. El nombre del parámetro Name es opcional. También puede canalizar nombres de alias a 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 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).

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 una cadena que contenga un nombre de alias a este cmdlet.

Salidas

AliasInfo

Este cmdlet devuelve un objeto que representa cada alias. Devuelve el mismo tipo de objeto para cada alias, pero PowerShell usa un formato basado en flechas para mostrar los nombres de alias sin guiones.

Notas

Windows PowerShell incluye los siguientes alias para Get-Alias:

  • gal

  • Para crear un alias, use Set-Alias o New-Alias. Para eliminar un alias, use Remove-Item.

  • El formato de flecha de nombre de alias no se usa en los alias que llevan guion. Los alias con guion suelen ser nombres de sustitución usados más bien en cmdlets y funciones, y no en abreviaturas típicas o alias.