Merge 0c277d1 into 28633a7

src/Pode.psd1

@@ -102,6 +102,7 @@
         'Test-IsWindows',
         'Test-IsPSCore',
         'Test-IsEmpty',
+        'Write-PodeHost',
 
         # routes
         'Add-PodeRoute',

src/Public/Utilities.ps1

@@ -760,4 +760,29 @@ function Test-IsWindows
 
     $v = Get-PodePSVersionTable
     return ($v.Platform -ilike '*win*' -or ($null -eq $v.Platform -and $v.PSEdition -ieq 'desktop'))
+}
+
+<#
+.SYNOPSIS
+Writes a message to the main Host.
+
+.DESCRIPTION
+Due to Pode's use of runspaces, this will write a given message back to the main Host.
+
+.PARAMETER Message
+The Message to write.
+
+.EXAMPLE
+'Hello, world!' | Write-PodeHost
+#>
+function Write-PodeHost
+{
+    [CmdletBinding()]
+    param(
+        [Parameter(Mandatory=$true, ValueFromPipeline=$true)]
+        [string]
+        $Message
+    )
+
+    $Message | Out-Default
 }

tests/unit/Helpers.Tests.ps1

@@ -1379,4 +1379,18 @@ Describe 'Convert-PodePathSeparators' {
             Convert-PodePathSeparators -Path @(' ', '') | Should Be $null
         }
     }
+}
+
+Describe 'Write-PodeHost' {
+    Mock Out-Default {}
+
+    It 'Writes a message to the Host by parameters' {
+        Write-PodeHost -Message 'Hello'
+        Assert-MockCalled Out-Default -Scope It -Times 1
+    }
+
+    It 'Writes a message to the Host by pipeline' {
+        'Hello' | Write-PodeHost
+        Assert-MockCalled Out-Default -Scope It -Times 1
+    }
 }