Session. Create, méthode

Crée une nouvelle instance d’une ressource et retourne la référence de point de terminaison (EPR) du nouvel objet.

Syntaxe

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

Paramètres

resourceuri [ dans]

Identificateur de la ressource à créer.

Ce paramètre peut contenir l’un des éléments suivants :

resource

XML qui contient le contenu des ressources.

indicateurs [ dans, facultatif]

Réservé. Doit avoir la valeur 0.

Valeur retournée

EPR de la nouvelle ressource.

Remarques

Session. Create est utilisé uniquement pour créer des instances d’une ressource. Utilisez la méthode session. put pour mettre à jour les instances existantes d’une ressource. Une fois que vous avez obtenu le nouvel URI de ressource, vous pouvez appeler session. obtenir pour récupérer le nouvel objet. Le nouvel objet contient toutes les propriétés assignées par le fournisseur de ressources lors de la création du nouvel objet. Par exemple, si vous créez un écouteur de protocole WS-Management et que vous récupérez l’objet écouteur à l’aide de session. obtenir, vous obtenez également les propriétés port, Enabled et ListeningOn .

N’oubliez pas que le plug-in WMI ne prend pas en charge la création d’une ressource autre qu’un écouteur de protocole WS-Management.

La syntaxe suivante est utilisée pour appeler cette méthode.

uri = session.Create("<resourceUri>", "<resource>")

Exemples

L’exemple de code VBScript suivant appelle session. Create pour créer un écouteur sur l’ordinateur local.

'Create a WSMan object
Set oWsman = CreateObject( "WSMAN.Automation" )

'Create a Session object
Set oSession = oWsman.CreateSession

'Define resourceUri and inputXml 
resourceUri = "http://schemas.microsoft.com/wbem/wsman/1/"_
    & "config/Listener?Address=*+Transport=HTTP"

inputXml = _
    "<cfg:Listener xmlns:cfg=""https://schemas.dmtf.org/wbem/wsman/1/"_
    & "config/Listener.xsd"">" _
    & "<cfg:Hostname>" & GetFQDNName() & "</cfg:Hostname>" _            
    & "</cfg:Listener>"

'Perform the create operation.
response = oSession.Create( resourceUri, inputXml )
WScript.Echo "Response message: " & Chr(10) & response

Function GetFQDNName()
    Dim oShell, userDNSDomain, localComputerName
    Set oShell = CreateObject("WScript.Shell")
    userDNSDomain = oShell.ExpandEnvironmentStrings("%USERDNSDOMAIN%")

    localComputerName = _
        oShell.ExpandEnvironmentStrings("%ComputerName%")
    If userDNSDomain = "%USERDNSDOMAIN%" Then
        GetFQDNName= localComputerName
    Else
        GetFQDNName= localComputerName & "." & userDNSDomain
    End If
End Function

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
En-tête
WSManDisp. h
MIDL
WSManDisp. idl
Bibliothèque
WSManDisp. tlb
DLL
WSMAuto.dll

Voir aussi

session

Protocole Gestion des services web