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

[玩转系统] 测试-WSMan (Microsoft.WSMan.Management)

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

测试-WSMan (Microsoft.WSMan.Management)


测试-WSMan

模块 :Microsoft.WSMan.Management

测试 WinRM 服务是否正在本地或远程计算机上运行。

句法

Test-WSMan
    [[-ComputerName] <String>]
    [-Authentication <AuthenticationMechanism>]
    [-Port <Int32>]
    [-UseSSL]
    [-ApplicationName <String>]
    [-Credential <PSCredential>]
    [-CertificateThumbprint <String>]
    [<CommonParameters>]

描述

此 cmdlet 仅适用于 Windows 平台。

Test-WSMan cmdlet 提交一个识别请求,确定 WinRM 服务是在本地计算机还是远程计算机上运行。如果测试的计算机正在运行该服务,则 cmdlet 将显示测试服务的 WS-Management 身份架构、协议版本、产品供应商和产品版本。

示例

示例 1:确定 WinRM 服务的状态

Test-WSMan

此命令确定 WinRM 服务是在本地计算机上还是在远程计算机上运行。

示例 2:确定远程计算机上 WinRM 服务的状态

Test-WSMan -ComputerName "server01"

此命令确定 WinRM 服务是否正在 server01 计算机上运行。

示例3:确定WinRM服务的状态和操作系统版本

Test-WSMan -Authentication default

此命令使用身份验证参数测试本地计算机上是否正在运行 WS-Management (WinRM) 服务。

使用身份验证参数使 Test-WSMan 能够返回操作系统版本。

示例 4:确定远程计算机上 WinRM 服务的状态和操作系统版本

Test-WSMan -ComputerName "server01" -Authentication default

此命令使用身份验证参数测试 WS-Management (WinRM) 服务是否正在名为 server01 的计算机上运行。

使用身份验证参数使 Test-WSMan 能够返回操作系统版本。

参数

-ApplicationName

指定连接中的应用程序名称。 ApplicationName 参数的默认值为 WSMAN。远程端点的完整标识符采用以下格式:

<Transport>://<Server>:<Port>/<ApplicationName>

例如:

http://server01:8080/WSMAN

托管会话的 Internet 信息服务 (IIS) 将此终结点的请求转发到指定的应用程序。 WSMAN 的此默认设置适合大多数用途。如果许多计算机与运行 Windows PowerShell 的一台计算机建立远程连接,则可以使用此参数。在这种情况下,IIS 托管 Web 管理服务 (WS-Management) 以提高效率。

类型 :

String

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-Authentication

指定要在服务器上使用的身份验证机制。该参数可接受的值为:

  • Basic - Basic 是一种将用户名和密码以明文形式发送到服务器或代理的方案。
  • 默认 - 使用 WS-Management 协议实现的身份验证方法。这是默认设置。
  • 1 - 摘要是一种质询-响应方案,它使用服务器指定的数据字符串进行质询。
  • Kerberos - 客户端计算机和服务器使用 Kerberos 证书进行相互身份验证。
  • 协商 - 协商是一种质询-响应方案,它与服务器或代理协商以确定用于身份验证的方案。例如,此参数值允许协商以确定是使用 Kerberos 协议还是 NTLM。
  • CredSSP - 使用凭据安全支持提供程序 (CredSSP) 身份验证,允许用户委托凭据。此选项专为在一台远程计算机上运行但从其他远程计算机收集数据或在其他远程计算机上运行其他命令的命令而设计。

警告

CredSSP 将用户凭据从本地计算机委托给远程计算机。这种做法增加了远程操作的安全风险。如果远程计算机受到威胁,当凭据传递给它时,该凭据可用于控制网络会话。

这很重要

如果不指定 Authentication 参数,Test-WSMan 请求将匿名发送到远程计算机,而不使用身份验证。如果请求是匿名发出的,则它不会返回特定于操作系统版本的信息。相反,此 cmdlet 显示操作系统版本和服务包级别的空值 (OS: 0.0.0 SP: 0.0)。

类型 :

AuthenticationMechanism

别名:

auth, am

接受的值:

无、默认、摘要、协商、基本、Kerberos、ClientCertificate、Credssp

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-CertificateThumbprint

指定有权执行此操作的用户帐户的数字公钥证书 (X509)。输入证书的证书指纹。

证书用于基于客户端证书的身份验证。它们只能映射到本地用户帐户;它们不适用于域帐户。

要获取证书指纹,请在 Windows PowerShell Cert: 驱动器中使用 Get-Item 或 Get-ChildItem 命令。

类型 :

String

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-ComputerName

指定要对其运行管理操作的计算机。该值可以是完全限定的域名、NetBIOS 名称或 IP 地址。使用本地计算机名称、使用 localhost 或使用点 (.) 指定本地计算机。默认为本地计算机。当远程计算机与用户位于不同的域时,必须使用完全限定的域名。您可以将此参数的值通过管道传递给 cmdlet。

类型 :

String

别名:

cn

位置:

0

默认值:

None

必需的:

False

接受管道输入:

True

接受通配符:

False

-Credential

指定有权执行此操作的用户帐户。默认为当前用户。键入用户名,例如 User01、Domain01\User01 或 [email protected]。或者,输入 PSCredential 对象,例如 Get-Credential cmdlet 返回的对象。当您键入用户名时,此 cmdlet 会提示您输入密码。

类型 :

PS凭证

别名:

cred, c

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

True

接受通配符:

False

-Port

指定客户端连接到 WinRM 服务时要使用的端口。当传输方式为 HTTP 时,默认端口为 80。当传输方式为 HTTPS 时,默认端口为 443。

当您使用 HTTPS 作为传输时,ComputerName 参数的值必须与服务器的证书公用名 (CN) 匹配。

类型 :

整数32

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-UseSSL

指定使用安全套接字层 (SSL) 协议建立与远程计算机的连接。默认情况下,不使用 SSL。

WS-Management 对通过网络传输的所有 Windows PowerShell 内容进行加密。 UseSSL 参数允许您指定 HTTPS 而不是 HTTP 的附加保护。如果 SSL 在用于连接的端口上不可用,并且您指定了此参数,则该命令将失败。

类型 :

SwitchParameter

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

输入

您无法将对象通过管道传输到此 cmdlet。

输出

XmlElement

此 cmdlet 返回一个表示测试结果的 XmlElement 对象。

笔记

默认情况下,Test-WSMan cmdlet 查询 WinRM 服务而不使用身份验证,并且它不返回特定于操作系统版本的信息。相反,它显示操作系统版本和服务包级别的空值(OS:0.0.0 SP:0.0)。

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

取消回复欢迎 发表评论:

关灯