Get-CimAssociatedInstance
Hämtar de CIM-instanser som är anslutna till en specifik CIM-instans av en association.
Syntax
ComputerSet (Standard)
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
Den här cmdleten är endast tillgänglig på Windows-plattformen.
Cmdleten Get-CimAssociatedInstance hämtar CIM-instanserna som är anslutna till en specifik CIM-instans, som kallas källinstansen, av en association.
I en association har varje CIM-instans en namngiven roll och samma CIM-instans kan delta i en association i olika roller.
Om parametern InputObject inte anges fungerar cmdleten på något av följande sätt:
- Om varken parametern ComputerName eller parametern CimSession anges, fungerar den här cmdleten på den lokala Windows Management Instrumentation (WMI) med hjälp av en COM-session (Component Object Model).
- Om parametern ComputerName eller parametern CimSession anges, fungerar den här cmdleten mot den CIM-server som anges av parametern ComputerName eller parametern CimSession.
Exempel
Exempel 1: Hämta alla associerade instanser av en specifik instans
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1]
Den här uppsättningen kommandon hämtar instanserna av klassen med namnet Win32_LogicalDisk och lagrar informationen i en variabel med namnet $disk med hjälp av cmdleten Get-CimInstance. Den första logiska diskinstansen i variabeln används sedan som indataobjekt för cmdleten Get-CimAssociatedInstance för att hämta alla associerade CIM-instanser av den angivna CIM-instansen.
Exempel 2: Hämta alla associerade instanser av en viss typ
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition
Den här uppsättningen kommandon hämtar alla instanser av klassen Win32_LogicalDisk och lagrar dem i en variabel med namnet $disk. Den första logiska diskinstansen i variabeln används sedan som indataobjekt för cmdleten Get-CimAssociatedInstance för att hämta alla associerade instanser som är associerade via den angivna associationsklassen Win32_DiskPartition.
Exempel 3: Hämta alla associerade instanser via kvalificeraren för en specifik klass
Den här uppsättningen kommandon hämtar de tjänster som är beroende av Winmgmt-tjänsten och lagrar dem i en variabel med namnet $s.
Get-CimAssociatedInstance hämtar de associerade instanserna av den hämtade associationsklassen.
$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
Parametrar
-Association
Anger namnet på associationsklassen. Om du inte anger den här parametern returnerar cmdleten alla befintliga associationsobjekt av någon typ.
Om klass A till exempel är associerad med klass B via två associationer, AB1 och AB2, kan den här parametern användas för att ange typ av association, antingen AB1 eller AB2.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-CimSession
Kör kommandot med den angivna CIM-sessionen. Ange en variabel som innehåller CIM-sessionen eller ett kommando som skapar eller hämtar CIM-sessionen, till exempel New-CimSession eller Get-CimSession. Mer information finns i about_CimSession.
Parameteregenskaper
| Typ: | |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
SessionSet
| Position: | Named |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-ComputerName
Anger namnet på den dator där du vill köra CIM-åtgärden. Du kan ange ett fullständigt kvalificerat domännamn (FQDN) eller ett NetBIOS-namn.
Om du anger den här parametern skapar cmdleten en tillfällig session till den angivna datorn med hjälp av WsMan-protokollet.
Om du inte anger den här parametern utför cmdleten åtgärden på den lokala datorn med hjälp av Komponentobjektmodell (COM).
Om flera åtgärder utförs på samma dator ger anslutning med en CIM-session bättre prestanda.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | CN, Servernamn |
Parameteruppsättningar
ComputerSet
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-InputObject
Anger indata till den här cmdleten. Du kan använda den här parametern, eller så kan du skicka indata till den här cmdleten.
Parametern InputObject räknas inte upp över samlingar. Om en samling skickas utlöses ett fel. När du arbetar med samlingar kan du skicka indata för att räkna upp värdena.
Parameteregenskaper
| Typ: | CimInstance |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | CimInstance |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | True |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-KeyOnly
Returnerar objekt med endast nyckelegenskaper ifyllda. Detta minskar mängden data som överförs via nätverket.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Namespace
Anger namnområdet för CIM-åtgärden. Standardnamnområdet är root/CIMV2.
Anmärkning
Du kan använda tabbavslut för att bläddra i listan över namnområden, eftersom PowerShell hämtar en lista över namnområden från den lokala WMI-servern för att tillhandahålla listan över namnområden.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-OperationTimeoutSec
Anger hur lång tid cmdleten väntar på ett svar från datorn. Som standard är värdet för den här parametern 0, vilket innebär att cmdleten använder standardvärdet för timeout för servern.
Om parametern OperationTimeoutSec har angetts till ett värde som är mindre än den robusta tidsgränsen för återförsök av anslutningen på 3 minuter kan nätverksfel som varar mer än värdet för OperationTimeoutSec parameter inte återställas, eftersom åtgärden på servern överskrider tidsgränsen innan klienten kan återansluta.
Parameteregenskaper
| Typ: | UInt32 |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
| Alias: | OT |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-ResourceUri
Anger resursens enhetliga resursidentifierare (URI) för resursklassen eller instansen. URI:n används för att identifiera en specifik typ av resurs, till exempel diskar eller processer, på en dator.
En URI består av ett prefix och en sökväg till en resurs. Till exempel:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDiskhttp://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings
Om du inte anger den här parametern används som standard URI för DMTF-standardresursen http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ och klassnamnet läggs till i den.
ResourceUri- kan bara användas med CIM-sessioner som skapats med hjälp av WSMan-protokollet, eller när du anger parametern ComputerName, som skapar en CIM-session med WSMan. Om du anger den här parametern utan att ange parametern ComputerName, eller om du anger en CIM-session som skapats med DCOM-protokollet, får du ett fel eftersom DCOM-protokollet inte stöder parametern ResourceUri.
Om både parametern ResourceUri och parametern Filter anges ignoreras parametern Filter.
Parameteregenskaper
| Typ: | Uri |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-ResultClassName
Anger klassnamnet för de associerade instanserna. En CIM-instans kan associeras med en eller flera CIM-instanser. Alla associerade CIM-instanser returneras om du inte anger resultatklassnamnet.
Som standard är värdet för den här parametern null och alla associerade CIM-instanser returneras.
Du kan filtrera associationsresultaten så att de matchar ett specifikt klassnamn. Filtrering sker på servern. Om den här parametern inte anges returnerar Get-CimAssociatedInstance alla befintliga associationer. Om klass A till exempel är associerad med klasserna B, C och D kan den här parametern användas för att begränsa utdata till en viss typ (B, C eller D).
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
CimInstance
Den här cmdleten returnerar ett CIM-instansobjekt.
Kommentarer
PowerShell innehåller följande alias för Get-CimAssociatedInstance:
- Windows:
gcai
Den här cmdleten är endast tillgänglig på Windows-plattformar.
