Write-Information
Megadja, hogy a Windows PowerShell hogyan kezeli a parancsok adatfolyamadatait.
Syntax
Default (Alapértelmezett)
Write-Information
[-MessageData] <Object>
[[-Tags] <String[]>]
[<CommonParameters>]
Description
A Write-Information parancsmag azt határozza meg, hogy a Windows PowerShell hogyan kezeli a parancsok adatfolyamadatait.
A Windows PowerShell 5.0 egy új, strukturált információs adatfolyamot vezet be (a Windows PowerShell-streamek 6-os száma), amellyel strukturált adatokat továbbíthat a szkriptek és a hívók (vagy az üzemeltetési környezet) között.
Write-Information lehetővé teszi, hogy információs üzenetet adjon hozzá a streamhez, és megadhatja, hogy a Windows PowerShell hogyan kezeli az adatfolyam adatait egy parancshoz. Az információs adatfolyamok PowerShell.Streams, feladatokhoz, ütemezett feladatokhoz és munkafolyamatokhoz is működnek.
Megjegyzés:
Az információs adatfolyam nem követi az üzenetek "[Stream name]:" előtaggal való előtagolásának szokásos konvencióját. Ez a rövidség és a vizuális tisztaság érdekében készült.
A $InformationPreference beállításváltozó értéke határozza meg, hogy a Write-Information megadott üzenet a szkript műveletének várt pontján jelenik-e meg.
Mivel ennek a változónak az alapértelmezett értéke SilentlyContinue, alapértelmezés szerint a tájékoztató üzenetek nem jelennek meg.
Ha nem szeretné módosítani a $InformationPreferenceértékét, felülbírálhatja annak értékét úgy, hogy hozzáadja a InformationAction gyakori paramétert a parancshoz.
További információért lásd a about_Preference_Variables és a about_CommonParameterscímű részt.
Megjegyzés:
A Windows PowerShell 5.0-tól kezdve a Write-Host egy burkoló elem a Write-Information. Ez lehetővé teszi, hogy a Write-Host segítségével kimenetet bocsásson ki az információs adatfolyamba.
Ez lehetővé teszi, hogy a rögzítse vagy , miközben megőrzi a visszamenőleges kompatibilitást.
további információ: Write-Host
Write-Information szintén támogatott munkafolyamat-tevékenység.
Példák
1. példa: Információk írása a Get- eredményekhez
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!
Ebben a példában egy tájékoztató üzenetet jelenít meg, amely a "Got your features!" (Saját funkciókkal rendelkezik) üzenet jelenik meg, miután futtatta a Get-WindowsFeature parancsot, hogy megkeresse az összes olyan funkciót, amelynek névértéke "p" betűvel kezdődik.
Mivel a $InformationPreference változó továbbra is az alapértelmezett értékre van állítva, SilentlyContinue, a InformationAction paramétert hozzáadva felülbírálhatja a $InformationPreference értéket, és megjelenítheti az üzenetet.
A InformationAction érték a Folytatás, ami azt jelenti, hogy megjelenik az üzenet, de a szkript vagy a parancs folytatódik, ha még nem fejeződött be.
2. példa: Adatok írása és címkézése
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.
Ebben a példában a Write-Information használatával tudathatja a felhasználókat, hogy az aktuális parancs futtatása után egy másik parancsot kell futtatniuk.
A példa hozzáadja a címkeutasításokat az információs üzenethez.
A parancs futtatása után, ha az információs adatfolyamban az Utasítások címkével ellátott üzenetek között keres, az itt megadott üzenet szerepel az eredmények között.
3. példa: Adatok írása fájlba
function Test-Info
{
Get-Process P*
Write-Information "Here you go"
}
Test-Info 6> Info.txt
Ebben a példában a függvényben lévő információfolyamot egy fájlba irányítja át, Info.txta 6>kóddal. Amikor megnyitja a Info.txt fájlt, a következő szöveg jelenik meg: "Itt van.
Paraméterek
-MessageData
Olyan tájékoztató üzenetet ad meg, amelyet a felhasználók egy szkript vagy parancs futtatásakor szeretnének megjeleníteni. A legjobb eredmény érdekében az információs üzenetet idézőjelek közé kell foglalnia. Ilyen például a "Teszt befejezve".
Paramétertulajdonságok
| Típus: | Object |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Msg |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Tags
Egy egyszerű karaktersorozatot ad meg, amellyel rendezheti és szűrheti az adatfolyamhoz Write-Informationcímkével hozzáadott üzeneteket.
Ez a paraméter a New-ModuleManifest paraméteréhez hasonlóan működik.
Paramétertulajdonságok
| Típus: | String[] |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
Paraméterkészletek
(All)
| Position: | 1 |
| Kötelező: | False |
| Folyamatból származó érték: | False |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
CommonParameters
Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.
Bevitelek
None
Write-Information nem fogadja el a vezetékes bemenetet.