Get-CimAssociatedInstance
Pobiera wystąpienia modelu CIM połączone z określonym wystąpieniem modelu CIM przez skojarzenie.
Składnia
ComputerSet (domyślnie)
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>]
Opis
Ten cmdlet jest dostępny tylko na platformie Windows.
Polecenie cmdlet Get-CimAssociatedInstance pobiera wystąpienia modelu CIM połączone z określonym wystąpieniem modelu CIM nazywanym wystąpieniem źródłowym przez skojarzenie.
W skojarzeniu każde wystąpienie modelu CIM ma nazwaną rolę, a to samo wystąpienie modelu CIM może uczestniczyć w skojarzeniu w różnych rolach.
Jeśli nie określono parametru InputObject, polecenie cmdlet działa w jeden z następujących sposobów:
- Jeśli nie określono parametru ComputerName ani parametru CimSession, to to polecenie cmdlet działa w lokalnej sesji instrumentacji zarządzania Windows (WMI) przy użyciu sesji modelu obiektów składników (COM).
- Jeśli określono parametr ComputerName lub parametr CimSession, to polecenie cmdlet działa na serwerze CIM określonym przez parametr ComputerName lub parametr CimSession.
Przykłady
Przykład 1. Pobieranie wszystkich skojarzonych wystąpień określonego wystąpienia
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1]
Ten zestaw poleceń pobiera wystąpienia klasy o nazwie Win32_LogicalDisk i przechowuje informacje w zmiennej o nazwie $disk nazwanej za pomocą Get-CimInstance polecenia cmdlet. Pierwsze wystąpienie dysku logicznego w zmiennej jest następnie używane jako obiekt wejściowy dla polecenia cmdlet Get-CimAssociatedInstance, aby pobrać wszystkie skojarzone wystąpienia modelu CIM określonego wystąpienia modelu CIM.
Przykład 2. Pobieranie wszystkich skojarzonych wystąpień określonego typu
$disk = Get-CimInstance -ClassName Win32_LogicalDisk -KeyOnly
Get-CimAssociatedInstance -InputObject $disk[1] -ResultClass Win32_DiskPartition
Ten zestaw poleceń pobiera wszystkie wystąpienia klasy Win32_LogicalDisk i przechowuje je w zmiennej o nazwie $disk. Pierwsze wystąpienie dysku logicznego w zmiennej jest następnie używane jako obiekt wejściowy dla polecenia cmdlet Get-CimAssociatedInstance w celu pobrania wszystkich skojarzonych wystąpień skojarzonych za pośrednictwem określonej klasy skojarzenia Win32_DiskPartition.
Przykład 3. Pobieranie wszystkich skojarzonych wystąpień za pośrednictwem kwalifikatora określonej klasy
$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
Ten zestaw poleceń pobiera usługi zależne od usługi WMI i przechowuje je w zmiennej o nazwie $s. Nazwa klasy skojarzenia dla Win32_DependentService jest pobierana za pomocą Get-CimClass polecenia cmdlet przez określenie Association jako kwalifikatora, a następnie jest przekazywana za pomocą $s do Get-CimAssociatedInstance polecenia cmdlet w celu pobrania wszystkich skojarzonych wystąpień pobranej klasy skojarzenia.
Parametry
-Association
Określa nazwę klasy skojarzenia. Jeśli ten parametr nie zostanie określony, polecenie cmdlet zwróci wszystkie istniejące obiekty skojarzenia dowolnego typu.
Jeśli na przykład klasa A jest skojarzona z klasą B za pośrednictwem dwóch skojarzeń, AB1 i AB2, ten parametr może służyć do określenia typu skojarzenia, AB1 lub AB2.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | 1 |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-CimSession
Uruchamia polecenie przy użyciu określonej sesji CIM. Wprowadź zmienną zawierającą sesję modelu CIM lub polecenie, które tworzy lub pobiera sesję modelu CIM, taką jak New-CimSession lub Get-CimSession. Aby uzyskać więcej informacji, zobacz about_CimSession.
Właściwości parametru
| Typ: | |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
SessionSet
| Position: | Named |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ComputerName
Określa nazwę komputera, na którym chcesz uruchomić operację CIM. Można określić w pełni kwalifikowaną nazwę domeny (FQDN) lub nazwę NetBIOS.
Jeśli określisz ten parametr, polecenie cmdlet utworzy sesję tymczasową na określonym komputerze przy użyciu protokołu WsMan.
Jeśli nie określisz tego parametru, polecenie cmdlet wykonuje operację na komputerze lokalnym przy użyciu modelu obiektów składników (COM).
Jeśli na tym samym komputerze jest wykonywanych wiele operacji, połączenie przy użyciu sesji modelu CIM zapewnia lepszą wydajność.
Właściwości parametru
| Typ: | String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | CN, NazwaSerwera |
Zestawy parametrów
ComputerSet
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-InputObject
Określa dane wejściowe tego polecenia cmdlet. Możesz użyć tego parametru lub przekazać dane wejściowe do tego polecenia cmdlet.
Parametr InputObject nie iteruje po kolekcjach. Jeśli kolekcja zostanie przekazana, zostanie zgłoszony błąd. Podczas pracy z kolekcjami należy przekazać dane wejściowe w celu wyliczenia wartości.
Właściwości parametru
| Typ: | CimInstance |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | CimInstance |
Zestawy parametrów
(All)
| Position: | 0 |
| Obowiązkowe: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-KeyOnly
Zwraca obiekty z wypełnionymi tylko właściwościami klucza. Zmniejsza to ilość danych przesyłanych za pośrednictwem sieci.
Właściwości parametru
| Typ: | SwitchParameter |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Namespace
Określa przestrzeń nazw dla operacji CIM. Domyślna przestrzeń nazw to root/cimv2.
Uwaga / Notatka
Za pomocą uzupełniania za pomocą klawisza Tab można przeglądać listę przestrzeni nazw, ponieważ PowerShell pobiera listę przestrzeni nazw z lokalnego serwera WMI w celu udostępnienia listy przestrzeni nazw.
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-OperationTimeoutSec
Określa czas, przez który polecenie cmdlet czeka na odpowiedź od komputera. Domyślnie wartość tego parametru to 0, co oznacza, że polecenie cmdlet używa domyślnej wartości limitu czasu dla serwera.
Jeśli parametr OperationTimeoutSec jest ustawiony na wartość mniejszą niż limit czasu ponawiania próby niezawodnego połączenia przez 3 minuty, awarie sieci, które trwają dłużej niż wartość parametru OperationTimeoutSec nie są możliwe do odzyskania, ponieważ operacja na serwerze przekracza limit czasu, zanim klient będzie mógł ponownie nawiązać połączenie.
Właściwości parametru
| Typ: | UInt32 |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
| Aliasy: | OT |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | True |
| Wartość z pozostałych argumentów: | False |
-ResourceUri
Określa jednolity identyfikator zasobu (URI) klasy zasobów lub jej wystąpienia. Identyfikator URI służy do identyfikowania określonego typu zasobu, takiego jak dyski lub procesy, na komputerze.
Identyfikator URI składa się z prefiksu i ścieżki do zasobu. Przykład:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDiskhttp://intel.com/wbem/wscim/1/amt-schema/1/AMT_GeneralSettings
Domyślnie, jeśli nie określisz tego parametru, używany jest identyfikator URI zasobu standardowego DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/, a nazwa klasy jest dołączana do niego.
ResourceURI można używać tylko z sesjami modelu CIM utworzonymi przy użyciu protokołu WSMan lub podczas określania parametru ComputerName, który tworzy sesję modelu CIM przy użyciu narzędzia WSMan. Jeśli ten parametr zostanie określony bez określenia parametru ComputerName lub jeśli określisz sesję modelu wspólnych informacji utworzoną przy użyciu protokołu DCOM, zostanie wyświetlony błąd, ponieważ protokół DCOM nie obsługuje parametru ResourceURI .
Jeśli określono zarówno parametr ResourceUri, jak i parametr Filter, parametr Filter zostanie zignorowany.
Właściwości parametru
| Typ: | Uri |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ResultClassName
Określa nazwę klasy skojarzonych wystąpień. Wystąpienie modelu CIM może być skojarzone z co najmniej jednym wystąpieniem modelu CIM. Wszystkie skojarzone wystąpienia modelu CIM są zwracane, jeśli nie określisz nazwy klasy wynikowej.
Domyślnie wartość tego parametru ma wartość null, a wszystkie skojarzone wystąpienia modelu CIM są zwracane.
Możesz filtrować wyniki skojarzenia, aby pasować do określonej nazwy klasy. Filtrowanie odbywa się na serwerze. Jeśli ten parametr nie zostanie określony, Get-CIMAssociatedInstance zwraca wszystkie istniejące skojarzenia. Jeśli na przykład klasa A jest skojarzona z klasami B, C i D, ten parametr może służyć do ograniczenia danych wyjściowych do określonego typu (B, C lub D).
Właściwości parametru
| Typ: | String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowe: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
None
Nie można przekazywać obiektów do tego cmdletu.
Dane wyjściowe
CimInstance
To polecenie cmdlet zwraca obiekt wystąpienia modelu CIM.
Uwagi
Program PowerShell zawiera następujące aliasy dla elementu "":
- Windows:
gcai
Ten cmdlet jest dostępny tylko na platformach Windows.