Compartilhar via

Export-Console

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

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

Sintaxe

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 este cmdlet para salvar os snap-ins para uso em futuras sessões.

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

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 não exportar um arquivo de console durante a sessão atual, será solicitado que você tenha permissão para continuar e, em seguida, o nome de um 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 Add-PSSnapin cmdlet para adicionar o snap-in NewPSSnapin à sessão atual. Você só pode adicionar snap-ins do Windows PowerShell registrados no 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 do 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 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 de 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 amostra de saída mostra que o NewConsole.ps1 é o arquivo usado mais recentemente.

O quinto comando adiciona SnapIn03 no console atual.

O sexto comando usa o Export-Console cmdlet sem um parâmetro Path . 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 sua 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 o 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 o 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 evitar que o arquivo de console atual seja substituído.

Se você omitir esse parâmetro, Export-Console o 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, confira 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 esse 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 na $ConsoleFileName variável automática. O valor de é atualizado quando você usa o parâmetro Path de para especificar um novo arquivo de $ConsoleFileName Export-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 sintaxe a seguir para iniciar o Windows PowerShell:

    powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1

    Você também pode salvar os snap-ins do Windows PowerShell para futuras sessões, adicionando um comando Add-PSSnapin para seu perfil do Windows PowerShell. Para obter mais informações, consulte about_Profiles.