Udostępnij za pośrednictwem

Get-CimAssociatedInstance

  • Odwołanie
Moduł:
CimCmdlets

Pobiera wystąpienia modelu CIM połączone z określonym wystąpieniem modelu CIM przez skojarzenie.

Składnia

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>]

Opis

To polecenie cmdlet jest dostępne tylko na platformie Windows.

Polecenie Get-CimAssociatedInstance cmdlet 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 parametr InputObject nie jest określony, polecenie cmdlet działa w jeden z następujących sposobów:

  • Jeśli nie określono parametru ComputerName ani parametru CimSession , to polecenie cmdlet działa w lokalnej 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 względem serwera CIM określonego przez parametr ComputerName lub cimSession parametru.

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 przy użyciu Get-CimInstance polecenia cmdlet . Pierwsze wystąpienie dysku logicznego w zmiennej jest następnie używane jako obiekt wejściowy dla Get-CimAssociatedInstance polecenia cmdlet w celu pobrania wszystkich skojarzonych wystąpień 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 Get-CimAssociatedInstance polecenia cmdlet 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

Ten zestaw poleceń pobiera usługi zależne od usługi Winmgmt i przechowuje je w zmiennej o nazwie $s. Get-CimAssociatedInstance pobiera skojarzone wystąpienia pobranej klasy skojarzenia.

$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

Określa nazwę klasy skojarzenia. Jeśli nie określisz tego parametru, 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.

Typ:String
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-CimSession

Uruchamia polecenie przy użyciu określonej sesji modelu CIM. Wprowadź zmienną zawierającą sesję modelu CIM lub polecenie, które tworzy lub pobiera sesję modelu CIM, na przykład New-CimSession lub Get-CimSession. Aby uzyskać więcej informacji, zobacz about_CimSession.

Typ:CimSession[]
Position:Named
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych: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ść.

Typ:String[]
Aliasy:CN, ServerName
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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 wylicza się w 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.

Typ:CimInstance
Aliasy:CimInstance
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-KeyOnly

Zwraca obiekty z wypełnionymi tylko właściwościami klucza. Zmniejsza to ilość danych przesyłanych przez sieć.

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Namespace

Określa przestrzeń nazw dla operacji CIM. Domyślna przestrzeń nazw to root/cimv2.

Uwaga

Za pomocą uzupełniania karty można przeglądać listę przestrzeni nazw, ponieważ program PowerShell pobiera listę przestrzeni nazw z lokalnego serwera WMI w celu udostępnienia listy przestrzeni nazw.

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-OperationTimeoutSec

Określa czas oczekiwania polecenia cmdlet na odpowiedź z 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.

Typ:UInt32
Aliasy:OT
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceUri

Określa identyfikator URI (resource uniform resource identifier) klasy zasobów lub 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. Na przykład:

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

Domyślnie, jeśli nie określisz tego parametru, zostanie użyty standardowy identyfikator URI http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ zasobu DMTF i dołączona do niego nazwa klasy.

Identyfikator ResourceURI może być używany 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 określisz ten parametr bez określenia parametru ComputerName lub jeśli określisz sesję modelu CIM utworzoną przy użyciu protokołu DCOM, wystąpi 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.

Typ:Uri
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych: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).

Typ:String
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

None

Nie można potokować obiektów do tego polecenia cmdlet.

Dane wyjściowe

CimInstance

To polecenie cmdlet zwraca obiekt wystąpienia modelu CIM.

Uwagi

Program PowerShell zawiera następujące aliasy dla programu Get-CimAssociatedInstance:

  • Windows:
    • gcai

To polecenie cmdlet jest dostępne tylko na platformach windows.