Import-PSSession

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

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

C:\PS> import-pssession -session $s

说明
-----------
此命令将 Server01 计算机上某个 PSSession 中的所有命令导入当前会话，但与当前会话中的命令同名的命令除外。

因为此命令不使用 CommandName 参数，所以它还将导入所导入的命令所必需的所有格式数据。

C:\PS>$s = new-pssession https://ps.testlabs.com/powershell

C:\PS> import-pssession -session $s -commandname *-test -formatTypeName *

C:\PS> new-test -name test1

C:\PS> get-test test1 | run-test

说明
-----------
这些命令将 PSSession 中名称以“-test”结尾的命令导入本地会话，然后说明如何使用导入的 cmdlet。

第一个命令使用 New-PSSession cmdlet 创建 PSSession。它将 PSSession 保存在 $s 变量中。

第二个命令使用 Import-PSSession cmdlet 从 $s 中的 PSSession 将命令导入当前会话。它使用 CommandName 参数来指定带有 Test 名词的命令，使用 FormatTypeName 参数来导入各 Test 命令的格式数据。

第三个和第四个命令使用当前会话中导入的命令。因为导入的命令实际添加到当前会话，所以您可以使用本地语法来运行这些命令。不需要使用 Invoke-Command cmdlet 来运行导入的命令。

C:\PS>$s1 = new-pssession -computername s1 

C:\PS> $s2 = new-pssession -computername s2

C:\PS> import-pssession -session s1 -type cmdlet -name New-Test, Get-Test -FormatTypeName *

C:\PS> import-pssession -session s2 -type cmdlet -name Set-Test -FormatTypeName *

C:\PS> new-test Test1 | set-test -runtype full

说明
-----------
此示例说明您可以像使用本地 cmdlet 那样使用导入的 cmdlet。

这些命令导入 Server01 计算机上某个 PSSession 中的 New-Test 和 Get-Test cmdlet，并导入 Server02 计算机上某个 PSSession 中的 Set-Test cmdlet。

即使 cmdlet 是从不同 PSSession 导入的，也可以通过管道将对象从一个 cmdlet 传递到另一个 cmdlet，而不会发生错误。

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

C:\PS> import-pssession -session $s -commandname *-test* -formattypename *

C:\PS> $batch = new-test -name Batch -asjob

C:\PS> receive-job $batch

说明
-----------
此示例演示了如何将导入的命令作为后台作业运行。

因为导入的命令需要花费比本地命令更长的时间来运行，所以 Import-PSSession 会向每个导入的命令添加 AsJob 参数。AsJob 参数允许您将命令作为后台作业运行。

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

第二个命令使用 Import-PSSession 将 Test cmdlet 从 $s 中的 PSSession 导入当前会话。

第三个命令使用导入的 New-Test cmdlet 的 AsJob 参数将 New-Test 命令作为后台作业运行。该命令将 New-Test 返回的作业对象保存在 $batch 变量中。

第四个命令使用 Receive-Job cmdlet 来获取 $batch 变量中的作业的结果。

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

C:\PS> invoke-command -session $s {import-module TestManagement}

C:\PS> import-pssession -session $s -module TestManagement

说明
-----------
此示例演示如何将远程计算机上某个 Windows PowerShell 模块中的 cmdlet 和函数导入当前会话。

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

第二个命令使用 Invoke-Command cmdlet 在 $s 中的 PSSession 中运行 Import-Module 命令。

通常，该模块将通过 Windows PowerShell 配置文件中的 Import-Module 命令添加到所有会话，但是配置文件不在 PSSession 中运行。

第三个命令使用 Import-PSSession 的 Module 参数将模块中的 cmdlet 和函数导入当前会话。

C:\PS>import-pssession $s -CommandName Get-Date, SearchHelp  -formatTypeName * -AllowClobber


Name              : tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
Path              : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf\tmp_79468106-4e1d-4d90-af97-1154f9317239_
                    tcw1zunz.ttf.psm1
Description       : Implicit remoting for http://server01.corp.fabrikam.com/wsman
Guid              : 79468106-4e1d-4d90-af97-1154f9317239
Version           : 1.0
ModuleBase        : C:\Users\User01\AppData\Local\Temp\tmp_79468106-4e1d-4d90-af97-1154f9317239_tcw1zunz.ttf
ModuleType        : Script
PrivateData       : {ImplicitRemoting}
AccessMode        : ReadWrite
ExportedAliases   : {}
ExportedCmdlets   : {}
ExportedFunctions : {[Get-Date, Get-Date], [SearchHelp, SearchHelp]}
ExportedVariables : {}
NestedModules     : {}

说明
-----------
此示例说明 Import-PSSession 在磁盘上的临时文件中创建一个模块。还说明所有命令在导入到当前会话之前都已转换为函数。

该命令使用 Import-PSSession cmdlet 将 Get-Date cmdlet 和 SearchHelp 函数导入当前会话。

Import-PSSession cmdlet 返回一个表示临时模块的 PSModuleInfo 对象。Path 属性的值表明 Import-PSSession 在临时位置创建了一个脚本模块 (.psm1) 文件。ExportedFunctions 属性表明 Get-Date cmdlet 和 SearchHelp 函数都是作为函数导入的。

C:\PS>import-pssession $s -CommandName Get-Date -formatTypeName * -AllowClobber

C:\PS> get-command get-date

CommandType   Name       Definition
-----------   ----       ----------
Function      Get-Date   ...
Cmdlet        Get-Date   Get-Date [[-Date] <DateTime>] [-Year <Int32>] [-Month <Int32>]

C:\PS> Get-Date
09074   

C:\PS> (get-command -type cmdlet -name get-date).pssnapin.name
Microsoft.PowerShell.Utility

C:\PS> Microsoft.PowerShell.Utility\get-date

Sunday, March 15, 2009 2:08:26 PM

说明
-----------
此示例演示如何运行由导入的命令隐藏的命令。

第一个命令从 $s 变量中的 PSSession 导入 Get-Date cmdlet。因为当前会话包含 Get-Date cmdlet，所以 AllowClobber 参数在该命令中是必需的。

第二个命令使用 Get-Command cmdlet 获取当前会话中的 Get-Date 命令。输出表明该会话包含原始 Get-Date cmdlet 和一个 Get-Date 函数。Get-Date 函数运行在 $s 中的 PSSession 中导入的 Get-Date cmdlet。

第三个命令运行 Get-Date 命令。因为函数优先于 cmdlet，所以 Windows PowerShell 运行导入的 Get-Date 函数，该函数返回一个儒略历日期。

第四和第五个命令演示如何使用限定名称运行由导入的命令隐藏的命令。

第四个命令获取将原始 Get-Date cmdlet 添加到当前会话的 Windows PowerShell 管理单元的名称。

第五个命令使用 Get-Date cmdlet 的管理单元限定名称来运行 Get-Date 命令。

有关命令优先级和隐藏的命令的详细信息，请参阅 about_Command_Precedence。

C:\PS>import-pssession -session $s -commandName *Item* -AllowClobber

说明
-----------
此命令从 $s 中的 PSSession 导入名称中包含“Item”的命令。因为该命令包含 CommandName 参数但不包含 FormatTypeData 参数，所以仅导入该命令。

如果要使用 Import-PSSession 在远程计算机上运行命令，并且当前会话中已有该命令的格式数据，可使用此命令。

C:\PS>$m = import-pssession -session $s -CommandName *bits* -formattypename *bits*

C:\PS> get-command -module $m

CommandType     Name
-----------     ----
Function        Add-BitsFile
Function        Complete-BitsTransfer
Function        Get-BitsTransfer
Function        Remove-BitsTransfer
Function        Resume-BitsTransfer
Function        Set-BitsTransfer
Function        Start-BitsTransfer
Function        Suspend-BitsTransfer

说明
-----------
此命令演示如何使用 Get-Command 的 Module 参数来查明 Import-PSSession 命令将哪些命令导入到会话中。

第一个命令使用 Import-PSSession cmdlet 从 $s 变量中的 PSSession 导入名称中包含“bits”的命令。Import-PSSession 命令返回一个临时模块，并将该模块保存在 $m 变量中。

第二个命令使用 Get-Command cmdlet 获取由该模块导出到 $m 变量中的命令。

Module 参数接受一个字符串值，该字符串值用作模块名称。但是，在提交模块对象时，Windows PowerShell 使用模块对象的 ToString 方法，该方法返回模块名称。

Get-Command 命令与“get-command $m.name”等效。