Metodo Session.Put

Aggiorna una risorsa.

Sintassi

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

Parametri

resourceUri [in]

Identificatore della risorsa da aggiornare.

Questo parametro può contenere uno degli elementi contenuti nell'elenco seguente:

  • URI con o senza selettori. Quando si chiama il metodo Put per ottenere una risorsa WMI, utilizzare la proprietà o le proprietà chiave dell'oggetto. Nell'esempio di codice Visual Basic Scripting Edition (VBScript) seguente, ad esempio, la chiave viene specificata da Win32_Service?Name=winmgmt.

    strResourceUri = "http://schemas.microsoft.com/" & _ 
      "wbem/wsman/1/wmi/root/cimv2/Win32_Service?Name=winmgmt"
    
  • Oggetto ResourceLocator che può contenere selettori, frammenti o opzioni.

  • Riferimento all'endpoint WS-Addressing come descritto nello standard WS-Management Protocol. Per altre informazioni sulla specifica pubblica per il protocollo di WS-Management, vedere Pagina relativa all'indice delle specifiche di gestione.

risorsa [in]

Contenuto della risorsa aggiornato.

flag [in, facoltativo]

Riservato. Deve essere 0.

Valore restituito

CODICE XML contenente il contenuto della risorsa aggiornato.

Esempio

Nell'esempio di codice VBScript seguente i dati vengono scritti nell'oggetto Win32_WMISetting. È necessario includere tutte le proprietà non di matrice dell'oggetto nel codice XML del parametro Resource . L'ordine delle proprietà non è significativo.


'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

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista
Server minimo supportato
Windows Server 2008
Intestazione
WSManDisp.h
IDL
WSManDisp.idl
Libreria
WSManDisp.tlb
DLL
WSMAuto.dll

Vedi anche

sessione