Método Session.Put

Artículo
06/12/2023

Actualiza un recurso.

Sintaxis

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

Parámetros

resourceUri [in]

Identificador del recurso que se va a actualizar.

Este parámetro puede contener uno de los elementos contenidos en la lista siguiente:

URI con o sin selectores. Al llamar al método Put para obtener un recurso WMI, use la propiedad de clave o las propiedades del objeto . Por ejemplo, en el siguiente ejemplo de código de Visual Basic Scripting Edition (VBScript), la clave se especifica mediante Win32_Service?Name=winmgmt.
```
strResourceUri = "http://schemas.microsoft.com/" & _ 
  "wbem/wsman/1/wmi/root/cimv2/Win32_Service?Name=winmgmt"
```
Objeto ResourceLocator que puede contener selectores, fragmentos o opciones.
Referencia del punto de conexión WS-Addressing tal como se describe en el estándar WS-Management Protocol. Para obtener más información sobre la especificación pública para WS-Management protocolo, vea Página de índice de especificaciones de administración.

recurso [in]

Contenido del recurso actualizado.

flags [in, optional]

Reservado. Se debe establecer en 0.

Valor devuelto

Xml que contiene el contenido del recurso actualizado.

Ejemplos

En el siguiente ejemplo de código de VBScript se escriben datos en el objeto Win32_WMISetting . Debe incluir todas las propiedades que no son de matriz del objeto en el XML del parámetro Resource . El orden de las propiedades no es 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

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	WSManDisp.h
IDL	WSManDisp.idl
Biblioteca	WSManDisp.tlb
Archivo DLL	WSMAuto.dll

Consulte también

Sesión