Freigeben über

Get-CimAssociatedInstance

  • Referenz
Modul:
CimCmdlets

Ruft die CIM-Instanzen ab, die durch eine Zuordnung mit einer bestimmten CIM-Instanz verbunden sind.

Syntax

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>]

Beschreibung

Das Get-CimAssociatedInstance Cmdlet ruft die CIM-Instanzen ab, die mit einer bestimmten CIM-Instanz verbunden sind, die von einer Zuordnung als Quellinstanz bezeichnet wird.

In einer Zuordnung verfügt jede CIM-Instanz über eine benannte Rolle, und dieselbe CIM-Instanz kann an einer Zuordnung in verschiedenen Rollen teilnehmen.

Wenn der InputObject-Parameter nicht angegeben ist, funktioniert das Cmdlet auf eine der folgenden Arten:

  • Wenn weder der Parameter ComputerName noch der CimSession-Parameter angegeben ist, funktioniert dieses Cmdlet unter Verwendung einer COM-Sitzung (Component Object Model) für die lokale Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI).
  • Wenn entweder der Parameter ComputerName oder der CimSession-Parameter angegeben ist, funktioniert dieses Cmdlet mit dem CIM-Server, der entweder durch den ComputerName-Parameter oder den CimSession-Parameter angegeben wird.

Beispiele

Beispiel 1: Abrufen aller zugeordneten Instanzen einer bestimmten Instanz

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

Diese Gruppe von Befehlen ruft die Instanzen der Klasse mit dem Namen Win32_LogicalDisk ab und speichert die Informationen in einer Variablen mit dem $diskGet-CimInstance Cmdlet. Die erste logische Datenträgerinstanz in der Variablen wird dann als Eingabeobjekt für das Get-CimAssociatedInstance Cmdlet verwendet, um alle zugeordneten CIM-Instanzen der angegebenen CIM-Instanz abzurufen.

Beispiel 2: Abrufen aller zugeordneten Instanzen eines bestimmten Typs

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

Dieser Satz von Befehlen ruft alle Instanzen der Win32_LogicalDisk Klasse ab und speichert sie in einer Variablen namens $disk. Die erste logische Datenträgerinstanz in der Variablen wird dann als Eingabeobjekt für das Get-CimAssociatedInstance Cmdlet verwendet, um alle zugeordneten Instanzen abzurufen, die über die angegebene Zuordnungsklasse Win32_DiskPartition zugeordnet sind.

Beispiel 3: Abrufen aller zugeordneten Instanzen über den Qualifizierer einer bestimmten Klasse

$s = Get-CimInstance -Query "Select * from Win32_Service where name like 'Winmgmt'"
Get-CimClass -ClassName *Service* -Qualifier "Association"
$c.CimClasName

Win32_LoadOrderGroupServiceDependencies
Win32_DependentService
Win32_SystemServices
Win32_LoadOrderGroupServiceMembers
Win32_ServiceSpecificationService

Get-CimAssociatedInstance -InputObject $s -Association Win32_DependentService

Dieser Satz von Befehlen ruft die Dienste ab, die vom WMI-Dienst abhängen, und speichert sie in einer Variablen namens $s. Der Zuordnungsklassenname für die Win32_DependentService wird mithilfe des Get-CimClassCmdlets abgerufen, indem "Association" als Qualifizierer angegeben wird und dann mit $s an das Get-CimAssociatedInstance Cmdlet übergeben wird, um alle zugeordneten Instanzen der abgerufenen Zuordnungsklasse abzurufen.

Parameter

-Association

Gibt den Namen der Zuordnungsklasse an. Wenn Sie diesen Parameter nicht angeben, gibt das Cmdlet alle vorhandenen Zuordnungsobjekte eines beliebigen Typs zurück.

Wenn beispielsweise Klasse A über zwei Zuordnungen, AB1 und AB2, der Klasse B zugeordnet ist, kann dieser Parameter verwendet werden, um den Typ der Zuordnung anzugeben, entweder AB1 oder AB2.

Type:String
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CimSession

Führt den Befehl mithilfe der angegebenen CIM-Sitzung aus. Geben Sie eine Variable ein, die die CIM-Sitzung enthält, oder einen Befehl, der die CIM-Sitzung erstellt oder abruft, z New-CimSession . B. oder Get-CimSession. Weitere Informationen finden Sie unter about_CimSession.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Gibt den Namen des Computers an, auf dem Der CIM-Vorgang ausgeführt werden soll. Sie können einen vollqualifizierten Do Standard namen (FQDN) oder einen NetBIOS-Namen angeben.

Wenn Sie diesen Parameter angeben, erstellt das Cmdlet mithilfe des WsMan-Protokolls eine temporäre Sitzung auf dem angegebenen Computer.

Wenn Sie diesen Parameter nicht angeben, führt das Cmdlet den Vorgang auf dem lokalen Computer mithilfe des Component Object Model (COM) aus.

Wenn mehrere Vorgänge auf demselben Computer ausgeführt werden, bietet die Verbindung mit einer CIM-Sitzung eine bessere Leistung.

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Gibt die Eingabe für dieses Cmdlet an. Sie können diesen Parameter verwenden oder die Eingabe an dieses Cmdlet weiterleiten.

Der InputObject-Parameter enumeriert keine Auflistungen. Wenn eine Auflistung übergeben wird, wird ein Fehler ausgelöst. Wenn Sie mit Sammlungen arbeiten, führen Sie die Eingabe weiter, um die Werte aufzählen zu können.

Type:CimInstance
Aliases:CimInstance
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyOnly

Gibt Objekte zurück, deren Schlüsseleigenschaften nur ausgefüllt sind. Dadurch wird die Datenmenge reduziert, die über das Netzwerk übertragen wird.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

Gibt den Namespace für den CIM-Vorgang an. Der Standardnamespace ist root/cimv2.

Hinweis

Sie können die Registerkartenabschluss verwenden, um die Liste der Namespaces zu durchsuchen, da PowerShell eine Liste von Namespaces vom lokalen WMI-Server abruft, um die Liste der Namespaces bereitzustellen.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

Gibt die Zeitspanne an, die das Cmdlet auf eine Antwort vom Computer wartet. Standardmäßig ist der Wert dieses Parameters 0, was bedeutet, dass das Cmdlet den Standardtimeoutwert für den Server verwendet.

Wenn der Parameter OperationTimeoutSec auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungsretrytimeout von 3 Minuten ist, können Netzwerkfehler, die mehr als der Wert des OperationTimeoutSec-Parameters dauern, nicht wiederhergestellt werden, da der Vorgang auf dem Server zu einem Timeout vor dem erneuten Herstellen der Verbindung führen kann.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceUri

Gibt den URI (Uniform Resource Identifier) der Ressourcenklasse oder -instanz an. Der URI wird verwendet, um einen bestimmten Ressourcentyp auf einem Computer zu identifizieren, z. B. Datenträger oder Prozesse.

Ein URI besteht aus einem Präfix und einem Pfad zu einer Ressource. Zum Beispiel:

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

Wenn Sie diesen Parameter nicht angeben, wird standardmäßig der DMTF-Standardressourcen-URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ verwendet, und der Klassenname wird an ihn angefügt.

ResourceURI kann nur mit CIM-Sitzungen verwendet werden, die mit dem WSMan-Protokoll erstellt wurden, oder beim Angeben des ComputerName-Parameters , der eine CIM-Sitzung mit WSMan erstellt. Wenn Sie diesen Parameter ohne Angabe des ComputersName-Parameters angeben oder eine MIT DCOM-Protokoll erstellte CIM-Sitzung angeben, wird ein Fehler angezeigt, da das DCOM-Protokoll den ResourceURI-Parameter nicht unterstützt.

Wenn sowohl der Parameter "ResourceUri" als auch der Parameter "Filter" angegeben werden, wird der Parameter "Filter" ignoriert.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResultClassName

Gibt den Klassennamen der zugeordneten Instanzen an. Eine CIM-Instanz kann einer oder mehreren CIM-Instanzen zugeordnet werden. Alle zugehörigen CIM-Instanzen werden zurückgegeben, wenn Sie den Namen der Ergebnisklasse nicht angeben.

Standardmäßig ist der Wert dieses Parameters null, und alle zugehörigen CIM-Instanzen werden zurückgegeben.

Sie können die Zuordnungsergebnisse nach einem bestimmten Klassennamen filtern. Das Filtern erfolgt auf dem Server. Wenn dieser Parameter nicht angegeben ist, Get-CIMAssociatedInstance werden alle vorhandenen Zuordnungen zurückgegeben. Wenn beispielsweise Klasse A den Klassen B, C und D zugeordnet ist, kann dieser Parameter verwendet werden, um die Ausgabe auf einen bestimmten Typ (B, C oder D) zu beschränken.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

CimInstance

Dieses Cmdlet gibt ein CIM-Instanzobjekt zurück.