Baca dalam bahasa Inggris

Bagikan melalui


Objek ResourceLocator

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

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