IT工程師數位筆記本

vSphere Management SDK關于vmware管理等相關功能的.net和java的代碼示例。

在其5.5的解壓包中

eam：esx agent management表示esx虛機生產環境的代理

sms：storage monitoring management存儲監控

spbm：storage policy based management存儲策略

ssoclient：客戶端單點登錄驗證

vsphere-ws：web service api

當打開sample解決方案時會發現缺失一些dll文件。

對于Microsoft.Web.Services3.dll是微軟wse3.0中的一個dll文件，可以用它來生產安全的web服務。

下載地址http://www.microsoft.com/en-us/download/details.aspx?id=14089

Vim25Service.dll和Vim25Service.XmlSerializers.dll以及VMWare.Vim.dll則包含了對vmware虛機的管理的api。可以安裝VMware vSphere PowerCLI工具集，然后在C:\Windows\Assembly\GAC_MSIL目錄下找到對應的dll，下載地址https://developercenter.vmware.com/sdks。

當然在vSphere Management SDK開發包中也提供了基于web的服務接口，在...SDK\vsphere-ws\wsdl\vim25目錄下，可以通過wse工具生成dll文件。

關于wse工具安裝配置，安裝運行時、工具集和vs工具這三個選項。

這里提供兩種編譯方式，一種是通過tool工具中的WseWsdl3.exe，一種是vs擴展工具。

 安裝完成后，打開vs的dos窗口，依次執行下方幾個步驟。

生成VimService25.dll和VimService25.XmlSerializers.dll

1.生成cs文件。

wsdl.exe /n:Vim25Api /o:d:\sdk\dll\VimService.cs d:\sdk\dll\vimService.wsdl d:\sdk\dll\vim.wsdl

2.編譯cs文件。

csc /t:library /out:d:\sdk\dll\VimService25.dll d:\sdk\dll\VimService.cs

3.生成序列化文件。這一過程需要比較長的時間。

sgen /p d:\sdk\dll\VimService25.dll

4.打開原先cs文件，將[System.Xml.Serialization.XmlIncludeAttribute(typeof...開頭的文件注釋掉 => //[System.Xml.Serialization.XmlIncludeAttribute(typeof...再重新編譯cs文件。因為加上這些引用類，會導致每次示例化VimService非常慢，長達一分鐘以上導致超時。

我們查看PowerCLI自帶的VimService25.dll，反編譯可以看到VimService類的頭文件：

[GeneratedCode("wsdl", "2.0.50727.42"), DesignerCategory("code"), DebuggerStepThrough, WebServiceBinding(Name = "VimBinding", Namespace = "urn:vim25"), XmlSerializerAssembly(AssemblyName = "VimService25.XmlSerializers")]

我們通過wsdl編譯的頭文件：

[System.CodeDom.Compiler.GeneratedCodeAttribute("wsdl", "4.0.30319.1")]
[System.Diagnostics.DebuggerStepThroughAttribute()]
[System.ComponentModel.DesignerCategoryAttribute("code")]
[System.Web.Services.WebServiceBindingAttribute(Name="VimBinding", Namespace="urn:vim25")]
[System.Xml.Serialization.XmlIncludeAttribute(typeof(ReadEnvironmentVariableInGuestRequestType))]
[System.Xml.Serialization.XmlIncludeAttribute(typeof(TerminateProcessInGuestRequestType))]
......

于是我們注釋掉[System.Xml.Serialization.XmlIncludeAttribute(typeof...，再加上[System.Xml.Serialization.XmlSerializerAssembly(AssemblyName = "VimService25.XmlSerializers")]。

生成STSService.dll

1.cd到wse工具。

cd C:\Program Files (x86)\Microsoft WSE\v3.0\Tools

2.生成cs文件。此處在末尾加上所有wsdl文件。

WseWsdl3.exe /o:c:\STSService.cs /type:webClient c:\test\STSService.wsdl c:\test\profiled-saml-schema-assertion-2.0.xsd c:\test\profiled-saml-schema-assertion-2.0-extensions.xsd c:\test\profiled-saml-schema-assertion-2.0-types.xsd c:\test\profiled-sstc-saml-delegation.xsd c:\test\profiled-wsse-header.xsd c:\test\profiled-wss-wssecurity-utility-1.0.xsd c:\test\profiled-ws-trust.xsd c:\test\ws-addr.xsd c:\test\ws-trust-1.4-extensions.xsd c:\test\xmldsig-core-schema.xsd

3.編譯cs文件。此處需要引用Microsoft.Web.Services3.dll。

csc /t:library /out:c:\STSService.dll c:\STSService.cs /reference:"C:\Program Files (x86)\Microsoft WSE\v3.0\Microsoft.Web.Services3.dll"

在編譯STSService.dll的過程中可能會出現下圖警告。這代表需要安裝.net framework v2.0 sdk這么個東西，注意并非.net framework 2.0。

安裝完成重新引用生產的dll文件，這時候有點要注意，sample里面的項目采用.net framework 3.5，這取決于你編譯dll的版本，可以更改項目版本或者采用對應的編譯環境即可。

另外在sample中有兩種客戶端登錄方式。一種被稱為過時的，實際上VMA代理實例，另一種就是SSO。

不過SSO在sample的wsdl提供的api中卻沒有提供sso的接口。缺少部分類方法。所以注釋掉sso的驗證代碼。