Aracılığıyla paylaş

Get-CimAssociatedInstance

  • Başvuru
Modül:
CimCmdlets

İlişkilendirme tarafından belirli bir CIM örneğine bağlı CIM örneklerini alır.

Sözdizimi

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

Bu cmdlet yalnızca Windows platformunda kullanılabilir.

Get-CimAssociatedInstance cmdlet'i, kaynak örnek olarak adlandırılan belirli bir CIM örneğine bağlı CIM örneklerini bir ilişkilendirmeyle alır.

İlişkilendirmede, her CIM örneğinin adlandırılmış bir rolü vardır ve aynı CIM örneği farklı rollerdeki bir ilişkilendirmeye katılabilir.

InputObject parametresi belirtilmezse, cmdlet aşağıdaki yollardan biriyle çalışır:

  • ComputerName parametresi veya CimSession parametresi belirtilmezse, bu cmdlet bir Bileşen Nesne Modeli (COM) oturumu kullanarak yerel Windows Yönetim Araçları'nda (WMI) çalışır.
  • ComputerName parametresi veya CimSession parametresi belirtilirse, bu cmdlet ComputerName parametresi veya CimSession parametresi tarafından belirtilen CIM sunucusunda çalışır.

Örnekler

Örnek 1: Belirli bir örneğin tüm ilişkili örneklerini alma

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

Bu komut kümesi, Win32_LogicalDisk adlı sınıfın örneklerini alır ve $disk cmdlet'ini kullanarak bilgileri Get-CimInstance adlı bir değişkende depolar. Değişkendeki ilk mantıksal disk örneği, belirtilen CIM örneğinin tüm ilişkili CIM örneklerini almak için Get-CimAssociatedInstance cmdlet'inin giriş nesnesi olarak kullanılır.

Örnek 2: Belirli bir türün tüm ilişkili örneklerini alma

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

Bu komut kümesi, Win32_LogicalDisk sınıfının tüm örneklerini alır ve $diskadlı bir değişkende depolar. Değişkendeki ilk mantıksal disk örneği, belirtilen ilişkilendirme sınıfı Get-CimAssociatedInstanceile ilişkili tüm ilişkili örnekleri almak için cmdlet'inin giriş nesnesi olarak kullanılır.

Örnek 3: Belirli bir sınıfın niteleyicisi aracılığıyla tüm ilişkili örnekleri alma

Bu komut kümesi, Winmgmt hizmetine bağlı hizmetleri alır ve $sadlı bir değişkende depolar. Get-CimAssociatedInstance alınan ilişkilendirme sınıfının ilişkili örneklerini alır.

$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

Parametreler

-Association

İlişkilendirme sınıfının adını belirtir. Bu parametreyi belirtmezseniz, cmdlet herhangi bir türdeki tüm mevcut ilişkilendirme nesnelerini döndürür.

Örneğin, A sınıfı B sınıfıyla ab1 ve AB2 olmak üzere iki ilişkilendirme aracılığıyla ilişkilendirildiyse, bu parametre ab1 veya AB2 ilişkilendirme türünü belirtmek için kullanılabilir.

Tür:String
Position:1
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-CimSession

Belirtilen CIM oturumunu kullanarak komutunu çalıştırır. CIM oturumunu içeren bir değişken veya New-CimSession veya Get-CimSessiongibi CIM oturumunu oluşturan veya alan bir komut girin. Daha fazla bilgi için bkz. about_CimSession.

Tür:CimSession[]
Position:Named
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ComputerName

CIM işlemini çalıştırmak istediğiniz bilgisayarın adını belirtir. Tam etki alanı adı (FQDN) veya NetBIOS adı belirtebilirsiniz.

Bu parametreyi belirtirseniz, cmdlet WsMan protokolunu kullanarak belirtilen bilgisayarda geçici bir oturum oluşturur.

Bu parametreyi belirtmezseniz, cmdlet işlemi Bileşen Nesne Modeli (COM) kullanarak yerel bilgisayarda gerçekleştirir.

Aynı bilgisayarda birden çok işlem gerçekleştiriliyorsa, CIM oturumu kullanarak bağlanmak daha iyi performans sağlar.

Tür:String[]
Diğer adlar:CN, ServerName
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-InputObject

Bu cmdlet'in girişini belirtir. Bu parametreyi kullanabilir veya girişi bu cmdlet'e yöneltebilirsiniz.

InputObject parametresi koleksiyonlar üzerinde numaralandırılmıyor. Bir koleksiyon geçirilirse bir hata oluşur. Koleksiyonlarla çalışırken, değerleri numaralandırmak için girişi kanala yazın.

Tür:CimInstance
Diğer adlar:CimInstance
Position:0
Default value:None
Gerekli:True
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-KeyOnly

Yalnızca anahtar özellikleri doldurulmuş nesneleri döndürür. Bu, ağ üzerinden aktarılan veri miktarını azaltır.

Tür:SwitchParameter
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-Namespace

CIM işlemi için ad alanını belirtir. Varsayılan ad alanı kök/CIMV2 .

Not

PowerShell, ad alanlarının listesini sağlamak üzere yerel WMI sunucusundan bir ad alanı listesi aldığından, ad alanları listesine göz atmak için sekme tamamlama özelliğini kullanabilirsiniz.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-OperationTimeoutSec

Cmdlet'in bilgisayardan yanıt bekleme süresini belirtir. Varsayılan olarak, bu parametrenin değeri 0'dır; bu da cmdlet'in sunucu için varsayılan zaman aşımı değerini kullandığı anlamına gelir.

OperationTimeoutSec parametresi 3 dakikalık sağlam bağlantı yeniden deneme zaman aşımından daha küçük bir değere ayarlanırsa, istemci yeniden bağlanamadan önce sunucudaki işlem zaman aşımına uğraması nedeniyle OperationTimeoutSec parametresinin değerinden daha uzun süren ağ hataları kurtarılamaz.

Tür:UInt32
Diğer adlar:OT
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:True
Joker karakterleri kabul et:False

-ResourceUri

Kaynak sınıfının veya örneğin kaynak tekdüzen kaynak tanımlayıcısını (URI) belirtir. URI, bir bilgisayardaki diskler veya işlemler gibi belirli bir kaynak türünü tanımlamak için kullanılır.

URI bir ön ek ve kaynağın yolundan oluşur. Mesela:

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

Varsayılan olarak, bu parametreyi belirtmezseniz, DMTF standart kaynak URI'sini http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ kullanılır ve sınıf adı eklenir.

ResourceUri yalnızca WSMan protokolü kullanılarak oluşturulan CIM oturumlarıyla veya WSMan kullanarak bir CIM oturumu oluşturan ComputerName parametresi belirtilirken kullanılabilir. ComputerName parametresini belirtmeden bu parametreyi belirtirseniz veya DCOM protokolü kullanılarak oluşturulan bir CIM oturumu belirtirseniz, DCOM protokolü ResourceUri parametresini desteklemediğinden bir hata alırsınız.

hem ResourceUri parametresi hem de Filter parametresi belirtilirse, Filter parametresi yoksayılır.

Tür:Uri
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

-ResultClassName

İlişkili örneklerin sınıf adını belirtir. CIM örneği bir veya daha fazla CIM örneğiyle ilişkilendirilebilir. Sonuç sınıfı adını belirtmezseniz tüm ilişkili CIM örnekleri döndürülür.

Varsayılan olarak, bu parametrenin değeri null olur ve ilişkili tüm CIM örnekleri döndürülür.

İlişkilendirme sonuçlarını belirli bir sınıf adıyla eşleşecek şekilde filtreleyebilirsiniz. Filtreleme sunucuda gerçekleşir. Bu parametre belirtilmezse, Get-CimAssociatedInstance var olan tüm ilişkilendirmeleri döndürür. Örneğin, A sınıfı B, C ve D sınıflarıyla ilişkiliyse, bu parametre çıkışı belirli bir türle (B, C veya D) kısıtlamak için kullanılabilir.

Tür:String
Position:Named
Default value:None
Gerekli:False
İşlem hattı girişini kabul et:False
Joker karakterleri kabul et:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

CimInstance

Bu cmdlet bir CIM örneği nesnesi döndürür.

Notlar

PowerShell, Get-CimAssociatedInstanceiçin aşağıdaki diğer adları içerir:

  • Windows:
    • gcai

Bu cmdlet yalnızca Windows platformlarında kullanılabilir.