Get-CimAssociatedInstance

Syntaxis

ComputerSet (Standaard)

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

Description

Voorbeelden

Voorbeeld 1: Alle gekoppelde exemplaren van een specifiek exemplaar ophalen

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

Voorbeeld 2: alle gekoppelde exemplaren van een specifiek type ophalen

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

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

$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

Parameters

-Association

Hiermee geeft u de naam van de koppelingsklasse. Als u deze parameter niet opgeeft, retourneert de cmdlet alle bestaande koppelingsobjecten van een willekeurig 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.

Parametereigenschappen

Parametersets

-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_CimSessionvoor meer informatie.

Parametereigenschappen

Parametersets

-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 com (Component Object Model).

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

Parametereigenschappen

Parametersets

-InputObject

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

De parameter InputObject inventariseert geen verzamelingen. Als een verzameling wordt doorgegeven, treedt er een fout op. Wanneer u met verzamelingen werkt, kunt u de invoer doorsluisen om de waarden op te sommen.

Parametereigenschappen

Parametersets

-KeyOnly

Retourneert objecten waarop alleen sleuteleigenschappen zijn ingevuld. Dit vermindert de hoeveelheid gegevens die via het netwerk worden overgedragen.

Parametereigenschappen

Parametersets

-Namespace

Hiermee geeft u de naamruimte voor de CIM-bewerking. De standaardnaamruimte is root/CIMV2-.

Parametereigenschappen

Parametersets

-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 de verbinding van 3 minuten, kunnen netwerkfouten die meer duren dan de waarde van de parameter OperationTimeoutSec niet herstellen, omdat de bewerking op de server een time-out optreedt voordat de client opnieuw verbinding kan maken.

Parametereigenschappen

Parametersets

-ResourceUri

Geeft de resource-uniform resource identifier (URI) van de resourceklasse of instantie op. 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. Voorbeeld:

• http://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 WSMan. Als u deze parameter opgeeft zonder de parameter ComputerName op te geven of als u een CIM-sessie opgeeft die is gemaakt met behulp van het DCOM-protocol, krijgt u een foutmelding omdat het DCOM-protocol de ResourceUri parameter niet ondersteunt.

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

Parametereigenschappen

Parametersets

-ResultClassName

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

De waarde van deze parameter is standaard null en 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).

Parametereigenschappen

Parametersets

CommonParameters

Invoerwaarden

None

Uitvoerwaarden

CimInstance

Notities

Verwante koppelingen

• Get-CimClass
• Get-CimInstance