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

[玩转系统] 获取 CimAssociatedInstance (CimCmdlet)

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

获取 CimAssociatedInstance (CimCmdlet)

获取 CimAssociatedInstance

模块 ：CimCmdlets

检索通过关联连接到特定 CIM 实例的 CIM 实例。

句法

Get-CimAssociatedInstance
   [[-Association] <String>]
   [-ResultClassName <String>]
   [-InputObject] <CimInstance>
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-ResourceUri <Uri>]
   [-ComputerName <String[]>]
   [-KeyOnly]
   [<CommonParameters>]
Get-CimAssociatedInstance
   [[-Association] <String>]
   [-ResultClassName <String>]
   [-InputObject] <CimInstance>
   [-Namespace <String>]
   [-OperationTimeoutSec <UInt32>]
   [-ResourceUri <Uri>]
   -CimSession <CimSession[]>
   [-KeyOnly]
   [<CommonParameters>]

描述

此 cmdlet 仅适用于 Windows 平台。

Get-CimAssociatedInstance cmdlet 检索通过关联连接到特定 CIM 实例（称为源实例）的 CIM 实例。

在关联中，每个 CIM 实例都有一个命名角色，并且同一 CIM 实例可以以不同的角色参与关联。

如果未指定 InputObject 参数，则 cmdlet 将按以下方式之一工作：

  • 如果既未指定 ComputerName 参数，也未指定 CimSession 参数，则此 cmdlet 将在使用组件对象模型 (COM) 会话的本地 Windows Management Instrumentation (WMI) 上运行。
  • 如果指定了 ComputerName 参数或 CimSession 参数，则此 cmdlet 将针对由 ComputerName 参数或 ComputerName 指定的 CIM 服务器运行。CimSession 参数。

示例

示例1：获取特定实例的所有关联实例

$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1]

这组命令检索名为 Win32_LogicalDisk 的类的实例，并使用 Get-CimInstance cmdlet 将信息存储在名为 $disk 的变量中。然后，变量中的第一个逻辑磁盘实例将用作 Get-CimassociatedInstance cmdlet 的输入对象，以获取指定 CIM 实例的所有关联 CIM 实例。

示例 2：获取特定类型的所有关联实例

$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition

这组命令检索 Win32_LogicalDisk 类的所有实例，并将它们存储在名为 $disk 的变量中。然后，变量中的第一个逻辑磁盘实例用作 Get-CimassociatedInstance cmdlet 的输入对象，以获取通过指定关联类 Win32_DiskPartition 关联的所有关联实例。

示例3：通过特定类的限定符获取所有关联实例

这组命令检索依赖于 Winmgmt 服务的服务并将它们存储在名为 $s 的变量中。 Get-CimAssociatedInstance 获取检索到的关联类的关联实例。

$s = Get-CimInstance -Query "Select * from Win32_Service where name like 'Winmgmt'"
Get-CimAssociatedInstance -InputObject $s -Association Win32_DependentService

ProcessId Name            StartMode State   Status ExitCode
--------- ----            --------- -----   ------ --------
1716      RpcSs           Auto      Running OK     0
9964      CcmExec         Auto      Running OK     0
0         HgClientService Manual    Stopped OK     1077
0         smstsmgr        Manual    Stopped OK     1077
3396      vmms            Auto      Running OK     0

参数

-Association

指定关联类的名称。如果不指定此参数，cmdlet 将返回任何类型的所有现有关联对象。

例如，如果类 A 通过两个关联（AB1 和 AB2）与类 B 关联，则该参数可用于指定关联类型：AB1 或 AB2。

类型 ：

String

位置：

1

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-CimSession

使用指定的 CIM 会话运行命令。输入包含 CIM 会话的变量，或创建或获取 CIM 会话的命令，例如 New-CimSession 或 Get-CimSession。有关详细信息，请参阅 about_CimSession。

类型 ：

CimSession[]

位置：

命名

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

False

-ComputerName

指定要运行 CIM 操作的计算机的名称。您可以指定完全限定域名 (FQDN) 或 NetBIOS 名称。

如果指定此参数，cmdlet 将使用 WsMan 协议创建到指定计算机的临时会话。

如果不指定此参数，cmdlet 将使用组件对象模型 (COM) 在本地计算机上执行操作。

如果在同一台计算机上执行多个操作，使用 CIM 会话进行连接可提供更好的性能。

类型 ：

String[]

别名：

CN, ServerName

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-InputObject

指定此 cmdlet 的输入。您可以使用此参数，也可以通过管道将输入传递到此 cmdlet。

InputObject 参数不会枚举集合。如果传递了集合，则会引发错误。使用集合时，通过管道输入以枚举值。

类型 ：

CimInstance

别名：

CimInstance

位置：

0

默认值：

None

必需的：

True

接受管道输入：

True

接受通配符：

False

-KeyOnly

返回仅填充关键属性的对象。这减少了通过网络传输的数据量。

类型 ：

SwitchParameter

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

False

接受通配符：

False

-Namespace

指定 CIM 操作的命名空间。默认命名空间是 root/cimv2。

笔记

您可以使用制表符补全来浏览命名空间列表，因为 PowerShell 从本地 WMI 服务器获取命名空间列表来提供命名空间列表。

类型 ：

String

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-OperationTimeoutSec

指定 cmdlet 等待计算机响应的时间。默认情况下，此参数的值为 0，这意味着 cmdlet 使用服务器的默认超时值。

如果 OperationTimeoutSec 参数设置为小于 3 分钟的稳健连接重试超时的值，则持续时间超过 OperationTimeoutSec 参数值的网络故障将无法恢复，因为在客户端重新连接之前服务器上的操作超时。

类型 ：

UInt32

别名：

OT

位置：

命名

默认值：

None

必需的：

False

接受管道输入：

True

接受通配符：

False

-ResourceUri

指定资源类或实例的资源统一资源标识符 (URI)。 URI 用于标识计算机上特定类型的资源，例如磁盘或进程。

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

    http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
    http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings

    默认情况下，如果您不指定此参数，则使用 DMTF 标准资源 URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/类名附加到它后面。

    ResourceURI 只能与使用 WSMan 协议创建的 CIM 会话一起使用，或者在指定 ComputerName 参数（这将使用 WSMan 创建 CIM 会话）时使用。如果指定此参数而不指定 ComputerName 参数，或者指定使用 DCOM 协议创建的 CIM 会话，则会出现错误，因为 DCOM 协议不支持 ResourceURI强>参数。

    如果同时指定了 ResourceUri 参数和 Filter 参数，则忽略 Filter 参数。

    类型 ：

    乌里

    位置：

    命名

    默认值：

    None

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    -ResultClassName

    指定关联实例的类名。一个 CIM 实例可以与一个或多个 CIM 实例关联。如果不指定结果类名称，则会返回所有关联的 CIM 实例。

    默认情况下，该参数的值为空，并返回所有关联的 CIM 实例。

    您可以过滤关联结果以匹配特定的类名称。过滤发生在服务器上。如果未指定此参数，Get-CIMAssociatedInstance 将返回所有现有关联。例如，如果 A 类与 B、C 和 D 类关联，则此参数可用于将输出限制为特定类型（B、C 或 D）。

    类型 ：

    String

    位置：

    命名

    默认值：

    None

    必需的：

    False

    接受管道输入：

    False

    接受通配符：

    False

    输入

    无

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

    输出

    CimInstance

    此 cmdlet 返回 CIM 实例对象。

    笔记

    PowerShell 包含 Get-CimAssociatedInstance 的以下别名：

    • Windows:

        gcai

      此 cmdlet 仅在 Windows 平台上可用。

      猜你还喜欢

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

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

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

        关灯