Session.Create 方法

创建资源的新实例，并返回新对象的 EPR) (终结点引用 。

语法

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

参数

resourceUri [in]

要创建的资源的标识符。

此参数可以包含以下项之一：

• 具有一个或多个 选择器的 URI。 请注意， WMI 插件 不支持创建 除 WS 管理协议 侦听器以外的任何资源。
• ResourceLocator 对象，其中可能包含选择器、 片段或 选项。
• WS 寻址 终结点引用，如WS-Management协议标准中所述。 有关WS-Management协议的公共规范的详细信息，请参阅 管理规范索引页。

resource

包含资源内容的 XML。

flags [in， optional]

保留。 必须设置为 0。

返回值

新资源的 EPR。

备注

Session.Create 仅用于创建新资源实例。 使用 Session.Put 方法更新资源的现有实例。 获取新资源 URI 后，可以调用 Session.Get 来检索新对象。 新对象包含资源提供程序在创建新对象时分配的任何属性。 例如，如果创建新的WS-Management协议 侦听器 并使用 Session.Get 检索侦听器对象，则还会获取 Port、 Enabled 和 ListeningOn 属性。

请注意， WMI 插件 不支持创建除WS-Management协议侦听器以外的任何资源。

以下语法用于调用此方法。

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

示例

以下 VBScript 代码示例调用 Session.Create 以在本地计算机上创建侦听器。

'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

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
标头	WSManDisp.h
IDL	WSManDisp.idl
库	WSManDisp.tlb
DLL	WSMAuto.dll

另请参阅

会话

WS-Management 协议