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