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

说明
-----------
此示例中的命令将 Server01 计算机上某个 PSSession 中的所有命令导出到本地计算机上的 Server01 模块，但与当前会话中的命令具有相同名称的命令除外。它还将导出命令的格式数据。

第一条命令在 Server01 计算机上创建一个 PSSession。第二个命令将会话中的命令和格式数据导出到 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

说明
-----------
这些命令将 Get 和 Set 命令从远程计算机上的 Microsoft Exchange Server 管理单元导出到本地计算机上的 $pshome\Modules 目录下的 Exchange 模块中。

通过将模块置于 $pshome\Module 目录中，计算机上的所有用户就可对它进行访问。

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

说明
-----------
这些命令将 cmdlet 从远程计算机上的 PSSession 导出，并将它们保存在本地计算机上的一个模块中。然后，命令将 cmdlet 从模块添加到当前会话中，以便可以使用它们。

第一条命令在 Server01 计算机上创建一个 PSSession，并将它保存在 $s 变量中。

第二个命令将名称以“Test”开头的 cmdlet 从 $s 中的 PSSession 导出到本地计算机上的 TestCmdlets 模块中。

第三个命令使用 Remove-PSSession cmdlet 删除当前会话中的 $s 中的 PSSession。此命令说明 PSSession 使用从其导入的命令时无需处于活动状态。

第四个命令可在任何时候在任何会话中运行，它使用 Import-Module cmdlet 将 TestCmdlets 模块中的 cmdlet 添加到当前会话中。

第五个命令使用 Get-Help cmdlet 来获取名称以“Test”开头的 cmdlet 的帮助。将模块中的命令添加到当前会话中之后，可使用 Get-Help 和 Get-Command cmdlet 来了解这些导入的命令，就像在会话中针对任何命令使用它们一样。

第六个命令使用 Test-Files cmdlet，它从 Server01 计算机中导出并添加到会话中。

虽然并不显而易见，但 Test-Files 命令实际将在从中导入该命令的计算机上的一个远程会话中运行。Windows PowerShell 将基于存储在模块中的信息来创建会话。

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

说明
-----------
此命令将 $s 变量中 PSSession 的所有命令和所有格式数据导出到当前会话中。该命令使用 AllowClobber 参数将与当前会话中的命令具有相同名称的命令包括进来。

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

说明
-----------
此示例说明如何在从中导出命令的 PSSession 关闭时，在具有特定选项的会话中运行导出的命令。

在使用 Export-PSSession 时，它将保存其所创建的模块中的原始 PSSession 的相关信息。在导入模块时，如果原始远程会话已关闭，则该模块将使用与源计算机相连的任何打开的远程会话。

如果当前会话不包含与源计算机相连的会话，则该模块中的命令将重新建立与该计算机的会话。但是，Export-PSSession 不会保存特殊选项，如模块中通过使用 New-PSSession 的 SessionOption 参数设置的选项。

因此，如果想在具有特定选项的远程会话中运行导出的命令，则需要在导入模块之前，使用所需选项来创建远程会话。

第一个命令使用 New-PSSessionOption cmdlet 来创建 PSSessionOption 对象，并将该对象保存在 $options 变量中。

第二个命令将创建一个包含指定选项的 PSSession。该命令使用 New-PSSession cmdlet 在 Server01 计算机上创建一个 PSSession。它使用 SessionOption 参数将该选项对象提交到 $options 中。

第三个命令使用 Export-PSSession cmdlet 将 $s 中的 PSSession 的命令导出到 Server01 模块中。

第四个命令使用 Remove-PSSession cmdlet 删除 $s 变量中的 PSSession。

第五个命令使用 New-PSSession cmdlet 创建一个连接到 Server01 计算机的新 PSSession。此 PSSession 还使用 $options 变量中的会话选项。

第六个命令使用 Import-Module cmdlet 从 Server01 模块导入命令。该模块中的命令在 Server01 计算机上的 PSSession 中运行。