Compartilhar via

Export-Console

  • Referência
Módulo:
Microsoft.PowerShell.Core

Exporta os nomes dos snap-ins na sessão atual para um arquivo de console.

Sintaxe

Export-Console
      [[-Path] <String>]
      [-Force]
      [-NoClobber]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

O cmdlet Export-Console 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, em seguida, use o parâmetro PSConsoleFile de 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

Esse comando exporta os nomes dos snap-ins do Windows PowerShell na sessão atual para o arquivo ConsoleS1.psc1 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

PS C:\> Export-Console

Esse comando exporta os nomes dos snap-ins do Windows PowerShell da sessão atual para o arquivo de console do Windows PowerShell que foi 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, solicitado um nome de arquivo.

Exemplo 3: Adicionar um snap-in e exportar os nomes dos snap-ins

PS C:\> Add-PSSnapin NewPSSnapin
PS C:\> Export-Console -path NewPSSnapinConsole.psc1
PS C:\> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

Esses comandos adicionam o snap-in do Windows PowerShell newpssnapin à sessão atual, exportam os nomes dos snap-ins do Windows PowerShell na sessão atual para um arquivo de console e, em seguida, iniciam uma sessão do Windows PowerShell com o arquivo de console.

O primeiro comando usa o cmdlet Add-PSSnapin 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 arquivo NewPSSnapinConsole.psc1.

O terceiro comando inicia o Windows PowerShell com o arquivo NewPSSnapinConsole.psc1. Como o arquivo de console inclui o nome de 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>

Esse comando exporta os nomes dos snap-ins do Windows PowerShell na sessão atual para o arquivo Console01.psc1 no diretório atual.

O segundo comando exibe o conteúdo do arquivo Console01.psc1 no Bloco de Notas.

Exemplo 5: Determinar o arquivo de console a ser atualizado

PS C:\> powershell.exe -PSConsoleFile Console01.psc1
PS C:\> Add-PSSnapin MySnapin
PS C:\> Export-Console NewConsole.psc1
PS C:\> $ConsoleFileName
PS C:\> Add-PSSnapin SnapIn03
PS C:\> Export-Console

Este exemplo mostra como usar a variável automática $ConsoleFileName para determinar o arquivo de console que será atualizado se você usar export-console sem um valor de parâmetro caminho .

O primeiro comando usa o parâmetro PSConsoleFile de PowerShell.exe para abrir o Windows PowerShell com o arquivo Console01.psc1.

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

O terceiro comando usa o cmdlet Export-Console para exportar os nomes de todos os snap-ins do Windows PowerShell na sessão para o arquivo NewConsole.psc1.

O quarto comando exibe a variável $ConsoleFileName. 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 cmdlet Export-Console sem um parâmetro de caminho . Esse 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 confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:SwitchParameter
Aliases:NoOverwrite
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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 com 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.

Tipo:String
Aliases:PSPath
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

String

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

Saídas

FileInfo

Esse cmdlet cria um arquivo que contém os aliases exportados.

Observações

  • Quando um arquivo de console (.psc1) é usado para iniciar a sessão, o nome do arquivo de console é armazenado automaticamente no $ConsoleFileName variável automática. O valor de $ConsoleFileName é atualizado quando você usa o parâmetro Path de Export-Console para especificar um novo arquivo de 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.