Import-Alias

Referencia

Módulo:: Microsoft.PowerShell.Utility

Importa una lista de alias de un archivo.

Sintaxis

Import-Alias
      [-Path] <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Import-Alias
      -LiteralPath <String>
      [-Scope <String>]
      [-PassThru]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

El cmdlet Import-Alias 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 es seguro, use el parámetro Force.

Ejemplos

Ejemplo 1: Importación de alias desde un archivo

Import-Alias test.txt

Este comando importa información de alias de un archivo denominado test.txt.

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

-Force

Permite al cmdlet importar un alias que ya está definido o que es de solo lectura. 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á en el valor de la propiedad Options.

Tipo:	SwitchParameter
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
Aceptar caracteres comodín:	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 como se escribe. No se interpreta ningún carácter como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Tipo:	String
Alias:	PSPath, LP
Posición:	Named
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
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

-Path

Especifica la ruta de acceso a un archivo que incluye información de alias exportada. Se permiten caracteres comodín, pero deben resolverse en un solo nombre.

Tipo:	String
Posición:	0
Valor predeterminado:	None
Requerido:	True
Aceptar entrada de canalización:	True
Aceptar caracteres comodín:	True

-Scope

Especifica el ámbito en el que se importan los 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).

El valor predeterminado es Local. Para obtener más información, vea about_Scopes.

Tipo:	String
Posición:	Named
Valor predeterminado:	None
Requerido:	False
Aceptar entrada de canalización:	False
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

String

Puede canalizar una cadena que contenga una ruta de acceso 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 alias.

Notas

PowerShell incluye los siguientes alias para Import-Alias:

Todas las plataformas:
- ipal