Get-CimAssociatedInstance
Načte instance CIM, které jsou připojené ke konkrétní instanci CIM přidružením.
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
Tato rutina je dostupná jenom na platformě Windows.
Rutina Get-CimAssociatedInstance
načte instance CIM připojené ke konkrétní instanci CIM označované jako zdrojová instance přidružením.
V přidružení má každá instance CIM pojmenovanou roli a stejná instance CIM se může účastnit přidružení v různých rolích.
Pokud není zadaný parametr InputObject, rutina funguje jedním z následujících způsobů:
- Pokud není zadán parametr ComputerName ani parametr CimSession, tato rutina funguje v místní službě WMI (Windows Management Instrumentation) pomocí relace modelu COM (Component Object Model).
- Pokud je zadán parametr ComputerName nebo parametr CimSession, tato rutina pracuje se serverem CIM určeným parametrem ComputerName nebo parametrem CimSession.
Příklady
Příklad 1: Získání všech přidružených instancí konkrétní instance
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1]
Tato sada příkazů načte instance třídy s názvem Win32_LogicalDisk a uloží informace do proměnné pojmenované $disk
pomocí rutiny Get-CimInstance
. První instance logického disku v proměnné se pak použije jako vstupní objekt rutiny Get-CimAssociatedInstance
k získání všech přidružených instancí CIM zadané instance CIM.
Příklad 2: Získání všech přidružených instancí určitého typu
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition
Tato sada příkazů načte všechny instance třídy Win32_LogicalDisk a uloží je do proměnné s názvem $disk
. První instance logického disku v proměnné se pak použije jako vstupní objekt rutiny Get-CimAssociatedInstance
k získání všech přidružených instancí přidružených prostřednictvím zadané třídy přidružení Win32_DiskPartition.
Příklad 3: Získání všech přidružených instancí prostřednictvím kvalifikátoru konkrétní třídy
$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
Tato sada příkazů načte služby závislé na službě WMI a uloží je do proměnné s názvem $s
. Název třídy přidružení pro Win32_DependentService se načte pomocí Get-CimClass
rutiny zadáním association jako kvalifikátoru a pak se předá $s rutině Get-CimAssociatedInstance
, aby se získaly všechny přidružené instance načtené třídy přidružení.
Parametry
-Association
Určuje název třídy přidružení. Pokud tento parametr nezadáte, vrátí rutina všechny existující objekty přidružení libovolného typu.
Pokud je například třída A přidružena ke třídě B prostřednictvím dvou přidružení, AB1 a AB2, lze tento parametr použít k určení typu přidružení, ab1 nebo AB2.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CimSession
Spustí příkaz pomocí zadané relace CIM. Zadejte proměnnou, která obsahuje relaci CIM, nebo příkaz, který vytvoří nebo získá relaci CIM, například New-CimSession
nebo Get-CimSession
. Další informace najdete v tématu about_CimSession.
Type: | CimSession[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Určuje název počítače, na kterém chcete spustit operaci CIM. Můžete zadat plně kvalifikovaný název domény (FQDN) nebo název rozhraní NetBIOS.
Pokud zadáte tento parametr, rutina vytvoří dočasnou relaci k zadanému počítači pomocí protokolu WsMan.
Pokud tento parametr nezadáte, rutina provede operaci na místním počítači pomocí modelu COM (Component Object Model).
Pokud se na stejném počítači provádí více operací, poskytuje připojení pomocí relace CIM lepší výkon.
Type: | String[] |
Aliases: | CN, ServerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Určuje vstup pro tuto rutinu. Tento parametr můžete použít nebo můžete vstup převést na tuto rutinu.
Parametr InputObject nevypíše výčet kolekcí. Pokud je kolekce předána, vyvolá se chyba. Při prácisch
Type: | CimInstance |
Aliases: | CimInstance |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-KeyOnly
Vrátí objekty s vyplněnými pouze klíčovými vlastnostmi. Tím se sníží množství dat přenášených přes síť.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Namespace
Určuje obor názvů pro operaci CIM. Výchozí obor názvů je root/cimv2.
Poznámka:
Pomocí dokončování tabulátoru můžete procházet seznam oborů názvů, protože PowerShell získá seznam oborů názvů z místního serveru WMI a poskytne seznam oborů názvů.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OperationTimeoutSec
Určuje dobu, po kterou rutina čeká na odpověď z počítače. Ve výchozím nastavení je hodnota tohoto parametru 0, což znamená, že rutina používá výchozí hodnotu časového limitu pro server.
Pokud je parametr OperationTimeoutSec nastaven na hodnotu menší než robustní časový limit opakování připojení 3 minuty, chyby sítě, které trvaly více než hodnota parametru OperationTimeoutSec, se nedají obnovit, protože operace na serveru vyprší, než se klient může znovu připojit.
Type: | UInt32 |
Aliases: | OT |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceUri
Určuje identifikátor URI (Uniform Resource Identifier) prostředku třídy prostředků nebo instance. Identifikátor URI slouží k identifikaci konkrétního typu prostředku, jako jsou disky nebo procesy, v počítači.
Identifikátor URI se skládá z předpony a cesty k prostředku. Příklad:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk
http://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings
Pokud tento parametr nezadáte, použije se standardní identifikátor URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/
prostředku DMTF a název třídy se k němu připojí.
Identifikátor ResourceURI lze použít pouze s relacemi CIM vytvořenými pomocí protokolu WSMan nebo při zadávání parametru ComputerName , který vytvoří relaci CIM pomocí WSManu. Pokud tento parametr zadáte bez zadání parametru ComputerName nebo zadáte relaci CIM vytvořenou pomocí protokolu DCOM, zobrazí se chyba, protože protokol DCOM nepodporuje parametr ResourceURI .
Pokud je zadán parametr ResourceUri i parametr Filter, parametr Filter se ignoruje.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResultClassName
Určuje název třídy přidružených instancí. Instanci CIM je možné přidružit k jedné nebo více instancím CIM. Pokud nezadáte název třídy výsledků, vrátí se všechny přidružené instance CIM.
Ve výchozím nastavení je hodnota tohoto parametru null a vrátí se všechny přidružené instance CIM.
Výsledky přidružení můžete filtrovat tak, aby odpovídaly určitému názvu třídy. Filtrování probíhá na serveru. Pokud tento parametr není zadaný, Get-CIMAssociatedInstance
vrátí všechna existující přidružení. Pokud je například třída A přidružená ke třídám B, C a D, lze tento parametr použít k omezení výstupu na konkrétní typ (B, C nebo D).
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vstupy
None
Do této rutiny nemůžete roušit objekty.
Výstupy
Tato rutina vrátí objekt instance CIM.
Poznámky
PowerShell obsahuje následující aliasy pro :
- Windows:
gcai
Tato rutina je dostupná jenom na platformách Windows.
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro