Get-CimAssociatedInstance (CimCmdlets)

Get-CimAssociatedInstance

Modul:

CimCmdlets

Ruft die CIM-Instanzen ab, die über 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

Dieses Cmdlet ist nur auf der Windows-Plattform verfügbar.

Das Cmdlet Get-CimAssociatedInstance ruft die CIM-Instanzen ab, die über eine Zuordnung mit einer bestimmten CIM-Instanz, der sogenannten Quellinstanz, verbunden sind.

In einer Zuordnung hat jede CIM-Instanz eine benannte Rolle und dieselbe CIM-Instanz kann in verschiedenen Rollen an einer Zuordnung teilnehmen.

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

• Wenn weder der Parameter ComputerName noch der Parameter CimSession angegeben ist, funktioniert dieses Cmdlet auf der lokalen Windows Management Instrumentation (WMI) unter Verwendung einer Component Object Model (COM)-Sitzung.
• Wenn entweder der Parameter ComputerName oder der Parameter CimSession angegeben ist, funktioniert dieses Cmdlet mit dem CIM-Server, der entweder durch den Parameter ComputerName oder < angegeben istCimSession-Parameter.

Beispiele

Beispiel 1: Rufen Sie alle zugehörigen Instanzen einer bestimmten Instanz ab

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

Dieser Befehlssatz ruft die Instanzen der Klasse Win32_LogicalDisk ab und speichert die Informationen mithilfe des Cmdlets Get-CimInstance in einer Variablen namens $disk. Die erste logische Festplatteninstanz in der Variablen wird dann als Eingabeobjekt für das Cmdlet Get-CimAssociatedInstance verwendet, um alle zugehörigen CIM-Instanzen der angegebenen CIM-Instanz abzurufen.

Beispiel 2: Alle zugehörigen Instanzen eines bestimmten Typs abrufen

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

Dieser Befehlssatz ruft alle Instanzen der Klasse Win32_LogicalDisk ab und speichert sie in einer Variablen mit dem Namen $disk. Die erste logische Festplatteninstanz in der Variablen wird dann als Eingabeobjekt für das Cmdlet Get-CimAssociatedInstance verwendet, um alle zugehörigen Instanzen abzurufen, die über die angegebene Zuordnungsklasse Win32_DiskPartition verknüpft sind .

Beispiel 3: Rufen Sie alle zugehörigen Instanzen über den Qualifizierer einer bestimmten Klasse ab

Dieser Befehlssatz ruft die Dienste ab, die vom Winmgmt-Dienst abhängen, und speichert sie in einer Variablen mit dem Namen $s. Get-CimAssociatedInstance ruft die zugehörigen Instanzen der abgerufenen Assoziationsklasse 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 Assoziationsklasse an. Wenn Sie diesen Parameter nicht angeben, gibt das Cmdlet alle vorhandenen Zuordnungsobjekte jeglichen Typs zurück.

Wenn beispielsweise Klasse A über zwei Assoziationen, AB1 und AB2, mit Klasse B verknüpft ist, kann dieser Parameter verwendet werden, um die Art der Assoziation anzugeben, entweder AB1 oder AB2.

Typ :

String

Position:

1

Standardwert:

None

Erforderlich:

False

Pipeline-Eingabe akzeptieren:

True

Platzhalterzeichen akzeptieren:

False

-CimSession

Führt den Befehl mit 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.

Typ :

CimSession[]

Position:

Namens

Standardwert:

None

Erforderlich:

True

Pipeline-Eingabe akzeptieren:

True

Platzhalterzeichen akzeptieren:

False

-ComputerName

Gibt den Namen des Computers an, auf dem Sie den CIM-Vorgang ausführen möchten. 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 mit 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, führt die Verbindung über eine CIM-Sitzung zu einer besseren Leistung.

Typ :

String[]

Aliase:

CN, ServerName

Position:

Namens

Standardwert:

None

Erforderlich:

False

Pipeline-Eingabe akzeptieren:

False

Platzhalterzeichen akzeptieren:

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 ausgegeben. Wenn Sie mit Sammlungen arbeiten, leiten Sie die Eingabe weiter, um die Werte aufzuzählen.

Typ :

CimInstance

Aliase:

CimInstance

Position:

0

Standardwert:

None

Erforderlich:

True

Pipeline-Eingabe akzeptieren:

True

Platzhalterzeichen akzeptieren:

False

-KeyOnly

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

Typ :

SwitchParameter

Position:

Namens

Standardwert:

None

Erforderlich:

False

Pipeline-Eingabe akzeptieren:

False

Platzhalterzeichen akzeptieren:

False

-Namespace

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

Typ :

String

Position:

Namens

Standardwert:

None

Erforderlich:

False

Pipeline-Eingabe akzeptieren:

True

Platzhalterzeichen akzeptieren:

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 Standard-Timeout-Wert für den Server verwendet.

Wenn der Parameter OperationTimeoutSec auf einen Wert eingestellt ist, der unter dem robusten Zeitlimit für Verbindungswiederholungen von 3 Minuten liegt, können Netzwerkausfälle, die länger als der Wert des Parameters OperationTimeoutSec andauern, nicht behoben werden , da der Vorgang auf dem Server abläuft, bevor der Client die Verbindung wiederherstellen kann.

Typ :

UInt32

Aliase:

OT

Position:

Namens

Standardwert:

None

Erforderlich:

False

Pipeline-Eingabe akzeptieren:

True

Platzhalterzeichen akzeptieren:

False

-ResourceUri

Gibt den Ressourcen-URI (Uniform Resource Identifier) der Ressourcenklasse oder -instanz an. Der URI wird verwendet, um einen bestimmten Ressourcentyp auf einem Computer zu identifizieren, z. B. Festplatten 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 Der Klassenname wird daran angehängt.

ResourceURI kann nur mit CIM-Sitzungen verwendet werden, die mit dem WSMan-Protokoll erstellt wurden, oder wenn der Parameter ComputerName angegeben wird, der eine CIM-Sitzung mit WSMan erstellt. Wenn Sie diesen Parameter angeben, ohne den Parameter ComputerName anzugeben, oder wenn Sie eine mit dem DCOM-Protokoll erstellte CIM-Sitzung angeben, erhalten Sie eine Fehlermeldung, da das DCOM-Protokoll den ResourceURI nicht unterstützt. Parameter.

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

Typ :

Uri

Position:

Namens

Standardwert:

None

Erforderlich:

False

Pipeline-Eingabe akzeptieren:

False

Platzhalterzeichen akzeptieren:

False

-ResultClassName

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

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

Sie können die Zuordnungsergebnisse so filtern, dass sie einem bestimmten Klassennamen entsprechen. Die Filterung erfolgt auf dem Server. Wenn dieser Parameter nicht angegeben ist, gibt Get-CIMAssociatedInstance alle vorhandenen Zuordnungen zurück. Wenn beispielsweise Klasse A mit den Klassen B, C und D verknüpft ist, kann dieser Parameter verwendet werden, um die Ausgabe auf einen bestimmten Typ (B, C oder D) zu beschränken.

Typ :

String

Position:

Namens

Standardwert:

None

Erforderlich:

False

Pipeline-Eingabe akzeptieren:

False

Platzhalterzeichen akzeptieren:

False

Eingaben

Keine

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgänge

CimInstance

Dieses Cmdlet gibt ein CIM-Instanzobjekt zurück.

Notizen

PowerShell enthält die folgenden Aliase für Get-CimAssociatedInstance:

• Windows:

  gcai

Dieses Cmdlet ist nur auf Windows-Plattformen verfügbar.