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 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 es 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.

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 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á 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. 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.

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 ningún resultado.

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 admiten caracteres comodín, pero se deben resolver 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 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 (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, consulte 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 se ejecutara el cmdlet. 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