Get-CimAssociatedInstance
Ruft die CIM-Instanzen ab, die durch eine Zuordnung mit einer bestimmten CIM-Instanz verbunden sind.
Syntax
ComputerSet (Standardwert)
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>]
Beschreibung
Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.
Das Cmdlet Get-CimAssociatedInstance ruft die CIM-Instanzen ab, die mit einer bestimmten CIM-Instanz verbunden sind, die als Quellinstanz bezeichnet wird, durch eine Zuordnung.
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 parameter InputObject 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 lokale Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI).
- Wenn entweder der Parameter ComputerName oder der Parameter CimSession angegeben ist, funktioniert dieses Cmdlet mit dem CIM-Server, der durch entweder den Parameter ComputerName oder CimSession 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 namens $disk mithilfe des cmdlets Get-CimInstance. Die erste logische Datenträgerinstanz in der Variablen wird dann als Eingabeobjekt für das Cmdlet Get-CimAssociatedInstance 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 mit dem Namen $disk. Die erste logische Datenträgerinstanz in der Variablen wird dann als Eingabeobjekt für das Cmdlet Get-CimAssociatedInstance verwendet, um alle zugeordneten Instanzen abzurufen, die über die angegebene Zuordnungsklasse zugeordnet sind Win32_DiskPartition.
Beispiel 3: Abrufen aller zugeordneten Instanzen über den Qualifizierer einer bestimmten Klasse
Dieser Satz von Befehlen ruft die Dienste ab, die vom Winmgmt--Dienst abhängen, und speichert sie in einer Variablen namens $s.
Get-CimAssociatedInstance ruft die zugeordneten Instanzen der abgerufenen Zuordnungsklasse ab.
$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
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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | 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. B. New-CimSession oder Get-CimSession. Weitere Informationen finden Sie unter about_CimSession.
Parametereigenschaften
| Typ: | |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
SessionSet
| Position: | Named |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ComputerName
Gibt den Namen des Computers an, auf dem Der CIM-Vorgang ausgeführt werden soll. Sie können einen vollqualifizierten Domänennamen (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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | China, Servername |
Parametersätze
ComputerSet
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-InputObject
Gibt die Eingabe für dieses Cmdlet an. Sie können diesen Parameter verwenden oder die Eingabe an dieses Cmdlet weiterleiten.
Der Parameter InputObject listet keine Sammlungen auf. Wenn eine Sammlung übergeben wird, wird ein Fehler ausgelöst. Wenn Sie mit Sammlungen arbeiten, leiten Sie die Eingaben weiter, um die Werte aufzulisten.
Parametereigenschaften
| Typ: | CimInstance |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | CimInstance |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | True |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-KeyOnly
Gibt Objekte zurück, deren Schlüsseleigenschaften nur ausgefüllt sind. Dadurch wird die Datenmenge reduziert, die über das Netzwerk übertragen wird.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Namespace
Gibt den Namespace für den CIM-Vorgang an. Der Standardnamespace ist root/CIMV2.
Hinweis
Sie können die Registerkartenvervollständigung verwenden, um die Liste der Namespaces zu durchsuchen, da PowerShell eine Liste der Namespaces vom lokalen WMI-Server abruft, um die Liste der Namespaces bereitzustellen.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | 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 OperationTimeoutSec Parameter auf einen Wert festgelegt ist, der kleiner als das robuste Verbindungsretrytimeout von 3 Minuten ist, können Netzwerkfehler, die mehr als den Wert des OperationTimeoutSec Parameter dauern, nicht wiederhergestellt werden, da der Vorgang auf dem Server zu einem Timeout vor dem erneuten Verbinden des Clients führen kann.
Parametereigenschaften
| Typ: | UInt32 |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
| Aliase: | OT |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ResourceUri
Gibt den URI (Uniform Resource Identifier) der Ressourcenklasse oder -instanz an. Der URI wird verwendet, um einen bestimmten Ressourcentyp zu identifizieren, z. B. Datenträger oder Prozesse, auf einem Computer.
Ein URI besteht aus einem Präfix und einem Pfad zu einer Ressource. Beispiel:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDiskhttp://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings
Wenn Sie diesen Parameter nicht angeben, wird standardmäßig der DMTF-Standardressourcen-URI verwendet, http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ verwendet wird und der Klassenname an ihn angefügt wird.
ResourceUri- kann nur mit CIM-Sitzungen verwendet werden, die mit dem WSMan-Protokoll erstellt wurden, oder wenn sie den ComputerName Parameter angeben, der eine CIM-Sitzung mit WSMan erstellt. Wenn Sie diesen Parameter angeben, ohne den parameter ComputerName anzugeben, oder wenn Sie 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.
Parametereigenschaften
| Typ: | Uri |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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, gibt Get-CimAssociatedInstance alle vorhandenen Zuordnungen zurück. 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.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
Eingaben
None
Sie können keine Objekte an dieses Cmdlet weiterleiten.
Ausgaben
CimInstance
Dieses Cmdlet gibt ein CIM-Instanzobjekt zurück.
Hinweise
PowerShell enthält die folgenden Aliase für Get-CimAssociatedInstance:
- Fenster:
gcai
Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.
