Get-CimAssociatedInstance

Modul:

CimCmdlets Module

Načte instance CIM, které jsou připojené ke konkrétní instanci CIM přidružením.

Syntaxe

ComputerSet (Výchozí)

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

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, bude tato rutina fungovat v místní relaci rozhraní WMI (Windows Management Instrumentation) pomocí relace modelu COM (Component Object Model).
• Pokud je zadán parametr ComputerName nebo parametr CimSession, bude tato rutina fungovat se serverem CIM zadaný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é s názvem $disk pomocí rutiny Get-CimInstance. První instance logického disku v proměnné se pak použije jako vstupní objekt pro rutinu 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 pro rutinu 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

Tato sada příkazů načte služby, které závisí na službě Winmgmt a uloží je do proměnné s názvem $s. Get-CimAssociatedInstance získá přidružené instance načtené třídy přidružení.

$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

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.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	1
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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 naleznete v tématu about_CimSession.

Vlastnosti parametru

Typ:	CimSession[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

SessionSet

Position:	Named
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	Čína, Název serveru

Sady parametrů

ComputerSet

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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áci s kolekcemi přesměrujte vstup pro vyjmenování hodnot.

Vlastnosti parametru

Typ:	CimInstance
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	CimInstance

Sady parametrů

(All)

Position:	0
Povinné:	True
Hodnota z kanálu:	True
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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íť.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Namespace

Určuje oblast jmen 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ů.

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-OperationTimeoutSec

Určuje dobu, po kterou cmdlet č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, selhání sítě, která trvá déle než hodnota parametru OperationTimeoutSec, není možné obnovit, protože operace na serveru vyprší, než se klient může znovu připojit.

Vlastnosti parametru

Typ:	UInt32
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False
Aliasy:	OT

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	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. Napří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 prostředku DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ a název třídy se k němu připojí.

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 pokud 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, bude parametr filtru ignorován.

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	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).

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

None

Do tohoto cmdletu nemůžete předávat objekty.

Výstupy

CimInstance

Tato rutina vrátí objekt instance CIM.

Poznámky

PowerShell obsahuje následující aliasy pro Get-CimAssociatedInstance:

• Windows:
  • gcai

Tento cmdlet je dostupný pouze na platformách Windows.

Související odkazy

• Get-CimClass
• Get-CimInstance