Crea un nuevo alias.

Sintaxis

New-Alias [-Name] <string> [-Value] <string> [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

Descripción

El cmdlet New-Alias crea un nuevo alias en la actual sesión de Windows PowerShell. Los alias que se crean mediante New-Alias no se guardan cuando se cierra la sesión o Windows PowerShell. Puede usar el cmdlet Export-Alias para guardar la información de los alias en un archivo. Después, puede usar Import-Alias para recuperar esta información.

Parámetros

-Description <string>

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

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Force

Cuando se define, actúa como Set-Alias si el alias especificado ya existe.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Name <string>

Especifica el nuevo alias. Pueden usarse caracteres alfanuméricos en los alias, pero el primer carácter no puede ser un número.

¿Requerido?

true

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-Option <ScopedItemOptions>

Define una o varias propiedades opcionales del alias. Los valores válidos son:

-- None: no establece opciones. (Valor predeterminado.)

-- ReadOnly: no se puede modificar el alias a menos que se use el parámetro Force.

-- Constant: no se puede modificar el alias, ni siquiera mediante el parámetro Force.

-- Private: el alias solo está disponible en el ámbito especificado por el parámetro Scope. En los demás ámbitos, el alias no está visible.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-PassThru

Devuelve un objeto que representa el nuevo alias. De forma predeterminada, este cmdlet no genera resultados.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Scope <string>

Especifica el ámbito del nuevo alias. Los valores válidos son "Global", "Local", "Script" o el número correspondiente al ámbito actual (entre 0 y el número de ámbitos, donde 0 es el ámbito actual y 1 su ámbito principal). "Local" es el valor predeterminado. Para obtener más información, vea about_Scopes.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Value <string>

Especifica el nombre del elemento de cmdlet o comando al que se asigna un alias.

¿Requerido?

true

¿Posición?

2

Valor predeterminado

¿Aceptar canalización?

true (ByPropertyName)

¿Aceptar caracteres comodín?

false

-Confirm

Solicita confirmación antes de ejecutar el comando.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-WhatIf

Describe lo que ocurriría si ejecutara el comando sin ejecutarlo realmente.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

Ninguno

No se pueden canalizar entradas a este cmdlet.

Salidas

Ninguno o 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. En caso contrario, este cmdlet no genera resultados.

Notas

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

Ejemplo 1

C:\PS>new-alias list get-childitem

Descripción
-----------
Este comando crea un alias denominado "list" para representar el cmdlet Get-ChildItem.






Ejemplo 2

C:\PS>new-alias -name w -value get-wmiobject -description "quick wmi alias" -option ReadOnly

C:\PS> get-alias -name w | format-list *

Descripción
-----------
Este comando crea un alias denominado "w" para representar el cmdlet Get-WMIObject. Crea una descripción, "quick wmi alias", para el alias de sólo lectura. La última línea del comando usa Get-Alias para obtener el nuevo alias y lo canaliza a Format-List para mostrar toda la información sobre él.






Vea también




Tabla de contenido