Write-Information
Určuje, jak Windows PowerShell zpracovává data informačního streamu pro příkaz.
Syntax
Write-Information
[-MessageData] <Object>
[[-Tags] <String[]>]
[<CommonParameters>]Description
Rutina Write-Information určuje, jak Windows PowerShell zpracovává data informačního streamu pro příkaz.
Windows PowerShell 5.0 zavádí nový strukturovaný datový proud informací (číslo 6 v Windows PowerShell datových proudech), který můžete použít k přenosu strukturovaných dat mezi skriptem a jeho volajícími (nebo hostitelským prostředím).
Write-Informationumožňuje přidat do datového proudu informační zprávu a určit, jak Windows PowerShell zpracovává data datového proudu informací pro příkaz. Informační proudy fungují také pro PowerShell.Streamsúlohy, naplánované úlohy a pracovní postupy.
Poznámka
Informační proud nedodržuje standardní konvenci vytváření předpony pro zprávy s "[Stream Name]:". To bylo určeno pro stručnost a vizuální čistotu.
$InformationPreference Hodnota proměnné předvolby určuje, jestli se zpráva, kterou zadáte, Write-Information zobrazí v očekávaném bodě operace skriptu.
Vzhledem k tomu, že výchozí hodnota této proměnné je SilentlyContinue, ve výchozím nastavení se informační zprávy nezobrazují.
Pokud nechcete změnit hodnotu parametru $InformationPreference, můžete její hodnotu přepsat přidáním InformationAction společného parametru do příkazu.
Další informace najdete v tématu about_Preference_Variables a about_CommonParameters.
Poznámka
Počínaje Windows PowerShell 5.0Write-Host, je obálka pro Write-Information To umožňuje použít Write-Host ke generování výstupu do informačního streamu.
To umožňuje zachytávání nebo potlačení dat zapisovaných pomocí Write-Host při zachování zpětné kompatibility.
Další informace najdete v tématu Write-Host.
Write-Information je také podporovaná aktivita pracovního postupu.
Příklady
Příklad 1: Zápis informací pro získání výsledků
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!V tomto příkladu po spuštění Get-WindowsFeature příkazu zobrazíte informační zprávu "Máte funkce!" a vyhledáte všechny funkce, které mají hodnotu Název začínající na "p".
$InformationPreference Vzhledem k tomu, že proměnná je stále nastavená na výchozí hodnotu , SilentlyContinuepřidáte InformationAction parametr pro přepsání $InformationPreference hodnoty a zobrazíte zprávu.
Hodnota InformationAction je Pokračovat, což znamená, že zpráva se zobrazí, ale skript nebo příkaz bude pokračovat, pokud ještě nejsou dokončené.
Příklad 2: Zápis informací a jejich označení
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.V tomto příkladu pomocí Write-Information příkazu dáte uživatelům vědět, že po dokončení spuštění aktuálního příkazu budou muset spustit další příkaz.
Příklad přidá značku Instructions do informační zprávy.
Pokud po spuštění tohoto příkazu vyhledáte v informačním proudu zprávy označené pokyny, bude zpráva zadaná tady mezi výsledky.
Příklad 3: Zápis informací do souboru
function Test-Info
{
Get-Process P*
Write-Information "Here you go"
}
Test-Info 6> Info.txtV tomto příkladu přesměrujete informační stream ve funkci do souboru Info.txt pomocí kódu 6>. Když otevřete soubor Info.txt, zobrazí se text "Tady je".
Parametry
-MessageData
Určuje informační zprávu, kterou chcete zobrazit uživatelům při spuštění skriptu nebo příkazu. Nejlepších výsledků dosáhnete, když informační zprávu uzavřete do uvozovek. Příkladem je "Test dokončen".
| Type: | Object |
| Aliases: | Msg |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tags
Určuje jednoduchý řetězec, který můžete použít k řazení a filtrování zpráv, které jste přidali do informačního streamu pomocí Write-Information.
Tento parametr funguje podobně jako parametr Tags v New-ModuleManifestnástroji .
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Vstupy
None
Write-Information nepřijímá vstup s kanálem.