使用 PowerShell 呼叫 WCF

征服使用 WebClient 呼叫 WCF後的下個目標，自然是學會用 PowerShell 呼叫 WCF，繼續精進野外求生技能。

歷經這段時間的 PowerShell 實戰練習，我得到重要心得：.NET 開發者想用 PowerShell 處理未知情境有捷徑 - 先寫出 C# 程式達成目標再將程式邏輯轉成 PowerShell。大多數 C# 語法在 PowerShell 都有對映寫法(例如 Lambda)，且 PowerShell 可直接建立及操作 .NET 物件，要載入第三方程式庫也不是問題，但有些眉角要實際動手才會知道，例如這次改寫我就學到一些新東西。

第一個是 Here-String，相當 C# 的 String Liberal(逐字字串常值)，就是能包含換行的 @"..." 字串表示法。Here-String 的格式為：

$x = @"<Enter換行>
內容文字可以有多行
不需要避開 " 或 '
內嵌 HTML 或 XML 很方便
<rows>
    <row attr="123"></row>
</rows>
結尾處換行再接雙引號跟 @<Enter換行>
"@

第二點是「PowerShell 不能直接使用 LINQ 方法」。LINQ 基於 IEnumerable<T> 泛型，依賴編譯期強型別概念。因此 "A,B,C".Split(',').First() 在 C# 可行，在 PowerShell 則會以不認得 .First() 收場。不過不打緊，PowerShell 裡有 ForEach-Object、Where-Object、Select-Object 可以實現與 LINQ 相似的操作。

經過一番琢磨，我把前一篇的 C# 程式轉成 PowerShell 版：

Add-Type -AssemblyName System.Xml.Linq
Add-Type -AssemblyName System.Linq
$ErrorActionPreference = "Stop"
$xml = @"
 <s:Envelope xmlns:s="http://www.w3.org/2003/05/soap-envelope"
xmlns:a="http://www.w3.org/2005/08/addressing">
<s:Header>
<a:Action s:mustUnderstand="1">http://tempuri.org/IHelloWorldService/QueryProductsByCatetory</a:Action>
<a:MessageID>urn:uuid:47f2ab1a-be57-4ea6-a0d4-8477bd33f259</a:MessageID>
<a:ReplyTo>
	<a:Address>http://www.w3.org/2005/08/addressing/anonymous</a:Address>
</a:ReplyTo>
<a:To s:mustUnderstand="1">http://192.168.50.7/HelloWorld/HelloWorldService.svc</a:To>
</s:Header>
<s:Body>
<QueryProductsByCatetory xmlns="http://tempuri.org/">
	<catg>Keyboard</catg>
</QueryProductsByCatetory>
</s:Body>
</s:Envelope>
"@
$xdReq = [System.Xml.Linq.XDocument]::Parse($xml)
$ns = [ System.Xml.Linq.XNamespace] "http://tempuri.org/"
$ns_a  = [System.Xml.Linq.XNamespace] "http://www.w3.org/2005/08/addressing"
$url = "http://192.168.50.7/HelloWorld/HelloWorldService.svc"
($xdReq.Descendants($ns_a + "To") | Select-Object -First 1).Value = $url
($xdReq.Descendants($ns + "QueryProductsByCatetory") | Select-Object -First 1).Element($ns + "catg").Value = "Mouse";
$res = (Invoke-WebRequest -Method POST -Uri $url -ContentType "application/soap+xml; charset=utf-8" -Body $xdReq.ToString()).Content
$xdResp = [System.Xml.Linq.XDocument]::Parse($res)
$ns_b = [System.Xml.Linq.XNamespace]"http://schemas.datacontract.org/2004/07/MyWCFServices"
($xdResp.Descendants($ns + "QueryProductsByCatetoryResult") | Select-Object -First 1).Elements() |
ForEach-Object {
	$p = $_
	"ModelId,Category,Name,Price,StockQty".Split(',') | 
	ForEach-Object {
		Write-Host "$($_) $($p.Element($ns_b + $_).Value)"
	}
	Write-Host "===="
}

本次還有意外收獲是發現用 VSCode 寫 PowerShell 很讚，有語法檢查、IntelliSence，下方視窗可直接測試，非常方便。

Example of calling WCF method with PowerShell Invoke-WebRequest.