Compartir a través de

New-Alias

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Crea un alias.

Sintaxis

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

Description

El New-Alias cmdlet crea un nuevo alias en la sesión actual de PowerShell. Los alias creados mediante New-Alias no se guardan después de salir de la sesión o cerrar PowerShell. Puede usar el Export-Alias cmdlet para guardar la información de alias en un archivo. Más adelante puede usar Import-Alias para recuperar esa información de alias guardada.

Ejemplos

Ejemplo 1: Creación de un alias para un cmdlet

New-Alias -Name "List" Get-ChildItem

Este comando crea un alias denominado List para representar el cmdlet Get-ChildItem.

Ejemplo 2: Creación de un alias de solo lectura para un cmdlet

Este comando crea un alias denominado C para representar el Get-ChildItem cmdlet. Crea una descripción de "alias de gci rápido" para el alias y lo convierte en de solo lectura.

New-Alias -Name "C" -Value Get-ChildItem -Description "quick gci alias" -Option ReadOnly
Get-Alias -Name "C" | Format-List *

HelpUri             : https://go.microsoft.com/fwlink/?LinkID=2096492
ResolvedCommandName : Get-ChildItem
DisplayName         : C -> Get-ChildItem
ReferencedCommand   : Get-ChildItem
ResolvedCommand     : Get-ChildItem
Definition          : Get-ChildItem
Options             : ReadOnly
Description         : quick gci alias
OutputType          : {System.IO.FileInfo, System.IO.DirectoryInfo}
Name                : C
CommandType         : Alias
Source              :
Version             :
Visibility          : Public
ModuleName          :
Module              :
RemotingCapability  : PowerShell
Parameters          : {[Path, System.Management.Automation.ParameterMetadata], [LiteralPath,
                      System.Management.Automation.ParameterMetadata], [Filter,
                      System.Management.Automation.ParameterMetadata], [Include,
                      System.Management.Automation.ParameterMetadata]…}

El Get-Alias comando canaliza para Format-List mostrar toda la información sobre el nuevo alias.

Ejemplo 3: Creación de un alias para un comando con parámetros

function Set-ParentDirectory {Set-Location -Path ..}
New-Alias -Name .. -Value Set-ParentDirectory

El primer comando crea la función Set-ParentDirectory, que usa Set-Location para establecer la ubicación de trabajo en el directorio primario. El segundo comando usa New-Alias para crear un alias de .. para llamar a la Set-ParentDirectory función . Dado que el parámetro Value requiere un cmdlet, una función o un valor ejecutable, debe crear una función personalizada para crear un alias que use parámetros. Al ejecutar el alias .. , se cambia la ubicación actual al directorio primario.

Parámetros

-Confirm

Le solicita su confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Description

Especifica una descripción del alias. Se puede escribir cualquier cadena. Si la descripción tiene espacios, escríbala entre comillas.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Force

Indica que el cmdlet actúa como Set-Alias si el alias denominado ya existe.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nuevo alias. Se puede usar cualquier carácter alfanumérico en un alias, pero el primer carácter no puede ser un número.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Option

Especifica el valor de la propiedad Options del alias. Los valores válidos son:

  • None: el alias no tiene restricciones (valor predeterminado)
  • ReadOnly: el alias se puede eliminar, pero no se puede cambiar excepto mediante el parámetro Force .
  • Constant: el alias no se puede eliminar ni cambiar.
  • Private: el alias solo está disponible en el ámbito actual.
  • AllScope: el alias se copia en todos los ámbitos nuevos que se crean.
  • Unspecified: no se especifica la opción .

Estos valores se definen como una enumeración basada en marcas. Puede combinar varios valores para establecer varias marcas mediante este parámetro. Los valores se pueden pasar al parámetro Option como una matriz de valores o como una cadena separada por comas de esos valores. El cmdlet combinará los valores mediante una operación binary-OR. Pasar valores como una matriz es la opción más sencilla y también permite usar la finalización de tabulación en los valores.

Para ver la propiedad Options de todos los alias de la sesión, escriba Get-Alias | Format-Table -Property Name, Options -AutoSize.

Tipo:ScopedItemOptions
Valores aceptados:None, ReadOnly, Constant, Private, AllScope, Unspecified
Posición:Named
Valor predeterminado:[System.Management.Automation.ScopedItemOptions]::None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PassThru

Devuelve un objeto que representa el elemento con el que está trabajando. De forma predeterminada, este cmdlet no genera ningún resultado.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Scope

Especifica el ámbito del nuevo 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:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Value

Especifica el nombre del cmdlet o elemento de comando para el que se crea el alias.

Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

None

De forma predeterminada, este cmdlet no devuelve ninguna salida.

AliasInfo

Cuando se usa el parámetro PassThru , este cmdlet devuelve un objeto AliasInfo que representa el nuevo alias.

Notas

PowerShell incluye los siguientes alias para New-Alias:

  • Todas las plataformas:

    • nal

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