Compartir vía

Get-Alias

Módulo:
Microsoft.PowerShell.Utility Module

Obtiene los alias de la sesión actual.

Sintaxis

Default (Es el valor predeterminado). 

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

Definition 

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

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.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

Definition
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

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

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:None
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-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 Nombre es opcional. También puede canalizar nombres de alias para Get-Alias.

Propiedades del parámetro

Tipo:

String[]

Valor predeterminado:All aliases
Admite caracteres comodín:True
DontShow:False

Conjuntos de parámetros

Default
Posición:0
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-Scope

Especifica el ámbito para el que este cmdlet obtiene alias. 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).

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

Propiedades del parámetro

Tipo:String
Valor predeterminado:Local
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.

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

PowerShell incluye los siguientes alias para Get-Alias:

  • Todas las plataformas:

    • 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. Es probable que se prefieran nombres sustitutos de cmdlets y funciones, en lugar de abreviaturas o alias típicos.