ASOSIATOR Pernyataan

Pernyataan ASSOCIATORS OF mengambil semua instans yang terkait dengan instans sumber tertentu. Instans yang diambil disebut sebagai titik akhir. Setiap titik akhir dikembalikan sebanyak ada hubungan antara titik akhir dan objek sumber. Misalnya, asumsikan ada instans A, B, X, dan Y. Ada dua instans asosiasi, satu yang menautkan A dan X dan satu lagi yang menautkan B dan Y. Kueri berikut mengembalikan titik akhir tunggal X:

ASSOCIATORS OF {A}

Namun, jika ada asosiasi lain yang menautkan A dan X, kueri di atas mengembalikan dua titik akhir X.

Sintaks dasar untuk pernyataan ASSOCIATORS OF adalah:

ASSOCIATORS OF {ObjectPath}

Perhatikan bahwa kurung kurawal adalah bagian dari sintaks. Jalur objek apa pun yang valid dapat digunakan untuk ObjectPath. Token dalam jalur objek tidak boleh berisi spasi kosong. Misalnya, kueri dalam daftar berikut mengembalikan instans yang terkait dengan disk logis yang ditentukan:

Query:

ASSOCIATORS OF {Win32_LogicalDisk.DeviceID="C:"}

Hasil:

Win32_Directory.Name="C:\\"

Win32_ComputerSystem.Name="mycomputer"
Win32_DiskPartition.DeviceID="Disk #0, Partition #0"

Seperti pernyataan SELECT, pernyataan ASSOCIATORS OF dapat menyertakan klausa WHERE, tetapi klausa WHERE untuk pernyataan ASSOCIATORS OF sangat berbeda dari klausul SELECT statementWHERE.

Klausa WHERE dari pernyataan ASSOCIATORS OF dapat menyertakan satu atau beberapa kata kunci yang telah ditentukan sebelumnya berikut dan nilainya:

ASSOCIATORS OF {ObjectPath} WHERE
    AssocClass = AssocClassName
    ClassDefsOnly
    RequiredAssocQualifier = QualifierName
    RequiredQualifier = QualifierName
    ResultClass = ClassName
    ResultRole = PropertyName
    Role = PropertyName

Perhatikan bahwa subklausim opsional tidak dipisahkan oleh koma.

Kata kunci AssocClass menunjukkan bahwa titik akhir yang dikembalikan harus dikaitkan dengan sumber melalui kelas yang ditentukan atau salah satu kelas turunannya. Misalnya, kueri dalam daftar berikut hanya mengembalikan titik akhir yang terkait dengan sumber melalui kelas asosiasi Win32_SystemDevices atau salah satu kelas turunannya:

Query:

ASSOCIATORS OF {Win32_LogicalDisk.DeviceID="C:"} WHERE AssocClass = Win32_SystemDevices

Hasil:

Win32_ComputerSystem.Name="mycomputer"

Kata kunci ClassDefsOnly menunjukkan bahwa klausul mengembalikan kumpulan hasil objek definisi kelas daripada instans kelas aktual. Objek-objek ini adalah definisi kelas tempat instans titik akhir berada. Misalnya, kueri dalam daftar berikut mengembalikan definisi untuk kelas Win32_Directory dan Win32_ComputerSystem :

Query:

ASSOCIATORS OF {Win32_LogicalDisk.DeviceID="C:"} WHERE ClassDefsOnly

Hasil:

Win32_Directory

Win32_ComputerSystem
Win32_DiskPartition

Kata kunci ClassDefsOnly dan ResultClass saling eksklusif. Menggunakannya bersama-sama menyebabkan kesalahan kueri yang tidak valid.

Kata kunci RequiredAssocQualifier menunjukkan bahwa titik akhir yang dikembalikan harus dikaitkan dengan objek sumber melalui kelas asosiasi yang menyertakan kualifikasi yang ditentukan. Jenis pemfilteran ini digunakan untuk menghilangkan berbagai titik akhir kecuali titik akhir dikaitkan dengan target melalui serangkaian kelas asosiasi yang diberi tag tertentu. Misalnya, kueri dalam daftar berikut mengembalikan instans titik akhir jika kelas asosiasi menyertakan kualifikasi yang disebut Asosiasi.

Query:

ASSOCIATORS OF {Win32_LogicalDisk.DeviceID="C:"}
   WHERE RequiredAssocQualifier = Association

Hasil:

Win32_Directory.Name="C:\\"

Win32_ComputerSystem.Name="mycomputer"
Win32_DiskPartition.DeviceID="Disk #0, Partition #0"

Kata kunci RequiredQualifier menunjukkan bahwa titik akhir yang dikembalikan yang terkait dengan objek sumber harus menyertakan kualifikasi yang ditentukan. Kata kunci RequiredQualifier dapat digunakan untuk menyertakan jenis instans tertentu dalam tataan hasil. Misalnya, kueri dalam daftar berikut mengembalikan instans titik akhir yang menyertakan kualifikasi yang disebut Lokal.

Query:

ASSOCIATORS OF {Win32_LogicalDisk.DeviceID="C:"} WHERE RequiredQualifier = Locale

Hasil:

Win32_Directory.Name="C:\\"

Win32_ComputerSystem.Name="mycomputer"
Win32_DiskPartition.DeviceID="Disk #0, Partition #0"

Kata kunci ResultClass menunjukkan bahwa titik akhir yang dikembalikan yang terkait dengan objek sumber harus dimiliki atau berasal dari kelas yang ditentukan. Misalnya, kueri dalam daftar berikut mengembalikan instans titik akhir yang berasal dari kelas CIM_Directory :

Query:

ASSOCIATORS OF {Win32_LogicalDisk.DeviceID="C:"} WHERE ResultClass = Cim_Directory

Hasil:

Win32_Directory.Name="C:\\"

Kata kunci ClassDefsOnly dan ResultClass saling eksklusif. Menggunakannya bersama-sama menyebabkan kesalahan kueri yang tidak valid.

Kata kunci ResultRole menunjukkan bahwa titik akhir yang dikembalikan harus memainkan peran tertentu dalam hubungannya dengan objek sumber. Peran ditentukan oleh properti yang ditentukan, properti referensi jenis ref. Misalnya, kata kunci ResultRole dapat digunakan untuk mengambil semua titik akhir yang memiliki properti GroupComponent dalam hubungannya dengan objek sumber, seperti yang diilustrasikan kueri berikut.

Query:

ASSOCIATORS OF {Win32_LogicalDisk.DeviceID="C:"} WHERE ResultRole = GroupComponent

Hasil:

Win32_ComputerSystem.Name="mycomputer"

Kata kunci Peran menunjukkan bahwa titik akhir yang dikembalikan berpartisipasi dalam asosiasi dengan objek sumber tempat objek sumber memainkan peran tertentu. Peran ditentukan oleh properti yang ditentukan, properti referensi jenis ref. Misalnya, kata kunci Peran dapat digunakan untuk mengambil semua titik akhir yang terkait dengan objek sumber yang memiliki properti GroupComponent , seperti yang diilustrasikan kueri berikut.

Query:

ASSOCIATORS OF {Win32_LogicalDisk.DeviceID="C:"}
   WHERE Role = GroupComponent

Hasil:

Win32_Directory.Name="C:\\"

Catatan

Kueri kompleks tidak dapat menggunakan "And" atau "Or" untuk memisahkan kata kunci untuk PERNYATAAN ASSOCIATORS OF dan REFERENCES OF . Selain itu, tanda sama dengan adalah satu-satunya operator valid yang dapat digunakan dalam kueri tersebut. Misalnya, kueri berikut ini valid:

 

ASSOCIATORS OF {win32_LogicalDisk="C:"} WHERE resultClass = Win32_Directory requiredQualifier = Dynamic

Catatan

Contoh berikutnya tidak valid. Contoh pertama tidak menggunakan tanda sama dengan dan contoh kedua secara keliru mencoba menggunakan kata kunci AND .

 

Associators of {win32_LogicalDisk="C:"} where resultClass = Win32_Directory requiredQualifier <> Dynamic

Associators of {win32_LogicalDisk="C:"} where resultClass = Win32_Directory AND requiredQualifier = Dynamic