Proveedor de alias
Se aplica a: Windows PowerShell 4.0, Windows PowerShell 5.0
NOMBRE DEL PROVEEDOR
Alias
UNIDADES
Alias:
DESCRIPCIÓN BREVE
Proporciona acceso a los alias de Windows PowerShell y los valores que representan.
DESCRIPCIÓN DETALLADA
El proveedor de alias de Windows PowerShell permite obtener, agregar, cambiar, borrar y eliminar alias en Windows PowerShell.
Un alias es un nombre alternativo para un cmdlet, una función o un archivo ejecutable. Windows PowerShell incluye un conjunto de alias integrados. También puede agregar sus propios alias a la sesión actual y a su perfil de Windows PowerShell.
El proveedor de alias es un espacio de nombres sin formato que solo contiene los objetos de alias. Los alias no tienen elementos secundarios.
Cada alias es una instancia de la clase System.Management.Automation.AliasInfo.
El proveedor de alias expone su almacén de datos en la unidad Alias:. Para trabajar con alias, puede cambiar la ubicación a la unidad Alias: mediante el comando siguiente:
set-location alias:
También puede trabajar desde otra unidad de Windows PowerShell. Para hacer referencia a un alias desde otra ubicación, utilice el nombre de la unidad Alias: en la ruta de acceso.
Windows PowerShell incluye un conjunto de cmdlets diseñados para ver y cambiar alias:
Export-Alias
Get-Alias
Import-Alias
New-Alias
Set-Alias
Al usar estos cmdlets, no es necesario especificar la unidad Alias: el nombre.
El proveedor de alias es compatible con todos los cmdlets que contienen el nombre Item, excepto el cmdlet Invoke-Item. Además, es compatible con los cmdlets Get-Content y Set-Content. El proveedor de alias no es compatible con los cmdlets que contienen el nombre ItemProperty. Además, el proveedor de Alias no admite el parámetro Filter en ningún cmdlet.
Todos los cambios en los alias afectan únicamente a la sesión actual. Para guardar los cambios, agréguelos al perfil de Windows PowerShell. También puede usar los cmdlets Export-Alias e Import-Alias.
FUNCIONALIDADES
ShouldProcess
EJEMPLOS
Acceder a la unidad Alias:
-------------------------- EJEMPLO 1 --------------------------
Este comando cambia la ubicación actual a la unidad Alias:. Puede utilizar este comando desde cualquier unidad de Windows PowerShell. Para volver a una unidad del sistema de archivos, escriba el nombre de la unidad. Por ejemplo, escriba "set-location c:".
set-location alias:
Obtener alias
-------------------------- EJEMPLO 1 --------------------------
Este comando obtiene una lista de todos los alias en la sesión actual. Puede utilizar este comando en cualquier unidad de Windows PowerShell.
get-item -path alias:
-------------------------- EJEMPLO 2 --------------------------
Este comando obtiene el alias "ls". Dado que incluye la ruta de acceso, puede usarlo en cualquier unidad de Windows PowerShell.
get-item -path alias:ls
Si se encuentra en la unidad Alias:, puede omitir el nombre de unidad en la ruta de acceso.
-------------------------- EJEMPLO 3 --------------------------
Este comando obtiene una lista de los alias que están asociados al cmdlet Get-ChildItem. Utiliza la propiedad Definition, que almacena el nombre del cmdlet.
get-item -path alias:* | where-object {$_.Definition -eq "Get-Childitem"}
Cuando el elemento con alias es un archivo ejecutable, la definición contiene la ruta de acceso completa del archivo.
-------------------------- EJEMPLO 4 --------------------------
Este comando obtiene la lista de todos los alias cuando la ubicación actual es la unidad Alias:. El carácter comodín (*) se utiliza para indicar todo el contenido de la ubicación actual.
get-item -path *
En la unidad Alias:, tienen el mismo efecto un punto (.), que representa la ubicación actual, y un carácter comodín (*), que representa todos los elementos de la ubicación actual. Por ejemplo, "get-item -path ." o "get-item *" generan el mismo resultado.
Crear un nuevo alias
-------------------------- EJEMPLO 1 --------------------------
Este comando crea el alias "serv" para el cmdlet Get-Service. Dado que la ubicación actual se encuentra en la unidad Alias:, el valor del parámetro Path es un punto (.). El punto representa la ubicación actual.
Este comando también utiliza el parámetro dinámico Options para establecer las opciones AllScope y Constant en el alias. El parámetro Options está disponible en el cmdlet New-Item solo si se encuentra en la unidad Alias:.
new-item -path . -name serv -value Get-Service -Options "AllScope,Constant"
Si se encuentra en la unidad Alias:, puede omitir el nombre de unidad en la ruta de acceso.
-------------------------- EJEMPLO 2 --------------------------
Puede crear un alias para cualquier elemento que invoque un comando. Este comando crea el alias "np" para Notepad.exe.
new-item -path alias:np -value c:\windows\notepad.exe
-------------------------- EJEMPLO 3 --------------------------
Puede crear un alias para cualquier función. Puede utilizar esta característica para crear un alias que incluya un cmdlet y sus parámetros.
El primer comando crea la función CD32, que cambia el directorio actual al directorio System32. El segundo comando crea el alias "go" para la función CD32. El punto y coma (;) es el separador de comandos.
Cuando finalice el comando, puede utilizar "CD32" o "Ir" para invocar la función.
function CD32 {set-location -path c:\windows\system32} set-item -path alias:go -value CD32
Mostrar las propiedades y los métodos de los alias
-------------------------- EJEMPLO 1 --------------------------
Este comando usa el cmdlet Get-Item para obtener todos los alias. El operador de canalización (|) envía los resultados al cmdlet Get-Member, que muestra los métodos y las propiedades del objeto.
get-item -path alias:* | get-member
Cuando canaliza una colección de objetos a Get-Member, como la colección de alias de la unidad Alias:, Get-Member evalúa cada objeto de la colección por separado. A continuación, Get-Member devuelve información sobre cada tipo de objeto que encuentra. Si todos los objetos son del mismo tipo, devuelve información sobre ese único tipo de objeto. En este caso, todos los alias son objetos AliasInfo. Para obtener información acerca de la colección de objetos AliasInfo, use el parámetro InputObject de Get-Member. Por ejemplo, use el comando siguiente: Get-Member -InputObject (Get-Item alias:*) Cuando utiliza InputObject, Get-Member evalúa la colección, no los objetos de la colección.
-------------------------- EJEMPLO 2 --------------------------
Este comando muestra los valores de las propiedades del alias "dir". Utiliza el cmdlet Get-Item para obtener un objeto que representa el alias "dir". El operador de canalización (|) envía los resultados al comando Format-List. El comando Format-List utiliza el parámetro Property con un carácter comodín (*) para dar formato y mostrar los valores de todas las propiedades del alias "dir".
get-item alias:dir | format-list -property *
Cambiar las propiedades de un alias
-------------------------- EJEMPLO 1 --------------------------
Puede usar el cmdlet Set-Item con el parámetro dinámico Options para cambiar el valor de la propiedad Options de un alias.
Este comando establece las opciones AllScope y ReadOnly para el alias "dir". El comando utiliza el parámetro dinámico Options del cmdlet Set-Item. El parámetro Options está disponible en Set-Item solo cuando se usa con el proveedor de Alias o Function.
set-item -path alias:dir -options "AllScope,ReadOnly"
-------------------------- EJEMPLO 2 --------------------------
Este comando usa el cmdlet Set-Item para cambiar alias "gp" para que represente el cmdlet Get-Process en lugar del cmdlet Get-ItemProperty. El parámetro Force es necesario porque el valor de la propiedad Options del alias "gp" está establecida en ReadOnly. Dado que el comando se envía desde la unidad Alias:, no se especifica la unidad en la ruta de acceso.
set-item -path gp -value get-process -force
El cambio afecta a las cuatro propiedades que definen la asociación entre el alias y el comando. Para ver el efecto del cambio, escriba el siguiente comando: get-item -path gp | format-list -property *
-------------------------- EJEMPLO 3 --------------------------
Este comando usa el cmdlet Rename-Item para cambiar el alias "popd" a "pop".
rename-item -path alias:popd -newname pop
Copiar un alias
-------------------------- EJEMPLO 1 --------------------------
Este comando copia el alias pushd para que se cree un nuevo alias de inserción para el cmdlet Push-Location.
copy-item -path alias:pushd -destination alias:push
Cuando se crea el nuevo alias, su propiedad Description tiene un valor null. Asimismo, su propiedad Option tiene un valor None. Si el comando se emite desde la unidad Alias:, puede omitir el nombre de la unidad en el valor del parámetro Path.
Eliminar un alias
-------------------------- EJEMPLO 1 --------------------------
Este comando elimina el alias "serv" de la sesión actual. Puede utilizar este comando en cualquier unidad de Windows PowerShell.
remove-item -path alias:serv
Si se encuentra en la unidad Alias:, puede omitir el nombre de unidad en la ruta de acceso.
-------------------------- EJEMPLO 2 --------------------------
Este comando elimina los alias que comienzan con "s". No se eliminan los alias de solo lectura.
clear-item -path alias:s*
-------------------------- EJEMPLO 3 --------------------------
Este comando elimina todos los alias de la sesión actual, excepto los que tienen un valor Constant para su propiedad Options. Sin el parámetro Force, el comando no elimina los alias cuya propiedad Options tenga un valor ReadOnly.
remove-item alias:* -force
PARÁMETROS DINÁMICOS
Los parámetros dinámicos son parámetros de cmdlet agregados por un proveedor de Windows PowerShell que solo están disponibles cuando se utiliza el cmdlet en la unidad habilitada por el proveedor.
Options <System.Management.Automation.ScopedItemOptions>
Determina el valor de la propiedad Options de un alias.
| Valor | Descripción |
|---|---|
Ninguno |
No hay opciones. Este es el valor predeterminado. |
Constant |
No se puede eliminar el alias y no se pueden cambiar sus propiedades. Constant solo está disponible cuando se crea un alias. No puede cambiar a Constant la opción de un alias existente. |
Private |
El alias solo está visible en el ámbito actual, no en los ámbitos secundarios. |
ReadOnly |
No se pueden cambiar las propiedades del alias a menos que se use el parámetro Force. Puede usar Remove-Item para eliminar el alias. |
AllScope |
El alias se copia en todos los nuevos ámbitos que se creen. |