New-WSManSessionOption

参考

模块:: Microsoft.WSMan.Management

创建会话选项哈希表，用作 WS-Management cmdlet 的输入参数。

语法

New-WSManSessionOption
   [-ProxyAccessType <ProxyAccessType>]
   [-ProxyAuthentication <ProxyAuthentication>]
   [-ProxyCredential <PSCredential>]
   [-SkipCACheck]
   [-SkipCNCheck]
   [-SkipRevocationCheck]
   [-SPNPort <Int32>]
   [-OperationTimeout <Int32>]
   [-NoEncryption]
   [-UseUTF16]
   [<CommonParameters>]

说明

此 cmdlet 仅在 Windows 平台上可用。

New-WSManSessionOption cmdlet 创建一个 WSMan 会话选项哈希表，该表可以传递给 WSMan cmdlet：

Get-WSManInstance
Set-WSManInstance
Invoke-WSManAction
Connect-WSMan

示例

示例 1：创建使用连接选项的连接

PS C:\> $a = New-WSManSessionOption -OperationTimeout 30000
PS C:\> Connect-WSMan -ComputerName "server01" -SessionOption $a
PS C:\> cd wsman:
PS WSMan:\> dir

WSManConfig: Microsoft.WSMan.Management\WSMan::WSMan
ComputerName                                  Type
------------                                  ----
localhost                                     Container
server01                                      Container

此示例使用 New-WSManSessionOption定义的连接选项创建与远程 server01 计算机的连接。

第一个命令使用 New-WSManSessionOption 在 $a 变量中存储一组连接设置选项。在这种情况下，会话选项将连接时间设置为 30 秒（30,000 毫秒）。

第二个命令使用 SessionOption 参数将存储在 $a 变量中的凭据传递给 Connect-WSMan。然后，Connect-WSMan 使用指定的会话选项连接到远程 server01 计算机。

Connect-WSMan 通常用于 WSMan 提供程序的上下文中以连接到远程计算机，在本例中为 server01 计算机。但是，在更改为 WSMan 提供程序之前，可以使用 cmdlet 建立与远程计算机的连接。这些连接显示在 ComputerName 列表中。

参数

-NoEncryption

指示连接不使用加密通过 HTTP 进行远程操作。

默认情况下，未加密的流量未启用。必须在本地配置中启用它。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-OperationTimeout

指定 WS-Management 操作的超时（以毫秒为单位）。

类型:	Int32
别名:	OperationTimeoutMSec
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProxyAccessType

指定代理服务器所在的机制。此参数的可接受值为：

ProxyIEConfig - 对当前用户使用 Internet Explorer 代理配置。
ProxyWinHttpConfig - WSMan 客户端使用为 WinHTTP 配置的代理设置，并使用 ProxyCfg.exe 实用工具。
ProxyAutoDetect - 强制自动检测代理服务器。
ProxyNoProxyServer - 不使用代理服务器。在本地解析所有主机名。

默认值为 ProxyIEConfig。

类型:	ProxyAccessType
接受的值:	ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProxyAuthentication

指定要在代理中使用的身份验证方法。此参数的可接受值为：

Basic - 基本是一种方案，其中用户名和密码以明文形式发送到服务器或代理。
Digest - 摘要是一种质询响应方案，它使用服务器指定的数据字符串来应对质询。
Negotiate - 协商是一种质询响应方案，它与服务器或代理协商以确定要用于身份验证的方案。例如 Kerberos 协议和 NTLM。

默认值为 Negotiate。

类型:	ProxyAuthentication
接受的值:	Negotiate, Basic, Digest
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ProxyCredential

指定有权通过中间 Web 代理获取访问权限的用户帐户。

类型:	PSCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkipCACheck

指定在通过 HTTPS 进行连接时，客户端不会验证服务器证书是否由受信任的证书颁发机构（CA）签名。仅当远程计算机受另一种方法信任时，才使用此选项，例如，如果远程计算机是物理安全且隔离的网络的一部分，或者远程计算机在 WS-Management 配置中列为受信任的主机。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkipCNCheck

指定服务器的证书公用名（CN）不必与服务器的主机名匹配。这仅在使用 HTTPS 的远程操作中使用。此选项只应用于受信任的计算机。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SkipRevocationCheck

指示连接不会验证服务器证书上的吊销状态。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SPNPort

指定要追加到远程服务器的连接服务主体名称（SPN）的端口号。身份验证机制为 Kerberos 或 Negotiate 时，将使用 SPN。

类型:	Int32
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-UseUTF16

指示连接以 UTF16 格式而不是 UTF8 格式对请求进行编码。默认值为 UTF8 编码。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

SessionOption

通过