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