Delen via

Get-CimAssociatedInstance

  • Referentie
Module:
CimCmdlets

Haalt de CIM-exemplaren op die zijn verbonden met een specifiek CIM-exemplaar door een koppeling.

Syntaxis

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

Description

Met de Get-CimAssociatedInstance cmdlet worden de CIM-exemplaren opgehaald die zijn verbonden met een specifiek CIM-exemplaar, het bronexemplaren genoemd, door een koppeling.

In een koppeling heeft elk CIM-exemplaar een benoemde rol en kan hetzelfde CIM-exemplaar deelnemen aan een koppeling in verschillende rollen.

Als de parameter InputObject niet is opgegeven, werkt de cmdlet op een van de volgende manieren:

  • Als noch de parameter ComputerName noch de parameter CimSession is opgegeven, werkt deze cmdlet op lokale Windows Management Instrumentation (WMI) met behulp van een COM-sessie (Component Object Model).
  • Als de parameter ComputerName of de parameter CimSession is opgegeven, werkt deze cmdlet tegen de CIM-server die is opgegeven door de parameter ComputerName of de parameter CimSession.

Voorbeelden

Voorbeeld 1: Alle gekoppelde exemplaren van een specifiek exemplaar ophalen

PS C:\>$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly

PS C:\>Get-CimAssociatedInstance -InputObject $disk[1]

Met deze set opdrachten worden de exemplaren van de klasse met de naam Win32_LogicalDisk opgehaald en worden de gegevens opgeslagen in een variabele met de naam $disk met behulp van de Get-CimInstance-cmdlet. Het eerste logische schijfexemplaar in de variabele wordt vervolgens gebruikt als invoerobject voor de Get-CimAssociatedInstance cmdlet om alle bijbehorende CIM-exemplaren van het opgegeven CIM-exemplaar op te halen.

Voorbeeld 2: alle gekoppelde exemplaren van een specifiek type ophalen

PS C:\>$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly

PS C:\>Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition

Met deze set opdrachten worden alle exemplaren van de klasse met de naam Win32_LogicalDisk opgehaald en opgeslagen in een variabele met de naam $disk. Het eerste logische schijfexemplaar in de variabele wordt vervolgens gebruikt als invoerobject voor de Get-CimAssociatedInstance cmdlet om alle gekoppelde exemplaren op te halen die zijn gekoppeld via de opgegeven koppelingsklasse Win32_DiskPartition.

Voorbeeld 3: alle gekoppelde instanties ophalen via kwalificatie van een specifieke klasse

PS C:\>$s = Get-CimInstance -Query "Select * from Win32_Service where name like 'Winmgmt'"

PS C:\>Get-CimClass -ClassName *Service* -Qualifier "Association"

PS C:\>$c.CimClasName
Win32_LoadOrderGroupServiceDependencies
Win32_DependentService
Win32_SystemServices
Win32_LoadOrderGroupServiceMembers
Win32_ServiceSpecificationService

PS C:\>Get-CimAssociatedInstance -InputObject $s -Association Win32_DependentService

Met deze set opdrachten worden de services opgehaald die afhankelijk zijn van de WMI-service (Windows Management Instrumentation) en worden deze opgeslagen in een variabele met de naam $s. De naam van de koppelingsklasse voor de Win32_DependentService wordt opgehaald met behulp van de Get-CimClass-cmdlet door Koppeling op te geven als kwalificatie en wordt vervolgens doorgegeven met $s aan de Get-CimAssociatedInstance-cmdlet om alle gekoppelde exemplaren van de opgehaalde koppelingsklasse op te halen.

Parameters

-Association

Hiermee geeft u de naam van de koppelingsklasse.

Als u deze parameter niet opgeeft, retourneert de cmdlet alle bestaande koppelingsobjecten, ongeacht hun type.

Als klasse A bijvoorbeeld is gekoppeld aan klasse B via twee koppelingen, AB1 en AB2, kan deze parameter worden gebruikt om het type koppeling op te geven, AB1 of AB2.

Type:String
Position:2
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-CimSession

Voert de opdracht uit met behulp van de opgegeven CIM-sessie. Voer een variabele in die de CIM-sessie bevat of een opdracht waarmee de CIM-sessie wordt gemaakt of ophaalt, zoals New-CimSession of Get-CimSession. Zie about_CimSessions voor meer informatie.

Type:CimSession[]
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ComputerName

Hiermee geeft u de naam van de computer waarop u de CIM-bewerking wilt uitvoeren. U kunt een FQDN (Fully Qualified Domain Name) of een NetBIOS-naam opgeven.

Als u deze parameter opgeeft, maakt de cmdlet een tijdelijke sessie naar de opgegeven computer met behulp van het WsMan-protocol.

Als u deze parameter niet opgeeft, voert de cmdlet de bewerking uit op de lokale computer met behulp van Component Object Model (COM).

Als er meerdere bewerkingen op dezelfde computer worden uitgevoerd, kunt u beter verbinding maken met een CIM-sessie.

Type:String[]
Aliassen:CN, ServerName
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-InputObject

Hiermee geeft u de invoer voor deze cmdlet. U kunt deze parameter gebruiken of u kunt de invoer doorsluisen naar deze cmdlet.

Type:CimInstance
Aliassen:CimInstance
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-KeyOnly

Retourneert objecten waarop alleen sleuteleigenschappen zijn ingevuld.

Dit vermindert de hoeveelheid gegevens die via het netwerk worden overgedragen.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Namespace

Hiermee geeft u de naamruimte voor de CIM-bewerking.

De standaardnaamruimte is root/cimv2.

Notitie

U kunt tabvoltooiing gebruiken om door de lijst met naamruimten te bladeren, omdat Windows PowerShell een lijst met naamruimten ophaalt van de lokale WMI-server om de lijst met naamruimten op te geven.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-OperationTimeoutSec

Hiermee geeft u de hoeveelheid tijd op die de cmdlet wacht op een reactie van de computer.

De waarde van deze parameter is standaard 0, wat betekent dat de cmdlet de standaardtime-outwaarde voor de server gebruikt.

Als de parameter OperationTimeoutSec is ingesteld op een waarde die kleiner is dan de robuuste time-out voor opnieuw proberen van 3 minuten, kunnen netwerkfouten die meer duren dan de waarde van de parameter OperationTimeoutSec niet herstellen, omdat er een time-out optreedt voordat de client opnieuw verbinding kan maken.

Type:UInt32
Aliassen:OT
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ResourceUri

Hiermee geeft u de resource uniform resource identifier (URI) van de resourceklasse of het exemplaar. De URI wordt gebruikt om een specifiek type resource, zoals schijven of processen, op een computer te identificeren.

Een URI bestaat uit een voorvoegsel en een pad naar een resource. Bijvoorbeeld:

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

Als u deze parameter niet opgeeft, wordt standaard de DMTF-standaardresource-URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ gebruikt en wordt de klassenaam eraan toegevoegd.

ResourceURI kan alleen worden gebruikt met CIM-sessies die zijn gemaakt met het WSMan-protocol of wanneer u de parameter ComputerName opgeeft, waarmee een CIM-sessie wordt gemaakt met behulp van WSMan. Als u deze parameter opgeeft zonder de parameter ComputerName op te geven of als u een CIM-sessie opgeeft die is gemaakt met het DCOM-protocol, krijgt u een foutmelding omdat het DCOM-protocol de parameter ResourceURI niet ondersteunt.

Als zowel de parameter ResourceUri als de filterparameter zijn opgegeven, wordt de filterparameter genegeerd.

Type:Uri
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResultClassName

Hiermee geeft u de klassenaam van de bijbehorende exemplaren. Een CIM-exemplaar kan worden gekoppeld aan een of meer CIM-exemplaren. Alle gekoppelde CIM-exemplaren worden geretourneerd als u de naam van de resultaatklasse niet opgeeft.

Standaard is de waarde van deze parameter null, wat betekent dat alle bijbehorende CIM-exemplaren worden geretourneerd.

U kunt de koppelingsresultaten filteren zodat deze overeenkomen met een specifieke klassenaam. Filteren vindt plaats op de server. Als deze parameter niet is opgegeven, retourneert Get-CIMAssociatedInstance alle bestaande koppelingen. Als klasse A bijvoorbeeld is gekoppeld aan klassen B, C en D, kan deze parameter worden gebruikt om de uitvoer te beperken tot een specifiek type (B, C of D).

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

None

Deze cmdlet accepteert geen invoerobjecten.

Uitvoerwaarden

Object

Met deze cmdlet wordt een object geretourneerd.