Get-Alias
Obtiene los alias de la sesión actual.
Sintaxis
Get-Alias [[-Name] <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]
Get-Alias [-Definition <string[]>] [-Exclude <string[]>] [-Scope <string>] [<CommonParameters>]
Descripción
El cmdlet Get-Alias obtiene los alias (nombres alternativos para los comandos y archivos ejecutables) de la sesión actual. Este conjunto incluye los alias integrados, los alias importados o definidos por el usuario y los alias que se han agregado al perfil de Windows PowerShell.
De forma predeterminada, Get-Alias toma un alias y devuelve el nombre de comando. Cuando se usa el parámetro Definition, Get-Alias toma un nombre de comando y devuelve sus alias.
Parámetros
-Definition <string[]>
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 Definition porque busca el nombre de elemento en la propiedad Definition del objeto de alias.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
true |
-Exclude <string[]>
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 permite el uso de caracteres comodín.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Name <string[]>
Especifica los alias que se van a recuperar. Se permite el uso de caracteres comodín. De manera 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 los nombres de alias a Get-Alias.
¿Requerido? |
false |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Scope <string>
Obtiene solo los alias del ámbito especificado. Los valores válidos son "Global", "Local", "Script" o el número correspondiente al ámbito actual (entre 0 y el número de ámbitos, donde 0 es el ámbito actual y 1 su ámbito principal). "Local" es el valor predeterminado. Para obtener más información, vea about_Scopes.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
System.String Puede canalizar los nombres de alias a Get-Alias. |
Salidas |
System.Management.Automation.AliasInfo Get-Alias devuelve un objeto que representa cada alias. |
Notas
Un alias es un nombre alternativo o sobrenombre de un cmdlet, una función o un archivo ejecutable. Para ejecutar el cmdlet, la función o el archivo ejecutable, puede usarse su nombre completo o su alias. Para obtener más información, vea about_Aliases.
Para crear un nuevo alias, use Set-Alias o New-Alias. Para eliminar un alias, use Remove-Item.
Ejemplo 1
C:\PS>get-alias
Descripción
-----------
Este comando obtiene todos los alias de la sesión actual.
Ejemplo 2
C:\PS>get-alias -name g*, s* -exclude get-*
Descripción
-----------
Este comando obtiene todos los alias que comienzan con "g" o "s", salvo los alias que comienzan con "get-".
Ejemplo 3
C:\PS>get-alias -definition Get-ChildItem
Descripción
-----------
Este comando obtiene los alias del cmdlet Get-ChildItem.
De forma predeterminada, el cmdlet Get-Alias obtiene el nombre de elemento cuando se conoce el alias. El parámetro Definition obtiene el alias cuando se conoce el nombre de elemento.
Ejemplo 4
C:\PS>get-alias | where-object {$_.Options -match "ReadOnly"}
Descripción
-----------
Este comando recupera todos los alias en los que el valor de la propiedad Options es ReadOnly. Este comando constituye un método rápido para buscar los alias integrados en Windows PowerShell, ya que tienen la opción ReadOnly.
Options es solo una de las propiedades de los objetos AliasInfo que Get-Alias recupera. Para obtener todos los métodos y propiedades de los objetos AliasInfo, escriba "get-alias | get-member".
Ejemplo 5
C:\PS>get-alias -definition "*-pssession" -exclude e* -scope global
Descripción
-----------
En este ejemplo se obtienen los alias de los comandos cuyo nombre termina con "- pssession", menos de los comandos cuyo nombre comienza con "e".
El comando utiliza el parámetro Scope para aplicar el comando en el ámbito global. Esto es útil en los scripts cuando se desean obtener los alias de la sesión.
Vea también
Conceptos
about_Aliases
Set-Alias
New-Alias
Export-Alias
Import-Alias
Alias Provider