Compartir a través de

New-Alias

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Crea un nuevo alias.

Sintaxis

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

Description

El cmdlet New-Alias 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 cmdlet Export-Alias 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

PS C:\> 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

PS C:\> New-Alias -Name "W" -Value Get-WmiObject -Description "quick wmi alias" -Option ReadOnly
PS C:\> Get-Alias -Name "W" | Format-List *

Este comando crea un alias denominado W para representar el cmdlet Get-WmiObject. 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 pide 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. Puede escribir cualquier cadena. Si la descripción incluye espacios, escríbalo 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. 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 Options propiedad del alias. Los valores válidos son:

  • Ninguno: el alias no tiene restricciones (valor predeterminado)
  • ReadOnly: el alias se puede eliminar, pero no se puede cambiar, excepto mediante el parámetro Force
  • Constante: el alias no se puede eliminar ni cambiar.
  • Privado: el alias solo está disponible en el ámbito actual.
  • AllScope: el alias se copia en cualquier ámbito nuevo que se cree.
  • Sin especificar: no se especifica la opción

Para ver la propiedad Opciones de de todos los alias de la sesión, escriba .

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 ninguna salida.

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 aceptables para este parámetro son:

  • Global
  • Local
  • Guión
  • 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 que se está aliasando.

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 el cmdlet se ejecuta. 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 puede canalizar la entrada a este cmdlet.

Salidas

None or System.Management.Automation.AliasInfo

Cuando se usa el parámetro Passthru, New-Alias genera un objeto System.Management.Automation.AliasInfo que representa el nuevo alias. De lo contrario, este cmdlet no genera ninguna salida.

Notas

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