Megosztás a következőn keresztül:

Get-CimAssociatedInstance

  • Referencia
Modul:
CimCmdlets

Lekéri azokat a CIM-példányokat, amelyek egy társítás által egy adott CIM-példányhoz csatlakoznak.

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

Ez a parancsmag csak a Windows platformon érhető el.

A Get-CimAssociatedInstance parancsmag lekéri azokat a CIM-példányokat, amelyek egy adott CIM-példányhoz, úgynevezett forráspéldányhoz csatlakoznak egy társítás által.

Egy társításban minden CIM-példány rendelkezik elnevezett szerepkörrel, és ugyanaz a CIM-példány különböző szerepkörökben vehet részt egy társításban.

Ha az InputObject paraméter nincs megadva, a parancsmag a következő módok egyikével működik:

  • Ha sem a ComputerName paraméter, sem a CimSession paraméter nincs megadva, akkor ez a parancsmag a helyi Windows Management Instrumentation (WMI) rendszeren működik egy komponensobjektum-modell (COM) munkamenettel.
  • Ha a ComputerName paraméter vagy a CimSession paraméter van megadva, akkor ez a parancsmag a ComputerName vagy a CimSession paraméter által megadott CIM-kiszolgálóval működik.

Példák

1. példa: Egy adott példány összes társított példányának lekérése

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

Ez a parancskészlet lekéri a Win32_LogicalDisk nevű osztály példányait, és a parancsmag használatával elnevezett $disk változóban tárolja az Get-CimInstance információkat. A rendszer a változó első logikai lemezpéldányát használja a parancsmag bemeneti objektumaként a Get-CimAssociatedInstance megadott CIM-példány összes társított CIM-példányának lekéréséhez.

2. példa: Egy adott típusú összes társított példány lekérése

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

Ez a parancskészlet lekéri a Win32_LogicalDisk osztály összes példányát, és egy névvel ellátott $diskváltozóban tárolja őket. A rendszer ezután a változó első logikai lemezpéldányát használja a parancsmag bemeneti objektumaként a Get-CimAssociatedInstance megadott társításosztály Win32_DiskPartition társított összes társított példány lekéréséhez.

3. példa: Az összes társított példány lekérése egy adott osztály minősítőjén keresztül

Ez a parancskészlet lekéri a Winmgmt szolgáltatástól függő szolgáltatásokat, és egy névvel ellátott $sváltozóban tárolja őket. Get-CimAssociatedInstance lekéri a lekért társításosztály társított példányait.

$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

Paraméterek

-Association

Megadja a társításosztály nevét. Ha nem adja meg ezt a paramétert, a parancsmag minden létező társításobjektumot ad vissza.

Ha például az A osztály két társításon (AB1 és AB2) keresztül van társítva a B osztályhoz, akkor ez a paraméter az AB1 vagy az AB2 társítás típusának megadására használható.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-CimSession

A parancsot a megadott CIM-munkamenet használatával futtatja. Adjon meg egy változót, amely tartalmazza a CIM-munkamenetet, vagy egy parancsot, amely létrehozza vagy lekéri a CIM-munkamenetet, például New-CimSession vagy Get-CimSession. További információ: about_CimSession.

Type:CimSession[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Megadja annak a számítógépnek a nevét, amelyen futtatni szeretné a CIM-műveletet. Megadhat teljes tartománynevet (FQDN) vagy NetBIOS-nevet.

Ha megadja ezt a paramétert, a parancsmag létrehoz egy ideiglenes munkamenetet a megadott számítógépen a WsMan protokoll használatával.

Ha nem adja meg ezt a paramétert, a parancsmag a helyi számítógépen hajtja végre a műveletet a Component Object Model (COM) használatával.

Ha ugyanazon a számítógépen több műveletet végeznek, a CIM-munkamenet használatával való csatlakozás jobb teljesítményt nyújt.

Type:String[]
Aliases:CN, ServerName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Megadja a parancsmag bemenetét. Használhatja ezt a paramétert, vagy a bemenetet erre a parancsmagra is átirányíthatja.

Az InputObject paraméter nem számba veszi a gyűjteményeket. Ha egy gyűjteményt ad át, hibaüzenet jelenik meg. A gyűjtemények használatakor a bemenetet a bemenetet az értékek számbavételéhez kell beszűkíteni.

Type:CimInstance
Aliases:CimInstance
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-KeyOnly

Olyan objektumokat ad vissza, amelyek csak a kulcstulajdonságokat töltik ki. Ez csökkenti a hálózaton keresztül továbbított adatok mennyiségét.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Namespace

Megadja a CIM-művelet névterét. Az alapértelmezett névtér a root/cimv2.

Feljegyzés

A tabulátorkiegészítéssel tallózhat a névterek listájában, mivel a PowerShell lekéri a névterek listáját a helyi WMI-kiszolgálóról a névterek listájának megadásához.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-OperationTimeoutSec

Megadja, hogy a parancsmag mennyi időt vár a számítógép válaszára. Alapértelmezés szerint ennek a paraméternek az értéke 0, ami azt jelenti, hogy a parancsmag a kiszolgáló alapértelmezett időtúllépési értékét használja.

Ha az OperationTimeoutSec paraméter értéke kisebb, mint a 3 perces robusztus kapcsolat-újrapróbálkozási időtúllépés, az OperationTimeoutSec paraméter értékénél hosszabb hálózati hibák nem állíthatók helyre, mert a kiszolgálón végzett művelet túllépi az időkorlátot, mielőtt az ügyfél újracsatlakozhat.

Type:UInt32
Aliases:OT
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceUri

Az erőforrásosztály vagy -példány erőforrás-egységes erőforrás-azonosítóját (URI) adja meg. Az URI egy adott típusú erőforrás, például lemezek vagy folyamatok azonosítására szolgál a számítógépen.

Az URI egy előtagból és egy erőforrás elérési útból áll. Példa:

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

Alapértelmezés szerint, ha nem adja meg ezt a paramétert, a rendszer a DMTF standard erőforrás URI-t http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ használja, és hozzáfűzi az osztály nevét.

A ResourceURI csak a WSMan protokollal létrehozott CIM-munkamenetekkel használható, vagy a ComputerName paraméter megadásakor, amely a WSMan használatával hoz létre CIM-munkamenetet. Ha ezt a paramétert a ComputerName paraméter megadása nélkül adja meg, vagy ha egy DCOM protokoll használatával létrehozott CIM-munkamenetet ad meg, hibaüzenet jelenik meg, mert a DCOM protokoll nem támogatja a ResourceURI paramétert.

Ha a ResourceUri paraméter és a Szűrő paraméter is meg van adva, a szűrő paraméter figyelmen kívül lesz hagyva.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResultClassName

Megadja a társított példányok osztálynevét. A CIM-példányok egy vagy több CIM-példányhoz társíthatók. A rendszer minden társított CIM-példányt visszaad, ha nem adja meg az eredményosztály nevét.

Alapértelmezés szerint ennek a paraméternek az értéke null, és a rendszer az összes társított CIM-példányt visszaadja.

A társítás eredményeit szűrheti egy adott osztálynév alapján. A szűrés a kiszolgálón történik. Ha ez a paraméter nincs megadva, Get-CIMAssociatedInstance az összes meglévő társítás értékét adja vissza. Ha például az A osztály a B, C és D osztályhoz van társítva, akkor ez a paraméter egy adott típusra (B, C vagy D) korlátozhatja a kimenetet.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

CimInstance

Ez a parancsmag egy CIM-példányobjektumot ad vissza.

Jegyzetek

A PowerShell a következő aliasokat Get-CimAssociatedInstancetartalmazza:

  • Windows:
    • gcai

Ez a parancsmag csak Windows-platformokon érhető el.