Powershell小技巧之使用WS-Man來調(diào)用PowerShell命令

雖然PowerShell遠程管理被構(gòu)建在 WS-Management的之上，但它是協(xié)議中的協(xié)議。如果嘗試使用 PSRP （PowerShell遠程處理協(xié)議）直接進行交互，本質(zhì)上需要在客戶端機器上運行一個PowerShell副本。另一種方法是使用一個鮮為人知的遠程命令行工具，稱為WinRS。WinRS是一個簡單的工具，允許遠程CMD.EXE，它也是構(gòu)建在WS-Management之上的。所不同的是WinRS重用了 WS-Transfer中的Create和Delete，并引入了一些新的自定義的SOAP web-methods。本文中，我將重點放在WinRS“協(xié)議”，不會討論 WS-Transfer，SOAP，HTTP等細節(jié)。關(guān)于WinRS，WS-Management的一些詳細文檔可以參考：[MS-WSMV]: Web Services Management Protocol Extensions for Windows Vista。

WinRS具有相對簡單的協(xié)議，工作流程為：

WS-Transfer創(chuàng)建一個Shell，一個EPR（端點引用）。創(chuàng)建的Shell會被返回，用于接下來的一系列操作。
調(diào)用命令的自定義SOAP動作，開始一個新的命令
調(diào)用自定義的SOAP接受動作，來接收命令輸出（發(fā)送輸入時有相應的Send命令，但不是該場景必須的）
重復步驟3，直到CommandState完成
WS-Transfer來刪除shell上的端點引用。
讓我們較為詳細地瀏覽每個步驟吧:
對于WS-Transfer Create SOAP消息，body中應當包含你要發(fā)送或者接受的流，資源的URI應當為：http://schemas.microsoft.com/wbem/wsman/1/windows/shell/cmd.
所以本質(zhì)上我們創(chuàng)建了一個cmd.exe shell用來運行PowerShell。

如果請求成功，你會接受到一個標準的WS-Transfer Create SOAP響應，它包含了一個剛才創(chuàng)建的類似的Shell EPR：

這個EPR應該緩存的所有后續(xù)操作。第一個自定義SOAP動作命令使用動作URI：http://schemas.microsoft.com/wbem/wsman/1/windows/shell/Command。 WinRS支持兩種控制臺模式：交互式和批處理。對于一個交互式會話，WinRS將等待輸入（即使命令已經(jīng)完成），直到客戶端指示沒有更多。對于一個批處理會話，WinRS期望只在運行命令的生命周期有輸入被發(fā)送。對于此場景，指定的WS-Management選項WINRS_CONSOLEMODE_STDIN為true來意味正在使用批處理模式非常重要。命令行被分成單獨的命令和參數(shù)。SOAP片段像這樣：

如果這個請求是成功的，該響應將包含一個 CommandId元素，應當會被緩存在Body中，用于后續(xù)操作來接收輸出。雖然該協(xié)議被定義為允許一個Shell來托管多個命令，但是WinRS被限制了每個Shell只能處理單個命令。類似的響應例子如下：

一旦接收到命令的響應，該命令在服務器上運行。 一旦數(shù)據(jù)量達到了最大值，WinRS將阻止輸出（當然也包括命令）。自定義SOAP動作，接收使用操作URI。自定義SOAP使用動作uri：。因為所產(chǎn)生的輸出可能會超過SOAP請求大小，客戶端需要指定一個遞增SequenceId防止數(shù)據(jù)包丟失。 WinRS只會緩存最后發(fā)送的數(shù)據(jù)包。請求應當包含你想讀取的數(shù)據(jù)流，CommandId也會關(guān)聯(lián)Body中的數(shù)據(jù)流。

響應將包含base64流編碼的文本輸出（保持SOAP XML格式良好和有效）?？蛻舳藨獧z查命令的狀態(tài)，以了解是否繼續(xù)以調(diào)用接收更多的輸出。

一旦CommandState為“Done”，會沒有更多的輸出，并且WS-Transfer Delete 會在Shelll EPR上被調(diào)用。這將會清理服務器上正在使用的資源。

該示例代碼展示如何調(diào)用一個PowerShell 命令。它不使用任何WinRM的API，而是從模板創(chuàng)建必要的SOAP消息，并使用System.Net.HttpWebRequest將其通過網(wǎng)絡發(fā)送。為了使用Windows中的示例代碼，您需要啟用WinRM服務配置基本身份驗證（只適用于本地賬號），您可以以管理員權(quán)限運行此PowerShell命令：

如果你想讓輸出更加規(guī)范一點可以轉(zhuǎn)換為為XML（(.Net serialization）：

注意上面的例子中，你必須把管道字符轉(zhuǎn)義，這樣cmd.exe就不會去解釋它了。