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

更新時間：2014年10月24日 10:17:55 投稿：hebedich

大多Windows系統(tǒng)的管理員應(yīng)當(dāng)已經(jīng)意識到在Windows系統(tǒng)上進(jìn)行腳本開發(fā)和命令行管理，PowerShell首當(dāng)其沖。微軟許多產(chǎn)品和一些第三方產(chǎn)品都提供了Windows PowerShell的管理接口。但是目前PowerShell只能運(yùn)行在Windows系統(tǒng)上，如何才能在非Windows系統(tǒng)上管理windows系統(tǒng)呢

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

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

WS-Transfer創(chuàng)建一個Shell，一個EPR（端點(diǎn)引用）。創(chuàng)建的Shell會被返回，用于接下來的一系列操作。
調(diào)用命令的自定義SOAP動作，開始一個新的命令
調(diào)用自定義的SOAP接受動作，來接收命令輸出（發(fā)送輸入時有相應(yīng)的Send命令，但不是該場景必須的）
重復(fù)步驟3，直到CommandState完成
WS-Transfer來刪除shell上的端點(diǎn)引用。
讓我們較為詳細(xì)地瀏覽每個步驟吧:
對于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)建了一個cmd.exe shell用來運(yùn)行PowerShell。

復(fù)制代碼代碼如下:

<Shell xmlns='http://schemas.microsoft.com/wbem/wsman/1/windows/shell'>

  <InputStreams>stdin</InputStreams>

  <OutputStreams>stdout stderr</OutputStreams>

</Shell>

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

復(fù)制代碼代碼如下:

<w:SelectorSet>

  <w:Selector Name="ShellId">AFCFB065-F551-4604-BFDFD9B706798B5D</w:Selector>

</w:SelectorSet>

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

復(fù)制代碼代碼如下:

…

  <w:OptionSet>

    <w:Option Name='WINRS_CONSOLEMODE_STDIN'>TRUE</w:Option>

  </w:OptionSet>

</s:Header>

<s:Body>

<CommandLine xmlns='http://schemas.microsoft.com/wbem/wsman/1/windows/shell'>

  <Command>powershell</Command>

  <Arguments>get-service | format-csv </Arguments>

</CommandLine>

</s:Body>

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

復(fù)制代碼代碼如下:

<rsp:CommandResponse>

  <rsp:CommandId>772B44DF-2EA2-4AA5-87D1-A07E1FAE7A4E</rsp:CommandId>

</rsp:CommandResponse>

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

復(fù)制代碼代碼如下:

<Receive SequenceId='0'

   xmlns='http://schemas.microsoft.com/wbem/wsman/1/windows/shell'>

  <DesiredStream CommandId='772B44DF-2EA2-4AA5-87D1-A07E1FAE7A4E'>

    stdout stderr

  </DesiredStream>

</Receive>

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

復(fù)制代碼代碼如下:

<rsp:ReceiveResponse>
<rsp:Stream Name="stdout" CommandId="772B44DF-2EA2-4AA5-87D1-A07E1FAE7A4E">DQo=</rsp:Stream>
<rsp:Stream Name="stdout" CommandId="772B44DF-2EA2-4AA5-87D1-A07E1FAE7A4E">
    U3RhdHVzICAgTmFtZSAgICAgICAgICAgICAgIERpc3BsYXlOYW1lICAgICAgICAgICAgICAgICAgICAgICAgICAg</rsp:Stream>
<rsp:Stream Name="stdout" CommandId="772B44DF-2EA2-4AA5-87D1-A07E1FAE7A4E">
    DQotLS0tLS0gICAtLS0tICAgICAgICAgICAgICAgLS0tLS0tLS0tLS0gICAgICAgICAgICAgICAgICAgICAgICAgICANClJ1bm5pbmcgIH
dpbm1nbXQgICAgICAgICAgICBXaW5kb3dzIE1hbmFnZW1lbnQgSW5zdHJ1bWVudGF0aW9uICAgIA0KDQoNCg==</rsp:Stream>
<rsp:Stream Name="stdout" CommandId="772B44DF-2EA2-4AA5-87D1-A07E1FAE7A4E" End="true"></rsp:Stream>
<rsp:Stream Name="stderr" CommandId="772B44DF-2EA2-4AA5-87D1-A07E1FAE7A4E" End="true"></rsp:Stream>
<rsp:CommandState CommandId="772B44DF-2EA2-4AA5-87D1-A07E1FAE7A4E"
     State=" <rsp:ExitCode>0</rsp:ExitCode>
</rsp:CommandState>
</rsp:ReceiveResponse>

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

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

復(fù)制代碼代碼如下:

WinRSPsh http://server:5985/wsman user password "get-service"

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

復(fù)制代碼代碼如下:

WinRSPsh http://server:5985/wsman user password "(get-service ^| convertto-xml).OuterXml"

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

您可能感興趣的文章: