Objek ResourceLocator

Artikel
06/13/2023

Objek yang memasok jalur ke sumber daya. Anda dapat menggunakan objek ResourceLocator alih-alih URI sumber daya dalam operasi objek Sesi seperti Session.Get, Session.Put, atau Session.Enumerate.

Objek ini memungkinkan Anda untuk:

Tambahkan satu atau beberapa pemilih yang mengidentifikasi instans sumber daya tertentu. Ini sama dengan menyediakan nilai kunci dalam URI sumber daya untuk sumber daya yang menggunakan kunci. Untuk informasi selengkapnya, lihat ResourceLocator.AddSelector. Anda dapat melakukan operasi serupa menggunakan parameter filter dalam panggilan ke Session.Enumerate.
Tentukan jalur fragmen dan dialek untuk mendapatkan hanya satu properti sumber daya. Anda juga dapat menentukan satu atau semua elemen properti array dengan menyediakan indeks array. Untuk informasi selengkapnya, lihat ResourceLocator.FragmentPath.
Tambahkan satu atau beberapa opsi yang mungkin diperlukan sumber data untuk memproses permintaan. Untuk informasi selengkapnya, lihat ResourceLocator.AddOption.

Untuk informasi selengkapnya, lihat Mengkueri Instans Tertentu dari Sumber Daya.

Anggota

Objek ResourceLocator memiliki jenis anggota ini:

Metode
Properti

Metode

Objek ResourceLocator memiliki metode ini.

Metode	Deskripsi
AddOption	Menambahkan data tambahan yang diperlukan untuk memproses permintaan.
AddSelector	Menambahkan pemilih ke objek ResourceLocator .
ClearOptions	Menghapus opsi apa pun dari objek ResourceLocator .
ClearSelectors	Menghapus semua pemilih dari objek ResourceLocator .

Properti

Objek ResourceLocator memiliki properti ini.

Properti	Jenis akses	Deskripsi
FragmentDialect	Baca/Tulis	Mendapatkan atau mengatur dialek bahasa untuk fragmensumber daya.
FragmentPath	Baca/Tulis	Mendapatkan atau mengatur jalur untuk fragmen atau properti sumber daya.
MustUnderstandOptions	Baca/Tulis	Mendapatkan atau mengatur nilai MustUnderstandOptions untuk objek ResourceLocator .
ResourceURI	Baca/Tulis	Mendapatkan atau mengatur URI sumber daya dalam objek ResourceLocator .

Keterangan

Objek ResourceLocator sesuai dengan antarmuka IWSManResourceLocator .

Contoh

Contoh kode VBScript berikut mendapatkan properti NumberOfLogicalProcessors dan NumberOfCores dari instans Win32_Processor tertentu.

Option Explicit
Dim strUri
strUri = "http://schemas.microsoft.com/wbem/wsman/1/" _
    & "wmi/root/cimv2/Win32_Processor"
Const FragmentDialect = _
    "https://www.w3.org/TR/1999/REC-xpath-19991116"

Dim WSMan
Set WSMan = CreateObject("WSMan.Automation")

Dim Session
Set Session = WSMan.CreateSession

Dim Locator
Set Locator = WSMan.CreateResourceLocator(strUri)

Locator.AddSelector "DeviceID", "CPU0"

Dim NumberOfCores_XML
Locator.FragmentPath = "NumberOfCores"
Locator.FragmentDialect = FragmentDialect
NumberOfCores_XML = Session.Get(Locator)
DisplayOutput NumberOfCores_XML

Dim NumberOfLogicalProcessors_XML
Locator.FragmentPath = "NumberOfLogicalProcessors"
Locator.FragmentDialect = FragmentDialect
NumberOfLogicalProcessors_XML = Session.Get(Locator)

DisplayOutput NumberOfLogicalProcessors_XML

'****************************************************
' Displays WinRM XML message using built-in XSL
'****************************************************

Sub DisplayOutput( strWinRMXml )
    Dim xmlFile, xslFile
    Set xmlFile = CreateObject( "MSXml2.DOMDocument.3.0" )    
    Set xslFile = CreateObject( "MSXml2.DOMDocument.3.0" )
    xmlFile.LoadXml( strWinRMXml )
    xslFile.Load( "WsmTxt.xsl" )
    Wscript.Echo xmlFile.TransformNode( xslFile )           
End Sub

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	WSManDisp.h
IDL	WSManDisp.idl
Pustaka	WSManDisp.tlb
DLL	WSMAuto.dll

Lihat juga

API Pembuatan Skrip WinRM