Get-CimAssociatedInstance
Lekéri azokat a CIM-példányokat, amelyek egy társítás által egy adott CIM-példányhoz csatlakoznak.
Syntax
ComputerSet (Alapértelmezett)
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
Ez a parancsmag csak a Windows platformon érhető el.
A Get-CimAssociatedInstance parancsmag egy társítás által lekéri egy adott CIM-példányhoz, a forráspéldányhoz csatlakoztatott CIM-példányokat.
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 az alábbi 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 paraméter 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 az adatokat egy $disk nevű változóban tárolja a Get-CimInstance parancsmag használatával. A rendszer a változó első logikai lemezpéldányát használja a Get-CimAssociatedInstance parancsmag bemeneti objektumaként a 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 $disknevű változóban tárolja őket. A rendszer a változó első logikai lemezpéldányát használja a Get-CimAssociatedInstance parancsmag bemeneti objektumaként a megadott társításosztály Win32_DiskPartitiontá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
$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
Ez a parancskészlet lekéri a WMI szolgáltatástól függő szolgáltatásokat, és egy nevű $sváltozóban tárolja őket. A Win32_DependentService társítási osztályának nevét a Get-CimClass parancsmag használatával kéri le a rendszer úgy, hogy minősítőként megadja a Társítást , majd $s továbbítja a Get-CimAssociatedInstance parancsmagnak, hogy lekérje a lekért társítási osztály összes társított példányát.
Paraméterek
-Association
Megadja a társításosztály nevét. Ha nem adja meg ezt a paramétert, a parancsmag bármilyen típusú társítási objektumot visszaad.
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ó.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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 olyan parancsot, amely létrehozza vagy lekéri a CIM-munkamenetet, például New-CimSession vagy Get-CimSession. További információért lásd: about_CimSession.
Paramétertulajdonságok
| Típus: | |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
SessionSet
| Position: | Named |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Kína, Kiszolgálónév |
Paraméterkészletek
ComputerSet
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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ényekkel való munka során irányítsa át a bemenetet az értékek felsorolásához.
Paramétertulajdonságok
| Típus: | CimInstance |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | CimInstance |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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.
Paramétertulajdonságok
| Típus: | SwitchParameter |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Namespace
Megadja a CIM-művelet névterét. Az alapértelmezett névtér a root/cimv2.
Megjegyzés:
A tabulátorkiegészítéssel tallózhat a névterek között, mert a PowerShell a helyi WMI-kiszolgálóról kér le egy névtérlistát, hogy biztosítsa a névterek listáját.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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 a OperationTimeoutSec paraméter értéke kisebb, mint a 3 perces robusztus kapcsolat-újrapróbálkozási időtúllépés, a 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őt, mielőtt az ügyfél újracsatlakozhat.
Paramétertulajdonságok
| Típus: | UInt32 |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | OT |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | True |
| Fennmaradó argumentumokból származó érték: | 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éldául:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDiskhttp://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-http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ használja, és hozzáfűzi az osztály nevét.
ResourceURI csak a WSMan protokollal létrehozott CIM-munkamenetekkel, vagy a ComputerName paraméter megadásakor használható, 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 DCOM protokollal 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.
Paramétertulajdonságok
| Típus: | Uri |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | 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, az Get-CIMAssociatedInstance összes meglévő társítást visszaadja. 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.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | Named |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
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 tartalmazza a következőhöz:
- Windows:
gcai
Ez a parancsmag csak Windows-platformokon érhető el.