Compartilhar via


Import-Alias

Importa uma lista de alias de um arquivo.

Sintaxe

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

Descrição

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

Parâmetros

-Force

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

get-alias | Select-Object name,Options

O valor da propriedade Options incluirá "ReadOnly" se o alias correspondente for somente leitura.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-PassThru

Retorna um objeto que representa o alias. Por padrão, este cmdlet não gera nenhuma saída.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Path <string>

Especifica o caminho para um arquivo que inclui as informações exportadas do alias. Caracteres curinga são permitidos, mas eles devem resultar em um único nome.

Necessário?

true

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByValue, ByPropertyName)

Aceitar caracteres curinga?

false

-Scope <string>

Especifica o escopo para o qual os aliases são importados. Os valores válidos são "Global", "Local" ou "Script" ou um número relativo ao atual escopo (0 ao número de escopos, onde 0 é o escopo atual e 1 é seu pai). "Local" é o padrão. Para obter mais informações, consulte about_Scopes.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-Confirm

Solicita confirmação antes da execução do comando.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

-WhatIf

Descreve o que aconteceria se você executasse o comando, sem executá-lo de fato.

Necessário?

false

Posição?

named

Valor padrão

Aceitar entrada do pipeline?

false

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.String

Você pode canalizar uma cadeia de caracteres que contém um caminho para Import-Alias.

Saídas

Nenhum ou System.Management.Automation.AliasInfo

Quando você usa o parâmetro Passthru, Import-Alias retorna um objeto System.Management.Automation.AliasInfo que representa o alias. Caso contrário, esse cmdlet não gera nenhuma saída.

Exemplo 1

C:\PS>import-alias test.txt

Descrição
-----------
Esse comando importa informações sobre o alias de um arquivo denominado test.txt.





Consulte também

Conceitos

Export-Alias
Get-Alias
New-Alias
Set-Alias