Export-Console
Exporta os nomes dos snap-ins na sessão atual para um arquivo de console.
Syntax
Export-Console
[[-Path] <String>]
[-Force]
[-NoClobber]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
O Export-Console cmdlet exporta os nomes dos snap-ins do Windows PowerShell na sessão atual para um arquivo de console do Windows PowerShell (.psc1). Você pode usar esse cmdlet para salvar os snap-ins para uso em sessões futuras.
Para adicionar os snap-ins no arquivo de console .psc1 a uma sessão, inicie o Windows PowerShell (PowerShell.exe) na linha de comando usando Cmd.exe ou outra sessão do Windows PowerShell e use o parâmetro PSConsoleFile do PowerShell.exe para especificar o arquivo de console.
Para obter mais informações sobre snap-ins do Windows PowerShell, consulte about_PSSnapins.
Exemplos
Exemplo 1: Exportar os nomes dos snap-ins na sessão atual
PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1Este comando exporta os nomes dos snap-ins do Windows PowerShell na sessão atual para o ConsoleS1.psc1 arquivo na pasta Consoles da pasta de instalação do Windows PowerShell, $pshome.
Exemplo 2: Exportar os nomes dos snap-ins para o arquivo de console mais recente
Export-ConsoleEste comando exporta os nomes dos snap-ins do Windows PowerShell da sessão atual para o arquivo de console do Windows PowerShell usado mais recentemente na sessão atual. Ele substitui o conteúdo do arquivo anterior.
Se você não tiver exportado um arquivo de console durante a sessão atual, será solicitada permissão para continuar e, em seguida, será solicitado um nome de arquivo.
Exemplo 3: Adicionar um snap-in e exportar os nomes dos snap-ins
Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1Esses comandos adicionam o snap-in NewPSSnapin do Windows PowerShell à sessão atual, exportam os nomes dos snap-ins do Windows PowerShell na sessão atual para um arquivo de console e iniciam uma sessão do Windows PowerShell com o arquivo de console.
O primeiro comando usa o Add-PSSnapin cmdlet para adicionar o snap-in NewPSSnapin à sessão atual. Você só pode adicionar snap-ins do Windows PowerShell registrados em seu sistema.
O segundo comando exporta os nomes de snap-in do Windows PowerShell para o NewPSSnapinConsole.psc1 arquivo.
O terceiro comando inicia o Windows PowerShell com o NewPSSnapinConsole.psc1 arquivo. Como o arquivo de console inclui o nome do snap-in do Windows PowerShell, os cmdlets e provedores no snap-in estão disponíveis na sessão atual.
Exemplo 4: Exportar nomes de snap-ins para um local especificado
PS C:\> export-console -path Console01
PS C:\> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
<PSVersion>2.0</PSVersion>
<PSSnapIns>
<PSSnapIn Name="NewPSSnapin" />
</PSSnapIns>
</PSConsoleFile>Este comando exporta os nomes dos snap-ins do Windows PowerShell na sessão atual para o Console01.psc1 arquivo no diretório atual.
O segundo comando exibe o Console01.psc1 conteúdo do arquivo no bloco de notas.
Exemplo 5: Determinar o arquivo de console a ser atualizado
powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
Export-ConsoleEste exemplo mostra como usar a $ConsoleFileName variável automática para determinar o arquivo de console que será atualizado se você usar Export-Console sem um valor de parâmetro Path .
O primeiro comando usa o parâmetro PSConsoleFile do PowerShell.exe para abrir o Windows PowerShell com o Console01.psc1 arquivo.
O segundo comando usa o Add-PSSnapin cmdlet para adicionar o snap-in MySnapin do Windows PowerShell à sessão atual.
O terceiro comando usa o Export-Console cmdlet para exportar os nomes de todos os snap-ins do Windows PowerShell na sessão para o NewConsole.psc1 arquivo.
O quarto comando exibe a $ConsoleFileName variável. Ele contém o arquivo de console usado mais recentemente. A saída de exemplo mostra que NewConsole.ps1 é o arquivo usado mais recentemente.
O quinto comando adiciona SnapIn03 ao console atual.
O sexto comando usa o Export-Console cmdlet sem um parâmetro Path . Este comando exporta os nomes de todos os snap-ins do Windows PowerShell na sessão atual para o arquivo usado mais recentemente, NewConsole.psc1.
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
Indica que esse cmdlet substitui os dados em um arquivo de console sem aviso, mesmo que o arquivo tenha o atributo somente leitura. O atributo somente leitura é alterado e não é redefinido quando o comando é concluído.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NoClobber
Indica que esse cmdlet não substitui um arquivo de console existente. Por padrão, se um arquivo ocorrer no caminho especificado, Export-Console substituirá o arquivo sem aviso.
| Type: | SwitchParameter |
| Aliases: | NoOverwrite |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Path
Especifica um caminho e um nome de arquivo para o arquivo de console (*.psc1). Insira um caminho e um nome opcionais.
Caracteres curinga não são permitidos.
Se você especificar apenas um nome de arquivo, Export-Console criará um arquivo que tenha esse nome e a extensão de nome de arquivo .psc1 no diretório atual.
Esse parâmetro é necessário, a menos que você tenha aberto o Windows PowerShell com o parâmetro PSConsoleFile ou exportado um arquivo de console durante a sessão atual. Também é necessário quando você usa o parâmetro NoClobber para impedir que o arquivo de console atual seja substituído.
Se você omitir esse parâmetro, Export-Console substituirá o arquivo de console que foi usado mais recentemente nesta sessão. O caminho do arquivo de console usado mais recentemente é armazenado no valor da variável automática $ConsoleFileName. Para obter mais informações, consulte about_Automatic_Variables.
| Type: | String |
| Aliases: | PSPath |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| 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
Você pode canalizar uma cadeia de caracteres de caminho para esse cmdlet.
Saídas
Este cmdlet cria um arquivo que contém os aliases exportados.
Notas
Quando um arquivo de console (
.psc1) é usado para iniciar a sessão, o nome do arquivo de console é armazenado automaticamente na$ConsoleFileNamevariável automática. O valor de é atualizado quando você usa o parâmetro Path de para especificar um novo arquivo de$ConsoleFileNameExport-Consoleconsole. Quando nenhum arquivo de console é usado, $ConsoleFileName não tem valor ($null).Para usar um arquivo de console do Windows PowerShell em uma nova sessão, use a seguinte sintaxe para iniciar o Windows PowerShell:
powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1Você também pode salvar snap-ins do Windows PowerShell para sessões futuras adicionando um comando Add-PSSnapin ao seu perfil do Windows PowerShell. Para obter mais informações, consulte about_Profiles.
Ligações Relacionadas
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários