Export-PSSession

Export-PSSession [-Session] <PSSession> [-OutputModule] <string> [[-CommandName] <string[]>] [[-FormatTypeName] <string[]>] [-AllowClobber] [-ArgumentList <Object[]>] [-CommandType {<Alias> | <Function> | <Filter> | <Cmdlet> | <ExternalScript> | <Application> | <Script> | <All>}] [-Encoding <string>] [-Force] [-Module <string[]>] [<CommonParameters>]

C:\PS>$s = new-pssession -computerName Server01

C:\PS> export-pssession -session $s -outputModule Server01

Descrição
-----------
Os comandos neste exemplo exportam todos os comandos de uma PSSession no computador Server01 para o módulo Server01 no computador local, com exceção dos comandos que têm o mesmo nome que os comandos da sessão atual. Ele também exporta os dados de formatação para os comandos.   

O primeiro comando cria uma PSSession no computador Server01. O segundo comando exporta os comandos e dados de formatação da sessão no módulo Server01.

C:\PS>$s = new-pssession -ConnectionUri http://exchange.microsoft.com/mailbox -credential exchangeadmin01@hotmail.com -authentication negotiate

C:\PS> export-pssession -session $r -module exch* -commandname get-*, set-* -formattypename * -outputModule $pshome\Modules\Exchange -encoding ASCII

Descrição
-----------
Esses comandos exportam os comandos Get e Set de um snap-in do Microsoft Exchange Server em um computador remoto para um módulo do Exchange no diretório $pshome\Modules no computador local.

Colocar o módulo no diretório $pshome\Module torna-o acessível a todos os usuários do computador.

C:\PS>$s = new-pssession -computerName Server01 -credential Server01\User01

C:\PS> export-pssession -session $s -outputModule TestCmdlets -type cmdlet -commandname *test* -formattypename *

C:\PS> remove-pssession $s

C:\PS> import-module TestCmdlets

C:\PS> get-help test*

C:\PS> test-files

Descrição
-----------
Esses comandos exportam cmdlets de uma PSSession em um computador remoto e os salva em um módulo no computador local. Em seguida, os comandos acrescentam os cmdlets do módulo à sessão atual de modo que possam ser usados.

O primeiro comando cria uma PSSession no computador Server01 e salva-a na variável $s.

O segundo comando exporta os cmdlets cujos nomes começam com "Test" da PSSession em $s para o módulo TestCmdlets no computador local.

O terceiro comando usa o cmdlet Remove-PSSession para excluir a PSSession em $s da sessão atual. Esse comando mostra que a PSSession não precisa estar ativa para usar os comandos que foram importados dela.


O quarto comando, que pode ser executado em qualquer momento em qualquer sessão, usa o cmdlet Import-Module para acrescentar os cmdlets no módulo TestCmdlets à sessão atual.

O quinto comando usa o cmdlet Get-Help para obter ajuda sobre cmdlets cujos nomes começam com "Test." Depois que os comandos em um módulo são acrescentados à sessão atual, você pode usar os cmdlets Get-Help e Get-Command para conhecer os comandos importados, da mesma forma que você os usaria para qualquer outro comando na sessão.

O sexto comando usa o cmdlet Test-Files, que foi exportado do computador Server01 e acrescentado à sessão. 

Embora não seja evidente, o comando Test-Files é executado em uma sessão remota no computador do qual ele foi importado. O Windows PowerShell cria uma sessão com base nas informações armazenadas no módulo.

C:\PS>export-pssession -session $s -AllowClobber -outputModule AllCommands

Descrição
-----------
Esse comando exporta todos os comandos e todos os dados de formatação da PSSession na variável $s para a sessão atual. O comando usa o parâmetro AllowClobber para incluir comandos com os mesmos nomes que os comandos da sessão atual.

C:\PS>$options = New-PSSessionOption -NoMachineProfile

C:\PS> $s = new-pssession -computername Server01 -sessionoption $options

C:\PS> export-pssession -session $s -outputModule Server01

C:\PS> remove-pssession $s

C:\PS> new-pssession -computername Server01 -sessionoption $options

C:\PS> import-module Server01

Descrição
-----------
Esse exemplo mostra como executar os comandos exportados em uma sessão com opções específicas quando a PSSession da qual os comandos foram exportados é fechada.

Quando você usa o Export-PSSession, ele salva informações sobre a PSSession original no módulo que ele cria. Quando você importa o módulo, se a sessão remota original estiver fechada, o módulo usará qualquer sessão remota aberta que se conectar ao computador de origem. 

Se a sessão atual não incluir uma sessão remota ao computador de origem, os comandos no módulo restabelecerão uma sessão com aquele computador. Porém, Export-PSSession não salva opções especiais, como as definidas com o parâmetro SessionOption de New-PSSession, no módulo. 

Portanto, se você desejar executar os comandos exportados em uma sessão remota com opções específicas, você precisará criar uma sessão remota com as opções desejadas antes de importar o módulo.

O primeiro comando usa o cmdlet New-PSSessionOption para criar um objeto PSSessionOption e salva o objeto na variável $options.

O segundo comando cria uma PSSession que inclui as opções especificadas. O comando usa o cmdlet New-PSSession para criar uma PSSession no computador Server01. Ele usa o parâmetro SessionOption para enviar o objeto de opção em $options. 

O terceiro comando usa o cmdlet Export-PSSession para exportar comandos da PSSession em $s para o módulo Server01.

O quarto comando usa o cmdlet Remove-PSSession para excluir a PSSession na variável $s.

O quinto comando usa o cmdlet New-PSSession para criar uma nova PSSession que se conecta ao computador Server01. Essa PSSession também usa as opções de sessão na variável $options.

O sexto comando usa o cmdlet Import-Module para importar os comandos do módulo Server01. Os comandos no módulo são executados na PSSession do computador Server01.