Set-Alias

Set-Alias
    [-Name] <string>
    [-Value] <string>
    [-Description <string>]
    [-Option <ScopedItemOptions>]
    [-PassThru]
    [-Scope <string>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

El cmdlet Set-Alias crea o cambia un alias para un cmdlet o un comando, como una función, un script, un archivo u otro ejecutable. Un alias es un nombre alternativo que hace referencia a un cmdlet o comando. Por ejemplo, sal es el alias del cmdlet Set-Alias. Para más información, vea about_Aliases.

Un cmdlet puede tener varios alias, pero un alias solo se puede asociar a un cmdlet. Puede usar Set-Alias para reasignar un alias existente a otro cmdlet o cambiar las propiedades de un alias, como la descripción.

Un alias creado o cambiado por Set-Alias no es permanente y solo está disponible durante la sesión actual de PowerShell. Cuando se cierra la sesión de PowerShell, se quita el alias.

Este comando crea un alias en un cmdlet en la sesión actual de PowerShell.

PS> Set-Alias -Name list -Value Get-ChildItem

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

El cmdlet Set-Alias crea un alias en la sesión actual de PowerShell. El parámetro Name especifica el nombre del alias, list. El parámetro Value especifica el cmdlet que ejecuta el alias.

Para ejecutar el alias, escriba list en la línea de comandos de PowerShell.

Este comando reasigna un alias existente para ejecutar otro cmdlet.

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-ChildItem

PS> Set-Alias -Name list -Value Get-Location

PS> Get-Alias -Name list

CommandType     Name
-----------     ----
Alias           list -> Get-Location

El cmdlet Get-Alias usa el parámetro Name para mostrar el alias de list. El alias list está asociado al cmdlet Get-ChildItem. Cuando se ejecuta el alias de list, se muestran los elementos del directorio actual.

El cmdlet Set-Alias usa el parámetro Name para especificar el alias list. El parámetro Value asocia el alias al cmdlet Get-Location.

El cmdlet Get-Alias usa el parámetro Name para mostrar el alias de list. El alias list está asociado al cmdlet Get-Location. Cuando se ejecuta el alias de list, se muestra la ubicación del directorio actual.

Este comando crea un alias de solo lectura. La opción de solo lectura impide cambios no deseados en un alias. Para cambiar o eliminar un alias de solo lectura, use el parámetro Force.

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         :
Name                : loc
CommandType         : Alias

PS> Set-Alias -Name loc -Value Get-Location -Option ReadOnly -Description 'Displays the current directory' -Force -PassThru | Format-List -Property *

DisplayName         : loc -> Get-Location
Definition          : Get-Location
Options             : ReadOnly
Description         : Displays the current directory
Name                : loc
CommandType         : Alias

El cmdlet Set-Alias crea un alias en la sesión actual de PowerShell. El parámetro Name especifica el nombre del alias, loc. El parámetro Value especifica el cmdlet Get-Location que ejecuta el alias. El parámetro Option especifica el valor ReadOnly. El parámetro PassThru representa el objeto alias y envía el objeto a la canalización al cmdlet Format-List. Format-List utiliza el parámetro Property con un asterisco (*) para que se muestren todas las propiedades. La salida de ejemplo muestra una lista parcial de esas propiedades.

El alias loc se cambia con la adición de dos parámetros. Descripción agrega texto para explicar el propósito del alias. El parámetro Force es necesario porque el alias de loc es de solo lectura. Si no se utiliza el parámetro Fuerza , se produce un error en el cambio.

En este ejemplo se crea un alias en un archivo ejecutable en el equipo local.

PS> Set-Alias -Name np -Value C:\Windows\notepad.exe

PS> Get-Alias -Name np

CommandType     Name
-----------     ----
Alias           np -> notepad.exe

El cmdlet Set-Alias crea un alias en la sesión actual de PowerShell. El parámetro Name especifica el nombre del alias, np. El parámetro Value especifica la ruta de acceso y el nombre de la aplicaciónC:\Windows\notepad.exe. El Get-Alias cmdlet usa el parámetro Name para mostrar que el np alias está asociado a notepad.exe.

Para ejecutar el alias, escriba np en la línea de comandos de PowerShell para abrir notepad.exe.

En este ejemplo se muestra cómo asignar un alias a un comando con parámetros.

Puede crear un alias para un cmdlet, como Set-Location. No se puede crear un alias para un comando con parámetros y valores, como Set-Location -Path C:\Windows\System32. Para crear un alias para un comando, cree una función que incluya el comando y, a continuación, cree un alias para la función. Para obtener más información, vea about_Functions.

PS> Function CD32 {Set-Location -Path C:\Windows\System32}

PS> Set-Alias -Name Go -Value CD32

Se crea una función denominada CD32. La función usa el Set-Location cmdlet con el parámetro Path para especificar el directorio, C:\Windows\System32.

El cmdlet Set-Alias crea un alias para la función en la sesión actual de PowerShell. El parámetro Name especifica el nombre del alias, Go. El parámetro Value especifica el nombre de la función, CD32.

Para ejecutar el alias, escriba Go en la línea de comandos de PowerShell. La CD32 función se ejecuta y cambia en el directorio C:\Windows\System32.

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.

Set-Alias No acepta entradas de la canalización.

Cuando se utiliza el parámetro PassThru , Set-Alias se genera un objeto System.Management.Automation.AliasInfo que representa el alias. De lo contrario, Set-Alias no genera ninguna salida.

PowerShell incluye alias integrados que están disponibles en cada sesión de PowerShell. El cmdlet Get-Alias muestra los alias disponibles en una sesión de PowerShell.

Para crear un alias, use Set-Alias o New-Alias. Para quitar un alias, use el cmdlet Remove-Item. Por ejemplo: Remove-Item -Path Alias:aliasname.

Para crear un alias que esté disponible en cada sesión de PowerShell, agréguelo al perfil de PowerShell. Para obtener más información, vea about_Profiles.

Un alias se puede guardar y reutilizar en otra sesión de PowerShell mediante una exportación e importación. Para guardar un alias en un archivo, use Export-Alias. Para agregar un alias guardado a una nueva sesión de PowerShell, use Import-Alias.