Session.Create-Methode

Artikel
06/12/2023

Erstellt einen neuen instance einer Ressource und gibt den Endpunktverweis (Endpoint Reference, EPR) des neuen Objekts zurück.

Syntax

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

Parameter

resourceUri [in]

Bezeichner der zu erstellenden Ressource.

Dieser Parameter kann eine der folgenden Parameter enthalten:

URI mit mindestens einem Selektor. Beachten Sie, dass das WMI-Plug-In keine andere Ressource als einen WS-Management-Protokolllistener unterstützt.
ResourceLocator-Objekt , das Selektoren, Fragmente oder Optionen enthalten kann.
Referenz zum WS-Adressierungsendpunkt , wie im Protokollstandard WS-Management beschrieben. Weitere Informationen zur öffentlichen Spezifikation für WS-Management-Protokoll finden Sie unter Indexseite für Verwaltungsspezifikationen.

resource

Der XML-Code, der Ressourceninhalt enthält.

Flags [in, optional]

Reserviert. Muss auf 0 festgelegt werden.

Rückgabewert

Die EPR der neuen Ressource.

Bemerkungen

Session.Create wird nur zum Erstellen neuer Instanzen einer Ressource verwendet. Verwenden Sie die Session.Put-Methode , um vorhandene Instanzen einer Ressource zu aktualisieren. Nachdem Sie den neuen Ressourcen-URI abgerufen haben, können Sie Session.Get aufrufen, um das neue Objekt abzurufen. Das neue Objekt enthält alle Eigenschaften, die der Ressourcenanbieter beim Erstellen des neuen Objekts zuweist. Wenn Sie beispielsweise einen neuen WS-Management Protokolllistener erstellen und das Listenerobjekt mithilfe von Session.Get abrufen, erhalten Sie auch die Eigenschaften Port, Enabled und ListeningOn .

Beachten Sie, dass das WMI-Plug-In das Erstellen einer anderen Ressource als einen WS-Management-Protokolllistener nicht unterstützt.

Die folgende Syntax wird verwendet, um diese Methode aufzurufen.

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

Beispiele

Im folgenden VBScript-Codebeispiel wird Session.Create aufgerufen, um einen Listener auf dem lokalen Computer zu erstellen.

'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

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
WS-Verwaltungsprotokoll

Freigeben über