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 平台上可用。
cmdlet New-WSManSessionOption
创建可传递给 WSMan cmdlet 的 WSMan 会话选项哈希表:
Get-WSManInstance
Set-WSManInstance
Invoke-WSManAction
Connect-WSMan
示例
示例 1:Create使用连接选项的连接
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 进行远程操作。
默认情况下,未加密的流量未启用。 必须在本地配置中启用它。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OperationTimeout
指定 WS-Management 操作的超时(以毫秒为单位)。
Type: | Int32 |
Aliases: | OperationTimeoutMSec |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAccessType
指定代理服务器定位所依据的机制。 此参数的可接受值为:
ProxyIEConfig
- 使用当前用户的 Internet Explorer 代理配置。ProxyWinHttpConfig
- WSMan 客户端使用通过 ProxyCfg.exe 实用工具为 WinHTTP 配置的代理设置。ProxyAutoDetect
- 强制自动检测代理服务器。ProxyNoProxyServer
- 请勿使用代理服务器。 在本地解析所有主机名。
默认值为 ProxyIEConfig。
Type: | ProxyAccessType |
Accepted values: | ProxyIEConfig, ProxyWinHttpConfig, ProxyAutoDetect, ProxyNoProxyServer |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyAuthentication
指定要在代理中使用的身份验证方法。 此参数的可接受值为:
Basic
- 基本是一种方案,其中用户名和密码以明文形式发送到服务器或代理。Digest
- 摘要是质询-响应方案,它使用服务器指定的数据字符串进行质询。Negotiate
- 协商是一种质询-响应方案,它与服务器或代理协商以确定用于身份验证的方案。 例如,Kerberos 协议和 NTLM。
默认值为 Negotiate。
Type: | ProxyAuthentication |
Accepted values: | Negotiate, Basic, Digest |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ProxyCredential
指定有权通过中间 Web 代理获取访问权限的用户帐户。
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipCACheck
指定通过 HTTPS 进行连接时,客户端不会验证服务器证书是否由受信任的证书颁发机构 (CA) 签名。 仅当远程计算机受到其他方法的信任时,才使用此选项,例如,如果远程计算机是物理上安全且隔离的网络的一部分,或者远程计算机在 WS-Management 配置中列为受信任的主机。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipCNCheck
指定服务器的证书公用名 (CN) 不必与服务器的主机名匹配。 这仅用于使用 HTTPS 的远程操作。 此选项应仅用于受信任的计算机。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipRevocationCheck
指示连接不会验证服务器证书上的吊销状态。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SPNPort
指定要追加到远程服务器的连接服务主体名称 (SPN) 的端口号。 当身份验证机制是 Kerberos 或 Negotiate 时,使用 SPN。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseUTF16
指示连接以 UTF16 格式而不是 UTF8 格式对请求进行编码。 默认值为 UTF8 编码。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输出
此 cmdlet 将创建的 WSMan 会话选项作为 SessionOption 对象返回。