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

Descripción
-----------
Los comandos de este ejemplo exportan todos los comandos de una PSSession en el equipo Server01 al módulo Server01 en el equipo local, salvo los comandos que tienen el mismo nombre que los comandos de la sesión actual. También se exportan los datos de formato de los comandos.   

El primer comando crea una PSSession en el equipo Server01. El segundo comando exporta los comandos y los datos de formato de la sesión al 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

Descripción
-----------
Estos comandos exportan los comandos Get y Set de un complemento de Microsoft Exchange Server en un equipo remoto a un módulo de Exchange en el directorio $pshome\Modules del equipo local.

Al colocarse el módulo en el directorio $pshome\Modules, todos los usuarios del equipo podrán obtener acceso al mismo.

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

Descripción
-----------
Estos comandos exportan los cmdlets de una PSSession en un equipo remoto y los guarda en un módulo ubicado en el equipo local. A continuación, los comandos agregan los cmdlets del módulo a la sesión actual de modo que se puedan utilizar.

El primer comando crea una PSSession en el equipo Server01 y la guarda en la variable $s.

El segundo comando exporta los cmdlets cuyo nombre comienza con "Test" de la PSSession guardada en $s al módulo TestCmdlets ubicado en el equipo local.

El tercer comando usa el cmdlet Remove-PSSession para eliminar la PSSession guardada en $s de la sesión actual. Este comando muestra que la PSSession debe estar activa para poder utilizar los comandos importadas de dicha sesión.

El cuarto comando, que se puede ejecutar en cualquier sesión y en cualquier momento, utiliza el cmdlet Import-Module para agregar los cmdlets del módulo TestCmdlets a la sesión actual.

El quinto comando utiliza el cmdlet Get-Help para obtener ayuda referente a los cmdlets cuyo nombre comienza con "Test". Una vez agregados a la sesión actual los comandos de un módulo, puede utilizar los cmdlets Get-Help y Get-Command para obtener información sobre los comandos importados, tal y como los utilizaría para cualquier comando de la sesión.

El sexto comando utiliza el cmdlet Test-Files, que se exportó del equipo Server01 y se agregó a la sesión. 

Aunque no es obvio, el comando Test-Files se ejecuta en realidad en una sesión remota en el equipo del que se importó el comando. Windows PowerShell crea una sesión a partir de la información almacenada en el módulo.

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

Descripción
-----------
Este comando exporta a la sesión actual todos los comandos y datos de formato de la PSSession guardada en la variable $s. El comando utiliza el parámetro AllowClobber para incluir los comandos que tienen el mismo nombre que comandos de la sesión actual.

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

Descripción
-----------
En este ejemplo, se muestra cómo ejecutar los comandos exportados en una sesión con opciones concretas cuando está cerrada la PSSession de la que se exportaron los comandos.

Cuando se usa Export-PSSession, la información sobre la PSSession original se guarda en el módulo que se crea. Al importar el módulo, si está cerrada la sesión remota original, el módulo utilizará cualquier sesión remota abierta que esté conectada al equipo original. 

Si la sesión actual no incluye una sesión remota con el equipo original, los comandos del módulo restablecerán una sesión con ese equipo. Sin embargo, Export-PSSession no guarda en el módulo las opciones especiales, como las que se establecen mediante el parámetro SessionOption de New-PSSession. 

Por consiguiente, si desea ejecutar los comandos exportados en una sesión remota con opciones concretas, deberá crear una sesión remota con las opciones que desee antes de importar el módulo.

El primer comando utiliza el cmdlet New-PSSessionOption para crear un objeto PSSessionOption y guarda este objeto en la variable $options.

El segundo comando crea una PSSession con las opciones especificadas. El comando utiliza el cmdlet New-PSSession para crear una PSSession en el equipo Server01. Utiliza el parámetro SessionOption para enviar el objeto de opción guardado en $options. 

El tercer comando usa el cmdlet Export-PSSession para exportar los comandos de la PSSession guardada en $s al módulo Server01.

El cuarto comando usa el cmdlet Remove-PSSession para eliminar la PSSession guardada en la variable $s.

El quinto comando utiliza el cmdlet New-PSSession para crear una nueva PSSession que está conectada al equipo Server01. Esta PSSession también utiliza las opciones de sesión guardadas en la variable $options.

El sexto comando usa el cmdlet Import-Module para importar los comandos del módulo Server01. Los comandos del módulo se ejecutan en la PSSession del equipo Server01.