Export-Alias
Exporta informações sobre aliases definidos no momento para um arquivo.
Sintaxe
ByPath (Default)
Export-Alias
[-Path] <String>
[[-Name] <String[]>]
[-PassThru]
[-As <ExportAliasFormat>]
[-Append]
[-Force]
[-NoClobber]
[-Description <String>]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
ByLiteralPath
Export-Alias
[[-Name] <String[]>]
-LiteralPath <String>
[-PassThru]
[-As <ExportAliasFormat>]
[-Append]
[-Force]
[-NoClobber]
[-Description <String>]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
O cmdlet Export-Alias exporta os aliases na sessão atual para um arquivo.
Se o arquivo de saída não existir, o cmdlet o criará.
Export-Alias pode exportar os aliases em um escopo específico ou em todos os escopos, ele pode gerar os dados no formato CSV ou como uma série de comandos Set-Alias que você pode adicionar a uma sessão ou a um perfil do PowerShell.
Exemplos
Exemplo 1: Exportar um alias
Export-Alias -Path "alias.csv"
Esse comando exporta informações de alias atuais para um arquivo chamado Alias.csv no diretório atual.
Exemplo 2: Exportar um alias, a menos que o arquivo de exportação já exista
Export-Alias -Path "alias.csv" -NoClobber
Esse comando exporta os aliases na sessão atual para um arquivo Alias.csv.
Como o parâmetro NoClobber é especificado, o comando falhará se já existir um arquivo Alias.csv no diretório atual.
Exemplo 3: acrescentar aliases a um arquivo
Export-Alias -Path "alias.csv" -Append -Description "Appended Aliases" -Force
Esse comando acrescenta os aliases na sessão atual ao arquivo Alias.csv.
O comando usa o parâmetro Descrição para adicionar uma descrição aos comentários na parte superior do arquivo.
O comando também utiliza o parâmetro Force para sobrescrever quaisquer arquivos Alias.csv existentes, mesmo que possuam o atributo de somente leitura.
Exemplo 4: Exportar aliases como um script
Export-Alias -Path "alias.ps1" -As Script
Add-Content -Path $Profile -Value (Get-Content alias.ps1)
$S = New-PSSession -ComputerName Server01
Invoke-Command -Session $S -FilePath .\alias.ps1
Este exemplo mostra como usar o formato de arquivo de script gerado por Export-Alias.
O primeiro comando exporta os aliases na sessão para o arquivo Alias.ps1. Ele usa o parâmetro As com um valor de Script para gerar um arquivo que contém um comando Set-Alias para cada alias.
O segundo comando adiciona os aliases no arquivo Alias.ps1 ao perfil CurrentUser-CurrentHost.
O caminho para o perfil é salvo na variável $Profile.
O comando usa o cmdlet Get-Content para obter os aliases do arquivo Alias.ps1 e do cmdlet Add-Content para adicioná-los ao perfil.
Para obter mais informações, consulte about_Profiles.
O terceiro e o quarto comandos adicionam os aliases no arquivo Alias.ps1 a uma sessão remota no computador Server01.
O terceiro comando usa o cmdlet New-PSSession para criar a sessão.
O quarto comando usa o parâmetro FilePath do cmdlet Invoke-Command para executar o arquivo Alias.ps1 na nova sessão.
Parâmetros
-Append
Indica que este cmdlet anexa a saída ao arquivo especificado, em vez de substituir o conteúdo existente desse arquivo.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-As
Especifica o formato de saída. CSV é o padrão.
Os valores válidos são:
- CSV: formato CSV (valor separado por vírgula).
- Script: Cria um comando Set-Alias para cada alias exportado. Se você nomear o arquivo de saída com uma extensão de nome de arquivo .ps1, poderá executá-lo como um script para adicionar os aliases a qualquer sessão.
Propriedades do parâmetro
| Tipo: | ExportAliasFormat |
| Valor padrão: | None |
| Valores aceitos: | Csv, Script |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Description
Especifica a descrição do arquivo exportado. A descrição aparece como um comentário na parte superior do arquivo, seguindo as informações de cabeçalho.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Force
Força o comando a ser executado sem solicitar a confirmação do usuário.
Sobrescreve o arquivo de saída, mesmo que o atributo de somente leitura já esteja definido no arquivo.
Por padrão, Export-Alias substitui arquivos sem aviso, a menos que o parâmetro NoClobber seja usado no comando ou que o atributo de somente leitura ou oculto esteja definido.
O parâmetro NoClobber tem precedência sobre o parâmetro Force quando ambos são usados em um comando.
O parâmetro Force não força Export-Alias a sobrescrever arquivos com o atributo escondido.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-LiteralPath
Especifica o caminho para o arquivo de saída. Ao contrário do caminho , o valor do parâmetro LiteralPath é usado exatamente como ele é digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell que não deve interpretar nenhum caractere como uma sequência de escape.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
ByLiteralPath
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Name
Especifica os nomes como uma matriz dos aliases a serem exportados. Caracteres curinga são permitidos.
Por padrão, o Export-Alias exporta todos os aliases da sessão ou do escopo.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-NoClobber
Indica que esse cmdlet impede que Export-Alias substitua qualquer arquivo, mesmo que o parâmetro Force seja usado no comando.
Se o parâmetro NoClobber for omitido, Export-Alias substituirá um arquivo existente sem aviso, a menos que o atributo somente leitura seja definido no arquivo.
NoClobber tem precedência sobre o parâmetro Force, que permite que Export-Alias substitua um arquivo com o atributo somente leitura.
NoClobber não impede que o parâmetro Append adicione conteúdo a um arquivo existente.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | NoOverwrite |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Path
Especifica o caminho para o arquivo de saída. Caracteres curinga são permitidos, mas o valor do caminho resultante deve ser resolvido para um único nome de arquivo.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
ByPath
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Scope
Especifica o escopo do qual os aliases devem ser exportados. Os valores aceitáveis para este parâmetro são:
- Mundial
- Local
- Script
- Um número relativo ao escopo atual (0 até o número de escopos, onde 0 é o escopo atual e 1 é o escopo pai)
O valor padrão é Local. Para obter mais informações, consulte about_Scopes.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | Local |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None.
Você não pode redirecionar objetos para este cmdlet.
Saídas
None or System.Management.Automation.AliasInfo
Quando você usa o parâmetro
Observações
- Somente é possível usar o Export-Alias para exportar aliases para um arquivo.