Get-CimAssociatedInstance
İlişkilendirme tarafından belirli bir CIM örneğine bağlı CIM örneklerini alır.
Sözdizimi
ComputerSet EnterprisePublishing
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
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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 1 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
SessionSet
| Position: | Named |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ComputerName
CIM işlemini çalıştırmak istediğiniz bilgisayarın adını belirtir. Tam nitelikli 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | Çin, SunucuAdı |
Parametre kümeleri
ComputerSet
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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 aktarılırsa bir hata oluşur. Koleksiyonlarla çalışırken, değerleri numaralandırmak için girdiyi yönlendirin.
Parametre özellikleri
| Tür: | CimInstance |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | CimInstance |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | True |
| İşlem hattından gelen değer: | True |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-KeyOnly
Yalnızca anahtar özellikleri doldurulmuş nesneleri döndürür. Bu, ağ üzerinden aktarılan veri miktarını azaltır.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Namespace
CIM işlemi için ad alanını belirtir. Varsayılan ad alanı kök/CIMV2 .
Uyarı
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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | UInt32 |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
| Diğer adlar: | OT |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ResourceUri
Kaynak sınıfının veya örneğinin 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. Örneğin:
http://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDiskhttp://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.
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
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.
