Get-CimAssociatedInstance

Modul:

CimCmdlets Module

Mengambil instans CIM yang terhubung ke instans CIM tertentu oleh asosiasi.

Sintaks

ComputerSet (Default)

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

Deskripsi

Cmdlet ini hanya tersedia di platform Windows.

cmdlet Get-CimAssociatedInstance mengambil instans CIM yang terhubung ke instans CIM tertentu, yang disebut instans sumber, oleh asosiasi.

Dalam asosiasi, setiap instans CIM memiliki peran bernama dan instans CIM yang sama dapat berpartisipasi dalam asosiasi dalam peran yang berbeda.

Jika parameter InputObject tidak ditentukan, cmdlet berfungsi dengan salah satu cara berikut:

• Jika parameter ComputerName maupun parameter CimSession ditentukan, maka cmdlet ini berfungsi pada Instrumentasi Manajemen Windows (WMI) lokal menggunakan sesi Model Objek Komponen (COM).
• Jika parameter ComputerName atau parameter CimSession ditentukan, cmdlet ini berfungsi terhadap server CIM yang ditentukan oleh parameter ComputerName atau parameter CimSession .

Contoh

Contoh 1: Mendapatkan semua instans terkait dari instans tertentu

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

Kumpulan perintah ini mengambil instans kelas bernama Win32_LogicalDisk dan menyimpan informasi dalam variabel bernama $disk menggunakan cmdlet Get-CimInstance. Instans disk logis pertama dalam variabel kemudian digunakan sebagai objek input untuk cmdlet Get-CimAssociatedInstance untuk mendapatkan semua instans CIM terkait dari instans CIM yang ditentukan.

Contoh 2: Mendapatkan semua instans terkait dari jenis tertentu

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

Kumpulan perintah ini mengambil semua instans kelas Win32_LogicalDisk dan menyimpannya dalam variabel bernama $disk. Instans disk logis pertama dalam variabel kemudian digunakan sebagai objek input untuk cmdlet Get-CimAssociatedInstance untuk mendapatkan semua instans terkait yang terkait melalui kelas asosiasi yang ditentukan Win32_DiskPartition.

Contoh 3: Dapatkan semua instans terkait melalui kualifikasi kelas tertentu

Kumpulan perintah ini mengambil layanan yang bergantung pada layanan Winmgmt dan menyimpannya dalam variabel bernama $s. Get-CimAssociatedInstance mendapatkan instans terkait dari kelas asosiasi yang diambil.

$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

Parameter

-Association

Menentukan nama kelas asosiasi. Jika Anda tidak menentukan parameter ini, cmdlet mengembalikan semua objek asosiasi yang ada dari jenis apa pun.

Misalnya, jika kelas A dikaitkan dengan kelas B melalui dua asosiasi, AB1 dan AB2, maka parameter ini dapat digunakan untuk menentukan jenis asosiasi, baik AB1 atau AB2.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	1
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-CimSession

Menjalankan perintah menggunakan sesi CIM yang ditentukan. Masukkan variabel yang berisi sesi CIM, atau perintah yang membuat atau mendapatkan sesi CIM, seperti New-CimSession atau Get-CimSession. Untuk informasi lebih lanjut, lihat about_CimSession.

Properti parameter

Jenis:	CimSession[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

SessionSet

Position:	Named
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ComputerName

Menentukan nama komputer tempat Anda ingin menjalankan operasi CIM. Anda dapat menentukan nama domain yang sepenuhnya memenuhi syarat (FQDN) atau nama NetBIOS.

Jika Anda menentukan parameter ini, cmdlet membuat sesi sementara ke komputer yang ditentukan menggunakan protokol WsMan.

Jika Anda tidak menentukan parameter ini, cmdlet melakukan operasi pada komputer lokal menggunakan Model Objek Komponen (COM).

Jika beberapa operasi sedang dilakukan pada komputer yang sama, menyambungkan menggunakan sesi CIM memberikan performa yang lebih baik.

Properti parameter

Jenis:	String[]
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	CN, ServerName

Set parameter

ComputerSet

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-InputObject

Menentukan input ke cmdlet ini. Anda dapat menggunakan parameter ini, atau Anda dapat menyalurkan input ke cmdlet ini.

Parameter InputObject tidak menghitung koleksi. Jika koleksi diteruskan, kesalahan akan muncul. Saat bekerja dengan koleksi, pipa input untuk menghitung nilai.

Properti parameter

Jenis:	CimInstance
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	CimInstance

Set parameter

(All)

Position:	0
Wajib:	True
Nilai dari alur:	True
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-KeyOnly

Mengembalikan objek hanya dengan properti kunci yang diisi. Ini mengurangi jumlah data yang ditransfer melalui jaringan.

Properti parameter

Jenis:	SwitchParameter
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-Namespace

Menentukan namespace untuk operasi CIM. Namespace default root/CIMV2 .

Nota

Anda dapat menggunakan penyelesaian tab untuk menelusuri daftar namespace, karena PowerShell mendapatkan daftar namespace dari server WMI lokal untuk menyediakan daftar namespace.

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-OperationTimeoutSec

Menentukan jumlah waktu cmdlet menunggu respons dari komputer. Secara default, nilai parameter ini adalah 0, yang berarti bahwa cmdlet menggunakan nilai batas waktu default untuk server.

Jika parameter OperationTimeoutSec diatur ke nilai yang kurang dari batas waktu coba lagi koneksi yang kuat selama 3 menit, kegagalan jaringan yang berlangsung lebih dari nilai parameter OperationTimeoutSec tidak dapat dipulihkan, karena operasi pada waktu server habis sebelum klien dapat terhubung kembali.

Properti parameter

Jenis:	UInt32
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False
Alias:	OT

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	True
Nilai dari argumen yang tersisa:	False

-ResourceUri

Menentukan pengidentifikasi sumber daya seragam sumber daya (URI) dari kelas atau instans sumber daya. URI digunakan untuk mengidentifikasi jenis sumber daya tertentu, seperti disk atau proses, di komputer.

URI terdiri dari awalan dan jalur ke sumber daya. Contohnya:

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

Secara default, jika Anda tidak menentukan parameter ini, URI sumber daya standar DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ digunakan dan nama kelas ditambahkan ke parameter tersebut.

ResourceUri hanya dapat digunakan dengan sesi CIM yang dibuat menggunakan protokol WSMan, atau saat menentukan parameter ComputerName, yang membuat sesi CIM menggunakan WSMan. Jika Anda menentukan parameter ini tanpa menentukan parameter ComputerName, atau jika Anda menentukan sesi CIM yang dibuat menggunakan protokol DCOM, Anda mendapatkan kesalahan, karena protokol DCOM tidak mendukung parameter ResourceUri.

Jika parameter ResourceUri dan parameter Filter ditentukan, parameter Filter diabaikan.

Properti parameter

Jenis:	Uri
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

-ResultClassName

Menentukan nama kelas instans terkait. Instans CIM dapat dikaitkan dengan satu atau beberapa instans CIM. Semua instans CIM terkait dikembalikan jika Anda tidak menentukan nama kelas hasil.

Secara default, nilai parameter ini null, dan semua instans CIM terkait dikembalikan.

Anda dapat memfilter hasil asosiasi agar sesuai dengan nama kelas tertentu. Pemfilteran terjadi di server. Jika parameter ini tidak ditentukan, Get-CimAssociatedInstance mengembalikan semua asosiasi yang ada. Misalnya, jika kelas A dikaitkan dengan kelas B, C dan D, maka parameter ini dapat digunakan untuk membatasi output ke jenis tertentu (B, C atau D).

Properti parameter

Jenis:	String
Nilai default:	None
Mendukung wildcard:	False
DontShow:	False

Set parameter

(All)

Position:	Named
Wajib:	False
Nilai dari alur:	False
Nilai dari alur berdasarkan nama properti:	False
Nilai dari argumen yang tersisa:	False

CommonParameters

Cmdlet ini mendukung parameter umum: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, dan -WarningVariable. Untuk informasi selengkapnya, lihat about_CommonParameters.

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

CimInstance

Cmdlet ini mengembalikan objek instans CIM.

Catatan

PowerShell menyertakan alias berikut untuk Get-CimAssociatedInstance:

• Windows:
  • gcai

Cmdlet ini hanya tersedia di platform Windows.

Link Terkait

• Get-CimClass
• Get-CimInstance