Get-CimAssociatedInstance
Haalt de CIM-exemplaren op die via een koppeling zijn verbonden met een specifiek CIM-exemplaar.
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>]
Description
Deze cmdlet is alleen beschikbaar op het Windows-platform.
De Get-CimAssociatedInstance
cmdlet haalt de CIM-exemplaren op die zijn verbonden met een specifiek CIM-exemplaar, het bronexemplaar, 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 met 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
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1]
Deze set opdrachten haalt de exemplaren van de klasse met de naam Win32_LogicalDisk op en slaat de informatie op in een variabele met de naam $disk
met behulp van de Get-CimInstance
cmdlet. Het eerste exemplaar van de logische schijf in de variabele wordt vervolgens gebruikt als het invoerobject voor de Get-CimAssociatedInstance
cmdlet om alle gekoppelde CIM-exemplaren van het opgegeven CIM-exemplaar op te halen.
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
Met deze set opdrachten worden alle exemplaren van de klasse Win32_LogicalDisk opgehaald en opgeslagen in een variabele met de naam $disk
. De eerste instantie van de logische schijf in de variabele wordt vervolgens gebruikt als het 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 exemplaren ophalen via kwalificatie van een specifieke 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
Deze set opdrachten haalt de services op die afhankelijk zijn van de WMI-service en slaat deze op 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 de kwalificatie en wordt vervolgens met $s doorgegeven 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 van elk 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: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CimSession
Hiermee wordt de opdracht uitgevoerd 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_CimSession voor meer informatie.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Hiermee geeft u de naam op 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, biedt verbinding maken met behulp van een CIM-sessie betere prestaties.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Hiermee geeft u de invoer voor deze cmdlet. U kunt deze parameter gebruiken of u kunt de invoer doorsnijden naar deze cmdlet.
De parameter InputObject inventariseert geen verzamelingen. Als een verzameling wordt doorgegeven, wordt er een fout gegenereerd. Wanneer u met verzamelingen werkt, sluist u de invoer door om de waarden op te sommen.
Type: | CimInstance |
Aliases: | CimInstance |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-KeyOnly
Retourneert objecten met alleen sleuteleigenschappen ingevuld. Dit vermindert de hoeveelheid gegevens die via het netwerk wordt overgedragen.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OperationTimeoutSec
Hiermee geeft u de hoeveelheid tijd die de cmdlet wacht op een antwoord van de computer. Standaard is de waarde van deze parameter 0, wat betekent dat de cmdlet de standaard time-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 langer duren dan de waarde van de parameter OperationTimeoutSec niet worden hersteld, omdat er een time-out optreedt voordat de client opnieuw verbinding kan maken.
Type: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceUri
Hiermee geeft u de resource-id (URI) van de resourceklasse of het exemplaar 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. Bijvoorbeeld:
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 standaard-URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/
van de DMTF-resource gebruikt en wordt de klassenaam eraan toegevoegd.
ResourceURI kan alleen worden gebruikt met CIM-sessies die zijn gemaakt met behulp van het WSMan-protocol, of bij het opgeven van de parameter ComputerName , 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 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 filterparameter zijn opgegeven, wordt de filterparameter genegeerd.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResultClassName
Hiermee geeft u de klassenaam van de gekoppelde 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 en worden alle gekoppelde CIM-exemplaren 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, Get-CIMAssociatedInstance
retourneert 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
None
U kunt geen objecten doorspezen naar deze cmdlet.
Uitvoerwaarden
Deze cmdlet retourneert een CIM-exemplaarobject.
Notities
PowerShell bevat de volgende aliassen voor '':
- Windows:
gcai
Deze cmdlet is alleen beschikbaar op Windows-platforms.