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 a 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 já definido ou somente leitura. Você pode usar o seguinte comando para exibir informações sobre os aliases definidos atualmente:

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 de alias exportadas. Ao contrário do parâmetro Path , o valor do parâmetro LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como 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, LP
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Retorna um objeto que representa o item com o qual você está trabalhando. Por padrão, esse cmdlet não gera nenhuma 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 de alias exportadas. Curingas são permitidos, mas eles devem resolver 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 para o qual os aliases são importados. Os valores aceitáveis para este parâmetro são:

  • Global
  • Local
  • Script
  • Um número relativo ao escopo atual (0 através do 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

Apresenta o que aconteceria mediante a execução do cmdlet. 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 contenha 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.

Notas

O PowerShell inclui os seguintes aliases para Import-Alias:

  • Todas as plataformas:
    • ipal