Session.Put-Methode

Artikel
06/13/2023

Aktualisieren Sie eine Ressource.

Syntax

Session.Put( _
  ByVal resourceUri, _
  ByVal resource, _
  [ ByVal flags ] _
)

Parameter

resourceUri [in]

Der Bezeichner der zu aktualisierenden Ressource.

Dieser Parameter kann eines der Elemente enthalten, die in der folgenden Liste enthalten sind:

URI mit oder ohne Selektoren. Verwenden Sie beim Aufrufen der Put-Methode zum Abrufen einer WMI-Ressource die Schlüsseleigenschaft oder die Eigenschaften des -Objekts. Im folgenden VbScript-Codebeispiel (Visual Basic Scripting Edition) wird der Schlüssel beispielsweise durch Win32_Service?Name=winmgmtangegeben.
```
strResourceUri = "http://schemas.microsoft.com/" & _ 
  "wbem/wsman/1/wmi/root/cimv2/Win32_Service?Name=winmgmt"
```
ResourceLocator-Objekt , das Selektoren, Fragmente oder Optionen enthalten kann.
Referenz zum WS-Adressierungsendpunkt , wie im WS-Verwaltungsprotokollstandard beschrieben. Weitere Informationen zur öffentlichen Spezifikation für WS-Management-Protokoll finden Sie unter Indexseite für Verwaltungsspezifikationen.

Ressource [in]

Der aktualisierte Ressourceninhalt.

Flags [in, optional]

Reserviert. Muss auf 0 festgelegt werden.

Rückgabewert

Der XML-Code, der den aktualisierten Ressourceninhalt enthält.

Beispiele

Im folgenden VBScript-Codebeispiel werden Daten in das Win32_WMISetting-Objekt geschrieben. Sie müssen alle Nicht-Array-Eigenschaften des -Objekts in den XML-Code des Resource-Parameters einschließen. Die Reihenfolge der Eigenschaften ist nicht signifikant.


'Create a WSMan object.
Set objWsman = CreateObject( "WSMAN.Automation" )
If objWsman is Nothing Then
    WScript.Echo "Failed to create WSMAN Automation object"
    WScript.Quit
End If 

'Create a Session object.
Set objSession = objWsman.CreateSession
If objSession is Nothing Then
    WScript.Echo "Failed to create WSMAN Session object"
    WScript.Quit
End If 

'Change the property value by putting
'the new XML content into the resource.
Dim strResourceUri, strReturnedResourceUri, newXmlContent
strResourceUri = "http://schemas.microsoft.com/wbem/wsman/1/" _
  & "wmi/root/cimv2/Win32_WMISetting"
newXmlContent = _
  "<p:Win32_WMISetting xmlns:p=""http://schemas.microsoft.com/" & _
  "wbem/wsman/1/wmi/root/cimv2/Win32_WMISetting"">" & _
  "<p:LoggingLevel>2</p:LoggingLevel></p:Win32_WMISetting>" 

On Error Resume Next
strReturnedResourceUri = objSession.Put(reourceUri, newXmlContent)
WScript.Echo "Returned resource Uri:" & Chr(10) & _
  strReturnedResourceUri
If Err.Number <> 0 Then
    DisplayErrorInfo
End If
On Error Goto 0

Sub DisplayErrorInfo()
    WScript.Echo "An error has occurred."     
    WScript.Echo
    WScript.Echo "Error Info"
    WScript.Echo "-----------"
    WScript.Echo "Number      : 0x" & hex(Err.number)
    WScript.Echo "Description : " & Err.Description
    WScript.Echo "Source      : " & Err.Source
    WScript.Echo "HelpFile    : " & Err.helpfile
    WScript.Echo "HelpContext : " & Err.HelpContext    
    WScript.Echo Err.Clear    
End Sub

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Header	WSManDisp.h
IDL	WSManDisp.idl
Bibliothek	WSManDisp.tlb
DLL	WSMAuto.dll

Siehe auch

Sitzung