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.psc1

Este 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-Console

Este 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.psc1

Esses 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 cmdlet para adicionar o Add-PSSnapin 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-Console

Este 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.psc1arquivo.

O segundo comando usa o cmdlet para adicionar o Add-PSSnapin snap-in MySnapin do Windows PowerShell à sessão atual.

O terceiro comando usa o cmdlet para exportar os nomes de todos os snap-ins do Windows PowerShell na sessão para o Export-ConsoleNewConsole.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

String

Você pode canalizar uma cadeia de caracteres de caminho para este cmdlet.

Saídas

FileInfo

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 $ConsoleFileName variável automática. O valor de é atualizado quando você usa o parâmetro Path de para especificar um novo arquivo de $ConsoleFileNameExport-Console console. 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\>.psc1

    Você 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.