Write-Information
指定 Windows PowerShell 如何處理命令的資訊資料流資料。
Syntax
Write-Information
[-MessageData] <Object>
[[-Tags] <String[]>]
[<CommonParameters>]Description
Cmdlet Write-Information 會指定 Windows PowerShell 如何處理命令的資訊數據流數據。
Windows PowerShell 5.0 引進新的結構化資訊資料流 (Windows PowerShell 資料流中的數字 6)，供您在指令碼與呼叫端 (或主機環境) 之間傳送結構化資料。
Write-Information可讓您將參考訊息新增至數據流，並指定 Windows PowerShell 如何處理命令的信息數據流數據。 信息數據流也適用於 PowerShell.Streams、作業、排程的工作和工作流程。
注意
信息數據流不會遵循其訊息前面加上 “[Stream Name]：” 的標準慣例。 這是為了簡潔且視覺的氣氣。
$InformationPreference喜好設定變數值會決定您提供給 Write-Information 的訊息是否顯示在腳本作業的預期點。
由於此變數的預設值為 SilentlyContinue，因此預設不會顯示參考訊息。
如果您不想變更 的值 $InformationPreference，您可以將通用參數新增 InformationAction 至命令，以覆寫其值。
如需詳細資訊，請參閱 about_Preference_Variables 和 about_CommonParameters。
注意
從 Windows PowerShell 5.0 開始，這是一Write-Information種包裝函式，Write-Host可讓您用來Write-Host發出資訊數據流的輸出。
這可擷 取 或 隱藏 使用 Write-Host 寫入的數據，同時保留回溯相容性。
如需詳細資訊，請參閱 Write-Host
Write-Information 也是支援的工作流程活動。
範例
範例 1：寫入 Get- 結果的資訊
Get-WindowsFeature -Name p*; Write-Information -MessageData "Got your features!" -InformationAction Continue
Display Name Name Install State
------------ ---- -------------
[ ] Print and Document Services Print-Services Available
[ ] Print Server Print-Server Available
[ ] Distributed Scan Server Print-Scan-Server Available
[ ] Internet Printing Print-Internet Available
[ ] LPD Service Print-LPD-Service Available
[ ] Peer Name Resolution Protocol PNRP Available
[X] Windows PowerShell PowerShellRoot Installed
[X] Windows PowerShell 5.0 PowerShell Installed
[ ] Windows PowerShell 2.0 Engine PowerShell-V2 Removed
[X] Windows PowerShell ISE PowerShell-ISE Installed
Got your features!在此範例中，您會在執行 Get-WindowsFeature 命令之後顯示資訊訊息「取得您的功能！」，以尋找名稱值開頭為 『p』 的所有功能。
$InformationPreference因為變數仍然設定為預設值，SilentlyContinue所以您會新增 InformationAction 參數來覆寫$InformationPreference值，並顯示訊息。
此值 InformationAction 為 Continue，這表示您的訊息已顯示，但如果尚未完成，腳本或命令就會繼續。
範例 2︰寫入資訊並加以標記
Get-WindowsFeature -Name p*; Write-Information -MessageData "To filter your results for PowerShell, pipe your results to the Where-Object cmdlet." -Tags "Instructions" -InformationAction Continue
Display Name Name Install State
------------ ---- -------------
[ ] Print and Document Services Print-Services Available
[ ] Print Server Print-Server Available
[ ] Distributed Scan Server Print-Scan-Server Available
[ ] Internet Printing Print-Internet Available
[ ] LPD Service Print-LPD-Service Available
[ ] Peer Name Resolution Protocol PNRP Available
[X] Windows PowerShell PowerShellRoot Installed
[X] Windows PowerShell 5.0 PowerShell Installed
[ ] Windows PowerShell 2.0 Engine PowerShell-V2 Removed
[X] Windows PowerShell ISE PowerShell-ISE Installed
To filter your results for PowerShell, pipe your results to the Where-Object cmdlet.在此範例中，您會使用 Write-Information 來讓使用者知道使用者在執行目前命令之後必須執行另一個命令。
此範例會在告知性訊息中新增 Instructions 標記。
執行此命令之後，如果您要針對已標記 Instructions 的訊息搜尋資訊資料流，則此處指定的訊息會位於結果之中。
範例 3︰將資訊寫入檔案
function Test-Info
{
Get-Process P*
Write-Information "Here you go"
}
Test-Info 6> Info.txt在此範例中，您可以使用代碼 6>，將函式中的資訊資料流重新導向至 Info.txt 檔案。 當您開啟 Info.txt 檔案時，您會看到「Here you go」的字樣。
參數
-MessageData
指定您想要在使用者執行指令碼或命令時顯示的告知性訊息。 為了獲得最佳結果，請以引號括住告知性訊息。 例如，"Test complete"。
| Type: | Object |
| Aliases: | Msg |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tags
指定簡單的字串，您可以使用 來排序和篩選已新增至資訊數據流 Write-Information的訊息。
此參數的運作方式類似於 中的 New-ModuleManifestTags 參數。
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
None
Write-Information 不接受管線輸入。