登录  |  注册
当前位置：网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] 获取 WSManInstance (Microsoft.WSMan.Management)

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

获取 WSManInstance (Microsoft.WSMan.Management)

获取 WSManInstance

模块 ：Microsoft.WSMan.Management

显示资源 URI 指定的资源实例的管理信息。

句法

Get-WSManInstance
   [-ApplicationName <String>]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Fragment <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-ResourceURI] <Uri>
   [-SelectorSet <Hashtable>]
   [-SessionOption <SessionOption>]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]
Get-WSManInstance
   [-ApplicationName <String>]
   [-BasePropertiesOnly]
   [-ComputerName <String>]
   [-ConnectionURI <Uri>]
   [-Dialect <Uri>]
   [-Enumerate]
   [-Filter <String>]
   [-OptionSet <Hashtable>]
   [-Port <Int32>]
   [-Associations]
   [-ResourceURI] <Uri>
   [-ReturnType <String>]
   [-SessionOption <SessionOption>]
   [-Shallow]
   [-UseSSL]
   [-Credential <PSCredential>]
   [-Authentication <AuthenticationMechanism>]
   [-CertificateThumbprint <String>]
   [<CommonParameters>]

描述

Get-WSManInstance cmdlet 检索由资源统一资源标识符 (URI) 指定的管理资源的实例。检索的信息可以是复杂的 XML 信息集（对象），也可以是简单的值。此 cmdlet 相当于标准 Web Services for Management (WS-Management) Get 命令。

此 cmdlet 使用 WS-Management 连接/传输层来检索信息。

示例

示例1：从WMI获取所有信息

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="winrm"} -ComputerName "Server01"

此命令返回 Windows Management Instrumentation (WMI) 公开的有关远程 server01 计算机上的 WinRM 服务的所有信息。

示例2：获取Spooler服务的状态

Get-WSManInstance -ResourceURI wmicimv2/win32_service -SelectorSet @{name="spooler"} -Fragment Status -ComputerName "Server01"

此命令仅返回远程 server01 计算机上的 Spooler 服务的状态。

示例 3：获取所有服务的端点引用

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/win32_service -ReturnType EPR

此命令返回与本地计算机上的所有服务相对应的端点引用。

示例 4：获取满足指定条件的服务

Get-WSManInstance -Enumerate -ResourceURI wmicimv2/* -Filter "select * from win32_service where StartMode = 'Auto' and State = 'Stopped'" -ComputerName "Server01"

此命令列出远程 Server01 计算机上满足以下条件的所有服务：

  • 该服务的启动类型为自动。
  • 服务已停止。

示例 5：获取与本地计算机上的条件匹配的侦听器配置

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"}

此命令列出本地计算机上与选择器集中的条件匹配的侦听器的 WS-Management 侦听器配置。

示例 6：获取与远程计算机上的条件匹配的侦听器配置

Get-WSManInstance -ResourceURI winrm/config/listener -SelectorSet @{Address="*";Transport="http"} -ComputerName "Server01"

此命令列出远程 server01 计算机上与选择器集中的条件匹配的侦听器的 WS-Management 侦听器配置。

示例7：获取与指定实例相关的关联实例

Get-WSManInstance -Enumerate -Dialect Association -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

此命令获取与指定实例 (winrm) 相关的关联实例。

您必须将过滤器用引号引起来，如示例中所示。

示例8：获取与指定实例相关的关联实例

Get-WSManInstance -Enumerate -Dialect Association -Associations -Filter "{Object=win32_service?name=winrm}" -ResourceURI wmicimv2/*

此命令获取与指定实例 (winrm) 相关的关联实例。由于 Dialect 值为关联，并且使用了 Associations 参数，因此此命令返回关联实例，而不是关联实例。

您必须将过滤器用引号引起来，如示例中所示。

参数

-ApplicationName

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

://:/

例如：

http://server01:8080/WSMAN

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

类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Associations

指示此 cmdlet 获取关联实例，而不是关联实例。仅当 Dialect 参数值为 Association 时才可以使用此参数。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Authentication

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

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

警告

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

类型 ：

AuthenticationMechanism

别名：

auth, am

接受的值：

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

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-BasePropertiesOnly

指示此 cmdlet 仅枚举属于由 ResourceURI 参数指定的基类的一部分的属性。如果指定了Shallow 参数，则此参数无效。

类型 ：

SwitchParameter

别名：

UBPO, Base

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-CertificateThumbprint

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

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

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

类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-ComputerName

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

类型 ：

String

别名：

CN

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-ConnectionURI

指定连接端点。该字符串的格式如下：

://:/

以下字符串是此参数的正确格式值：

http://Server01:8080/WSMAN

URI 必须是完全限定的。

类型 ：

乌里

别名：

CURI, CU

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Credential

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

类型 ：

PS凭证

别名：

cred, c

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-Dialect

指定在过滤谓词中使用的方言。这可以是远程服务支持的任何方言。以下别名可用于方言 URI：

  • WQL - http://schemas.microsoft.com/wbem/wsman/1/WQL
  • 选择器 - http://schemas.microsoft.com/wbem/wsman/1/wsman/SelectorFilter
  • 关联 - http://schemas.dmtf.org/wbem/wsman/1/cimbinding/associationFilter
类型 ：

乌里

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Enumerate

指示此 cmdlet 返回管理资源的所有实例。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

True

接受管道输入：

False

接受通配符：

False

-Filter

指定枚举的过滤表达式。如果指定此参数，则还必须指定方言。

该参数的有效值取决于方言中指定的方言。例如，如果 Dialect 是 WQL，则 Filter 参数必须包含一个字符串，并且该字符串必须包含有效的 WQL 查询，例如以下查询：

"Select * from Win32_Service where State != Running"

如果Dialect是Association，Filter必须包含一个字符串，并且该字符串必须包含一个有效的过滤器，例如以下过滤器：

-filter:Object=EPR\[;AssociationClassName=AssocClassName\]\[;ResultClassName=ClassName\]\[;Role=RefPropertyName\]\[;ResultRole=RefPropertyName\]}
类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Fragment

指定实例内要为指定操作更新或检索的部分。例如，要获取后台打印程序服务的状态，请指定以下内容：

-Fragment Status
类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-OptionSet

指定服务的一组开关以修改或细化请求的性质。这些类似于命令行 shell 中使用的开关，因为它们是特定于服务的。可以指定任意数量的选项。

以下示例演示了为 a、b 和 c 参数传递值 1、2 和 3 的语法：

-OptionSet @{a=1;b=2;c=3}
类型 ：

哈希表

别名：

OS

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-Port

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

当您使用 HTTPS 作为传输时，ComputerName 参数的值必须与服务器的证书公用名 (CN) 匹配。但是，如果将 SkipCNCheck 参数指定为 SessionOption 参数的一部分，则服务器的证书公用名不必与服务器的主机名匹配。 SkipCNCheck 参数应仅用于受信任的计算机。

类型 ：

整数32

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-ResourceURI

指定资源类或实例的 URI。 URI 标识计算机上特定类型的资源，例如磁盘或进程。

URI 由资源的前缀和路径组成。例如：

http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor
类型 ：

乌里

别名：

RURI

位置：

0

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

False

-ReturnType

指定要返回的数据类型。该参数可接受的值为：

    Object
    EPR
    ObjectAndEPR

    默认值为对象。

    如果指定 Object 或不指定此参数，则此 cmdlet 仅返回对象。如果指定端点引用 (EPR)，此 cmdlet 仅返回对象的端点引用。端点引用包含有关资源 URI 和实例选择器的信息。如果指定 ObjectAndEPR，此 cmdlet 将返回对象及其关联的端点引用。

    类型 ：

    String

    别名：

    RT

    接受的值：

    对象、epr、objectandepr

    位置：

    命名

    默认值：

    None

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    -SelectorSet

    指定一组用于选择特定管理资源实例的值对。当存在多个资源实例时，将使用 SelectorSet 参数。 SelectorSet 参数的值必须是哈希表。

    以下示例显示如何为此参数输入值：

    -SelectorSet @{Name="WinRM";ID="yyy"}
    类型 ：

    哈希表

    位置：

    命名

    默认值：

    None

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    -SessionOption

    指定 WS-Management 会话的扩展选项。输入使用 New-WSManSessionOption cmdlet 创建的 SessionOption 对象。有关可用选项的详细信息，请输入 Get-Help New-WSManSessionOption。

    类型 ：

    SessionOption

    别名：

    SO

    位置：

    命名

    默认值：

    None

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    -Shallow

    指示此 cmdlet 仅返回资源 URI 中指定的基类的实例。如果不指定此参数，此 cmdlet 将返回 URI 及其所有派生类中指定的基类的实例。

    类型 ：

    SwitchParameter

    位置：

    命名

    默认值：

    None

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    -UseSSL

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

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

    类型 ：

    SwitchParameter

    别名：

    SSL

    位置：

    命名

    默认值：

    None

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    输入

    无

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

    输出

    XmlElement

    此 cmdlet 返回一个 XMLElement 对象。

    猜你还喜欢

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

    取消回复欢迎 你 发表评论:

    精品推荐！
    欢迎 访客 登录没有账号？
    • 最新文章
    • 热门文章
    • 热评文章
    最新评论
      热门tag
      友情链接

      关灯