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.