当前位置:网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] 新-WSManSessionOption (Microsoft.WSMan.Management)

作者:精品下载站 日期:2024-12-14 02:01:27 浏览:17 分类:玩电脑

新-WSManSessionOption (Microsoft.WSMan.Management)


新-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 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 计算机。

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

    参数

    -NoEncryption

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

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

    类型 :

    SwitchParameter

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    -OperationTimeout

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

    类型 :

    整数32

    别名:

    OperationTimeoutMSec

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    -ProxyAccessType

    指定代理服务器的定位机制。该参数可接受的值为:

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

    默认值为 ProxyIEConfig。

    类型 :

    代理访问类型

    接受的值:

    ProxyIEConfig、ProxyWinHttpConfig、ProxyAutoDetect、ProxyNoProxyServer

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    -ProxyAuthentication

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

    • Basic - Basic 是一种将用户名和密码以明文形式发送到服务器或代理的方案。
    • Digest - 摘要是一种质询-响应方案,它使用服务器指定的数据字符串进行质询。
    • 协商 - 协商是一种质询-响应方案,它与服务器或代理协商以确定使用哪种方案进行身份验证。例如 Kerberos 协议和 NTLM。

    默认值为协商。

    类型 :

    ProxyAuthentication

    接受的值:

    谈判、基础、摘要

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    -ProxyCredential

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

    类型 :

    PS凭证

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    -SkipCACheck

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

    类型 :

    SwitchParameter

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    -SkipCNCheck

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

    类型 :

    SwitchParameter

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    -SkipRevocationCheck

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

    类型 :

    SwitchParameter

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    -SPNPort

    指定附加到远程服务器的连接服务主体名称 (SPN) 的端口号。当身份验证机制为 Kerberos 或 Negotiate 时,将使用 SPN。

    类型 :

    整数32

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    -使用UTF16

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

    类型 :

    SwitchParameter

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    输出

    会话选项

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

    您需要 登录账户 后才能发表评论

    取消回复欢迎 发表评论:

    关灯