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

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

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

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

如果請(qǐng)求成功，你會(huì)接受到一個(gè)標(biāo)準(zhǔn)的WS-Transfer Create SOAP響應(yīng)，它包含了一個(gè)剛才創(chuàng)建的類似的Shell EPR：

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

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

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

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

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

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

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

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