Import-Alias
Importa una lista de alias de un archivo.
Syntax
Import-Alias
[-Path] <String>
[-Scope <String>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Import-Alias
-LiteralPath <String>
[-Scope <String>]
[-PassThru]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El Import-Alias
cmdlet importa una lista de alias de un archivo.
A partir de Windows PowerShell 3.0, como característica de seguridad, Import-Alias
no sobrescribe los alias existentes de forma predeterminada.
Para sobrescribir un alias existente, después de asegurarse de que el contenido del archivo de alias esté seguro, use el parámetro Force.
Ejemplos
Ejemplo 1: Importación de alias desde un archivo
Import-Alias test.txt
Este comando importa la información de alias desde un archivo llamado test.txt.
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 |
-Force
Permite que el cmdlet importe un alias ya definido o de solo lectura. Se puede usar el siguiente comando para mostrar información sobre los alias definidos actualmente:
Get-Alias | Select-Object Name, Options
Si el alias correspondiente es de solo lectura, se mostrará el valor de la propiedad Options.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LiteralPath
Especifica la ruta de acceso a un archivo que incluye información de alias exportada. A diferencia del parámetro Path, el valor del parámetro LiteralPath se usa exactamente tal y como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.
Type: | String |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
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 |
-Path
Especifica la ruta de acceso a un archivo que incluye información de alias exportada. Se admiten caracteres comodín, pero se deben resolver en un solo nombre.
Type: | String |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Scope
Especifica el ámbito al que se importan los alias. Los valores permitidos para este parámetro son los siguientes:
- Global
- Local
- Script
- Número relativo al ámbito actual (0 al número de ámbitos, donde 0 es el ámbito actual y 1 es su elemento primario).
El valor predeterminado es Local. 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 |
-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
Puede canalizar una cadena que contenga una ruta de acceso a este cmdlet.
Salidas
None
De forma predeterminada, este cmdlet no devuelve ninguna salida.
Cuando se usa el parámetro PassThru , este cmdlet devuelve un objeto AliasInfo que representa el alias.
Notas
PowerShell incluye los siguientes alias para Import-Alias
:
- Todas las plataformas:
ipal