New-WSManSessionOption

创建 WS-Management 会话选项哈希表以用作以下 WS-Management cmdlet 的输入参数: Get-WSManInstance Set-WSManInstance Invoke-WSManAction Connect-WSMan

语法

New-WSManSessionOption [-NoCompression <switch>] [-NoProxy <switch>] [-ProxyAuthentication <string>] [-ProxyPassword <string>] [-ProxyUserName <string>] [-SkipCACheck <switch>] [-SkipCNCheck <switch>] [-SkipRevocation <switch>] [-SPNPort <int>] [-Timeout <int>] [-UnEncrypted <switch>] [-UseIEProxyconfig <switch>] [-UseProxyAutoDetection <switch>] [-UseWinHTTPProxyConfig <switch>] [-UTF16 <switch>] [<CommonParameters>]

说明

创建可以传递给以下 WSMan cmdlet 的 WSMan 会话选项哈希表:

Get-WSManInstance

Set-WSManInstance

Invoke-WSManAction

Connect-WSMan

参数

-NoCompression <switch>

关闭会话中的数据包压缩。默认情况下将启用压缩,对在客户端和服务器之间发送的数据包将进行压缩。压缩会占用更多的处理器周期,但可以提高传输速度。

是否为必需?

false

位置?

named

默认值

False

是否接受管道输入?

false

是否接受通配符?

false

-NoProxy <switch>

不使用代理服务器。所有主机名都将在本地解析。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-ProxyAuthentication <string>

指定在代理中使用的身份验证方法。可能值为:

- Basic:Basic 是一种方案,在该方案中,用户名和密码以明文形式发送到服务器或代理。

- Digest:Digest 是一种质询响应方案,该方案将服务器指定的数据字符串用于质询。

- Negotiate(默认值):Negotiate 是一种质询响应方案,该方案与服务器或代理协商以确定使用哪种身份验证方案。例如,Kerberos 协议和 NTLM。

是否为必需?

false

位置?

named

默认值

Negotiate

是否接受管道输入?

false

是否接受通配符?

false

-ProxyPassword <string>

指定要用于代理身份验证的密码。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-ProxyUserName <string>

指定要用于代理身份验证的用户名。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-SkipCACheck <switch>

指定当通过 HTTPS 连接时,客户端不验证服务器证书是否已由受信任的证书颁发机构 (CA) 签名。仅当远程计算机通过其他方式被证明可信(例如,远程计算机所属的网络在物理上是安全的并已隔离,或者远程计算机在 WS-Management 配置中列为受信任主机)时才应使用此选项。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-SkipCNCheck <switch>

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

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-SkipRevocation <switch>

不验证服务器证书的吊销状态。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-SPNPort <int>

指定要在远程服务器的连接服务主体名称 <SPN> 后追加的端口号。当身份验证机制为 Kerberos 或 Negotiate 时使用 SPN。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-Timeout <int>

定义 WS-Management 操作的超时时间(以毫秒为单位)。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-UnEncrypted <switch>

当通过 HTTP 执行远程操作时,不使用加密。

注意:默认情况下不允许未加密的通信,必须在本地配置中启用未加密的通信。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-UseIEProxyconfig <switch>

对当前用户使用 Internet Explorer 代理配置。这是默认设置。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-UseProxyAutoDetection <switch>

强制自动检测代理。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-UseWinHTTPProxyConfig <switch>

使用为 WinHTTP 配置的代理设置。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

-UTF16 <switch>

以 UTF16 格式而不是 UTF8 格式对请求进行编码。默认设置为 UTF8 编码。

是否为必需?

false

位置?

named

默认值

是否接受管道输入?

false

是否接受通配符?

false

<CommonParameters>

此 cmdlet 支持通用参数:-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer 和 -OutVariable。有关详细信息,请参阅 about_Commonparameters.

输入和输出

输入类型是指可通过管道传递给 cmdlet 的对象的类型。返回类型是指 Cmdlet 所返回对象的类型。

输入

输出

SessionOption

另请参阅

概念

Connect-WSMan
Disable-WSManCredSSP
Disconnect-WSMan
Enable-WSManCredSSP
Get-WSManCredSSP
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
Remove-WSManInstance
Set-WSManInstance
Set-WSManQuickConfig
Test-WSMan