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 :
- URI avec un ou plusieurs sélecteurs. 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 .
- Objet ResourceLocator qui peut contenir des sélecteurs, des fragmentsou des options.
- Référence du point de terminaison WS-Addressing , comme décrit dans la norme du protocole WS-Management. Pour plus d’informations sur la spécification publique du protocole WS-Management, consultez la page index des spécifications de gestion.
-
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 |
|
| MIDL |
|
| Bibliothèque |
|
| DLL |
|