New-WSManSessionOption

创建会话选项哈希表以用作 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 cmdlet 的 WSMan 会话选项哈希表:

  • 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 远程计算机。

通常在 WSMan 提供程序的上下文中使用 Connect-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 客户端使用通过 ProxyCfg.exe 实用工具针对 WinHTTP 配置的代理设置。
  • ProxyAutoDetect - 强制自动检测代理服务器。
  • ProxyNoProxyServer - 不使用代理服务器。 在本地解析所有主机名。

默认值为 ProxyIEConfig。

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

-ProxyAuthentication

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

  • Basic - Basic 是一种将用户名和密码以明文形式发送到服务器或代理的方案。
  • Digest - Digest 是一种质询响应方案,该方案将服务器指定的数据字符串用于质询。
  • Negotiate - 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

此 cmdlet 将创建的 WSMan 会话选项作为 SessionOption 对象返回。