New-PSSession

New-PSSession [[-ComputerName] <string[]>] [-ApplicationName <string>] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-Name <string[]>] [-Port <int>] [-SessionOption <PSSessionOption>] [-UseSSL] [-ThrottleLimit <int>] [<CommonParameters>]

New-PSSession [[-Session] <PSSession[]>] [-Name <string[]>] [-ThrottleLimit <int>] [<CommonParameters>]

New-PSSession [-ConnectionURI] <Uri[]> [-AllowRedirection] [-Authentication {<Default> | <Basic> | <Negotiate> | <NegotiateWithImplicitCredential> | <Credssp> | <Digest> | <Kerberos>}] [-CertificateThumbprint <string>] [-ConfigurationName <string>] [-Credential <PSCredential>] [-Name <string[]>] [-SessionOption <PSSessionOption>] [-ThrottleLimit <int>] [<CommonParameters>]

C:\PS>$s = new-pssession

说明
-----------
此命令在本地计算机上创建一个新 PSSession 并将它保存在 $s 变量中。

现在，可以使用该 PSSession 在本地计算机上运行命令。

C:\PS>$Server01 = new-pssession -ComputerName Server01

说明
-----------
此命令在计算机 Server01 上创建一个新 PSSession 并将它保存在 $Server01 变量中。

如果创建了多个 PSSession，请将它们赋给具有有效名称的变量。这将有助于在随后的命令中管理 PSSession。

C:\PS>$s1, $s2, $s3 = new-session -computername server1,server2,server3

说明
-----------
此命令在 ComputerName 参数指定的每台计算机上创建一个新的 PSSession（共三个）。

它使用赋值运算符 (=) 将新的 PSSession 赋给变量数组：$s1, $s2, $s3。它将 Server01 PSSession 赋给 $s1，将 Server02 PSSession 赋给 $s2，将 Server03 PSSession 赋给 $s3。

将多个对象赋予一个变量数组时，Windows PowerShell 会将每个对象分别赋给数组中的一个变量。如果对象多于变量，则所有剩余的对象都赋给最后一个变量。如果变量多于对象，则剩余的变量为空 (Null)。

C:\PS>new-pssession -computername Server01 -port 8081 -useSSL -ConfigurationName E12

说明
-----------
此命令在计算机 Server01 上创建一个连接到服务器端口 8081 并使用 SSL 协议的新 PSSession。这个新的 PSSession 使用名为“E12”的替代会话配置。

设置端口之前，必须将远程计算机上的 WinRM 侦听器配置为侦听端口 8081。有关详细信息，请参阅关于 Port 参数的说明。

C:\PS>new-pssession -session $s -credential domain01\user01

说明
-----------
此命令创建一个与某个现有 PSSession 具有相同属性的新 PSSession。当现有 PSSession 的资源耗尽并且需要新的 PSSession 来分担某些需求时，可以使用该命令格式。

该命令使用 New-PSSession 的 Session 参数来指定保存在 $s 变量中的 PSSession。它使用 Domain1\Admin01 用户的凭据来完成命令。

C:\PS>$global:s = new-pssession -computername server1.domain44.corpnet.fabrikam.com -credential domain01\admin01

说明
-----------
此示例说明如何创建一个在位于不同域中的计算机上具有全局作用域的 PSSession。

默认情况下，在命令行创建的 PSSession 具有本地作用域，而在脚本中创建的 PSSession 具有脚本作用域。

若要创建具有全局作用域的 PSSession，请创建一个新 PSSession，然后将其存储在一个强制转换为全局作用域的变量中。在本例中，$s 变量强制转换为全局作用域。

此命令使用 ComputerName 参数来指定远程计算机。由于计算机与用户帐户处于不同的域中，因此必须指定计算机的全名以及用户的凭据。

C:\PS>$rs = get-content c:\test\servers.txt | new-PSsession -throttleLimit 50

说明
-----------
此命令在 Servers.txt 文件中列出的每台计算机（共 200 台）上创建一个 PSSession，并将生成的 PSSession 存储在 $rs 变量中。该 PSSession 的节流限制为 50。

当计算机名称存储在数据库、电子表格、文本文件中或以其他可转换为文本的格式存储时，可以使用该命令格式。

C:\PS>$s = new-PSSession -URI http://Server01:91/NewSession -credential domain01\user01

说明
-----------
此命令在计算机 Server01 上创建一个 PSSession 并将它存储在 $s 变量中。它使用 URI 参数来指定传输协议、远程计算机、端口以及备用会话配置。它还使用 Credential 参数来指定有权在远程计算机上创建会话的用户帐户。

C:\PS>$s = new-PSSession -computername (import-csv servers.csv) -credential domain01\admin01 -throttlelimit 16

C:\PS> invoke-command -session $s -scriptblock {get-process powershell} -AsJob

说明
-----------
这些命令创建一组 PSSession，然后在每个 PSSession 中运行一个后台作业。

第一个命令在 Servers.csv 文件中列出的每台计算机上创建一个新的 PSSession。它使用 New-PSSession cmdlet 来创建 PSSession。ComputerName 参数的值是一个使用 Import-Csv cmdlet 来导入 Servers.csv 文件并读取其内容的命令。

该命令使用 Credential 参数创建具有域管理员权限的 PSSession，并使用 ThrottleLimit 参数将命令限制在 16 个并发连接。该命令将 PSSession 保存在 $s 变量中。
   
第二个命令使用 Invoke-Command 的 AsJob 参数启动一个后台作业，此作业在 $s 中的每个 PSSession 中运行一个“Get-Process PowerShell”命令。

有关后台作业的详细信息，请参阅 about_Jobs and about_Remote_Jobs。

C:\PS>new-PSSession -ConnectionURI https://management.exchangelabs.com/Management

说明
-----------
此命令创建一个新的 PSSession，该 PSSession 连接到由 URI 而不是计算机名指定的计算机。

C:\PS>$so = New-WSManSessionOption -SkipCACheck

PS C:\> new-pssession -ConnectionUri https://management.exchangelabs.com/Management -SessionOption $so -credential server01\admin01

说明
-----------
此示例说明如何创建和使用 SessionOption 参数。

第一个命令使用 New-WSManSessionOption cmdlet 创建会话选项。它将生成的 SessionOption 对象保存在 $so 参数中。

第二个命令使用新会话中的选项。此命令使用 New-PSSession cmdlet 来创建新会话。SessionOption 参数的值是 $so 变量中的 SessionOption 对象。