Share via

New-Alias

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Crea un alias.

Syntax

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 Windows PowerShell. Los alias creados mediante New-Alias no se guardan después de salir de la sesión o cerrar Windows 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

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

Este comando crea un alias denominado C para representar el Get-ChildItem cmdlet. Crea una descripción, alias wmi rápido, para el alias y lo convierte en de solo lectura. La última línea del comando usa Get-Alias para obtener el nuevo alias y canaliza a Format-List para mostrar toda la información sobre él.

Parámetros

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Description

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:ScopedItemOptions
Accepted values:None, ReadOnly, Constant, Private, AllScope, Unspecified
Position:Named
Default value:[System.Management.Automation.ScopedItemOptions]::None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

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

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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

Windows PowerShell incluye los siguientes alias para New-Alias:

  • nal

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