Updating Assert keyword (support for pipelining) (#143)

Author: StartAutomating

docs/Assert.md

@@ -59,6 +59,22 @@ Invoke-PipeScript {
 } -Verbose
 ```
 
+#### EXAMPLE 5
+```PowerShell
+# assert can be used with the object pipeline.  $_ will be the current object.
+Invoke-PipeScript {
+    1..4 | assert {$_ % 2} "$_ is not odd!"
+} -Debug
+```
+
+#### EXAMPLE 6
+```PowerShell
+# You can provide a ```[ScriptBlock]``` as the second argument to see each failure
+Invoke-PipeScript {
+    1..4 | assert {$_ % 2} { Write-Error "$_ is not odd!" }
+} -Debug
+```
+
 ---
 ### Parameters
 #### **CommandAst**