Import-Alias

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Importa uma lista de alias de um arquivo.

Syntax

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

Description

O Import-Alias cmdlet importa uma lista de alias de um arquivo.

A partir do Windows PowerShell 3.0, como um recurso de segurança, Import-Alias não substitui aliases existentes por padrão. Para substituir um alias existente, depois de garantir que o conteúdo do arquivo de alias é seguro, use o parâmetro Force .

Exemplos

Exemplo 1: Importar aliases de um arquivo

Import-Alias test.txt

Este comando importa informações de alias de um arquivo chamado test.txt.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Permite que o cmdlet importe um alias que já está definido ou é somente leitura. Você pode usar o seguinte comando para exibir informações sobre os aliases definidos no momento:

Get-Alias | Select-Object Name, Options

Se o alias correspondente for somente leitura, ele será exibido no valor da propriedade Options .

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Especifica o caminho para um arquivo que inclui informações do alias exportado. Ao contrário do parâmetro Path , o valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Type:String
Aliases:PSPath
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Retorna um objeto que representa o item com que você está trabalhando. Por padrão, este cmdlet não gera saída.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Especifica o caminho para um arquivo que inclui informações do alias exportado. Caracteres curinga são permitidos, mas eles devem ser resolvidos para um único nome.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Scope

Especifica o escopo no qual os aliases são importados. Os valores aceitáveis para esse parâmetro são:

  • Global
  • Local
  • Script
  • Um número relativo ao escopo atual (0 até o número de escopos, onde 0 é o escopo atual e 1 é seu pai)

O padrão é Local. Para obter mais informações, consulte about_Scopes.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém um caminho para esse cmdlet.

Saídas

None

Por padrão, esse cmdlet não retorna nenhuma saída.

AliasInfo

Quando você usa o parâmetro PassThru , esse cmdlet retorna um objeto AliasInfo que representa o alias.

Observações

O Windows PowerShell inclui os seguintes aliases para Import-Alias:

  • ipal