Get-CimAssociatedInstance

Синтаксис

ComputerSet (по умолчанию)

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

SessionSet

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

Описание

Примеры

Пример 1. Получение всех связанных экземпляров конкретного экземпляра

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

Пример 2. Получение всех связанных экземпляров определенного типа

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

Пример 3. Получение всех связанных экземпляров с помощью квалификатора определенного класса

$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

Указывает имя класса ассоциации. Если этот параметр не указан, командлет возвращает все существующие объекты ассоциации любого типа.

Например, если класс A связан с классом B через две связи, AB1 и AB2, этот параметр можно использовать для указания типа ассоциации либо AB1, либо AB2.

Свойства параметра

Наборы параметров

-CimSession

Выполняет команду с помощью указанного сеанса CIM. Введите переменную, содержащую сеанс CIM, или команду, которая создает или получает сеанс CIM, например New-CimSession или Get-CimSession. Дополнительные сведения см. в разделе about_CimSession.

Свойства параметра

Наборы параметров

-ComputerName

Указывает имя компьютера, на котором требуется выполнить операцию CIM. Можно указать полное доменное имя (FQDN) или имя NetBIOS.

При указании этого параметра командлет создает временный сеанс для указанного компьютера с помощью протокола WsMan.

Если этот параметр не указан, командлет выполняет операцию на локальном компьютере с помощью объектной модели компонента (COM).

Если на одном компьютере выполняются несколько операций, подключение с помощью сеанса CIM обеспечивает более высокую производительность.

Свойства параметра

Наборы параметров

-InputObject

Указывает входные данные для этого командлета. Этот параметр можно использовать или передать входные данные в этот командлет.

Параметр InputObject не перечисляет коллекции. В случае передачи коллекции возникает ошибка. При работе с коллекциями направьте входные данные для перечисления значений.

Свойства параметра

Наборы параметров

-KeyOnly

Возвращает объекты с заполненными только ключевыми свойствами. Это уменьшает объем данных, передаваемых по сети.

Свойства параметра

Наборы параметров

-Namespace

Указывает пространство имен для операции CIM. Пространство имен по умолчанию — корневой/CIMV2.

Свойства параметра

Наборы параметров

-OperationTimeoutSec

Указывает период времени, в течение которого командлет ожидает ответа от компьютера. По умолчанию значение этого параметра равно 0, что означает, что командлет использует значение времени ожидания по умолчанию для сервера.

Если параметр OperationTimeoutSec имеет значение меньше времени ожидания надежного повтора подключения в течение 3 минут, сетевые сбои, которые длились больше значения параметра OperationTimeoutSec не восстанавливаются, так как операция на сервере истекает до повторного подключения клиента.

Свойства параметра

Наборы параметров

-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

По умолчанию, если этот параметр не указан, используется стандартный URI ресурса DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ и имя класса добавляется к нему.

ResourceUri можно использовать только с сеансами CIM, созданными с помощью протокола WSMan, или при указании параметра ComputerName, который создает сеанс CIM с помощью WSMan. Если этот параметр указан без указания параметра ComputerName или при указании сеанса CIM, созданного с помощью протокола DCOM, возникает ошибка, так как протокол DCOM не поддерживает параметр ResourceUri.

Если заданы и параметр ResourceUri, и параметр фильтра, параметр фильтра игнорируется.

Свойства параметра

Наборы параметров

-ResultClassName

Указывает имя класса связанных экземпляров. Экземпляр CIM может быть связан с одним или несколькими экземплярами CIM. Все связанные экземпляры CIM возвращаются, если не указать имя класса результатов.

По умолчанию значение этого параметра равно NULL, и возвращаются все связанные экземпляры CIM.

Результаты сопоставления можно отфильтровать, чтобы соответствовать определенному имени класса. Фильтрация происходит на сервере. Если этот параметр не указан, Get-CimAssociatedInstance возвращает все существующие связи. Например, если класс A связан с классами B, C и D, этот параметр можно использовать для ограничения выходных данных определенным типом (B, C или D).

Свойства параметра

Наборы параметров

CommonParameters

Входные данные

None

Выходные данные

CimInstance

Примечания

Связанные ссылки

• Get-CimClass
• Get-CimInstance