Write-Information
Meghatározza, hogy a 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 PowerShell hogyan kezeli a parancsok adatfolyamadatait.
A Windows PowerShell 5.0 új, strukturált adatfolyamot vezet be. Ezzel a streamel strukturált adatokat továbbíthat egy szkript és a hívók vagy a gazdaalkalmazás között.
Write-Information lehetővé teszi, hogy információs üzenetet adjon hozzá a streamhez, és megadhatja, hogy a PowerShell hogyan kezeli az adatfolyam adatait egy parancshoz. Az információs adatfolyamok a PowerShell.Streams, a munkák és az ütemezett feladatok esetében 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 a Write-Host használatával írt adatok rögzítését vagy letiltását a visszamenőleges kompatibilitás megőrzése mellett. További információért lásd Write-Host
Példák
1. példa: Információk írása a Get- eredményekhez
Ebben a példában egy "P-vel kezdődő folyamatok" nevű tájékoztató üzenetet jelenít meg, mielőtt futtatja a Get-Process parancsot, hogy megkeresse az összes olyan folyamatot, amely Név értékkel rendelkezik, amely a következővel kezdődik: "p".
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éke Folytatás, ami azt jelenti, hogy az üzeneted megjelenik, de a szkript vagy parancs folytatódik, ha még nem fejeződött be.
Write-Information -MessageData "Processes starting with 'P'" -InformationAction Continue
Get-Process -Name p*
Processes starting with 'P'
18 19.76 15.16 0.00 6232 0 PFERemediation
20 8.92 25.15 0.00 24944 0 policyHost
9 1.77 7.64 0.00 1780 0 powercfg
10 26.67 32.18 0.00 7028 0 powercfg
8 26.55 31.59 0.00 13600 0 powercfg
9 1.66 7.55 0.00 22620 0 powercfg
21 6.17 4.54 202.20 12536 1 PowerMgr
42 84.26 12.71 2,488.84 20588 1 powershell
27 47.07 45.38 2.05 25988 1 powershell
27 24.45 5.31 0.00 12364 0 PresentationFontCache
92 112.04 13.36 82.30 13176 1 pwsh
106 163.73 93.21 302.25 14620 1 pwsh
227 764.01 92.16 1,757.22 25328 1 pwsh
2. példa: Adatok írása és címkézése
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 "Instructions" címkét az információs üzenethez. A parancs futtatása után, amikor a "Instructions"címkével ellátott üzeneteket keres az adatfolyamban, az üzenet megjelenik az eredmények között.
$message = "To filter your results for PowerShell, pipe your results to the Where-Object cmdlet."
Get-Process -Name p*
Write-Information -MessageData $message -Tags "Instructions" -InformationAction Continue
NPM(K) PM(M) WS(M) CPU(s) Id SI ProcessName
------ ----- ----- ------ -- -- -----------
18 19.76 15.16 0.00 6232 0 PFERemediation
20 8.92 25.15 0.00 24944 0 policyHost
9 1.77 7.64 0.00 1780 0 powercfg
10 26.67 32.18 0.00 7028 0 powercfg
8 26.55 31.59 0.00 13600 0 powercfg
9 1.66 7.55 0.00 22620 0 powercfg
21 6.17 4.54 202.20 12536 1 PowerMgr
42 84.26 12.71 2,488.84 20588 1 powershell
27 47.07 45.38 2.05 25988 1 powershell
27 24.45 5.31 0.00 12364 0 PresentationFontCache
92 112.04 13.36 82.30 13176 1 pwsh
106 163.73 93.21 302.25 14620 1 pwsh
227 764.01 92.16 1,757.22 25328 1 pwsh
To filter your results for PowerShell, pipe your results to the Where-Object cmdlet.
3. példa: Adatok írása fájlba
Ebben a példában a függvény információfolyamát a Info.txtkód használatával a 6>-ra irányítja át. A Info.txt fájl megnyitásakor megjelenik az "Itt van" szöveg.
function Test-Info
{
Get-Process P*
Write-Information "Here you go"
}
Test-Info 6> Info.txt
4. példa: Objektum átadása adatok kiírásához
Ebben a példában a Write-Information segítségével megírhatja a 10 legmagasabb processzorhasználati folyamatot a Get-Process objektum kimenetéből, amely több folyamaton halad át.
Get-Process | Sort-Object CPU -Descending |
Select-Object Id, ProcessName, CPU -First 10 |
Write-Information -InformationAction Continue
@{Id=12692; ProcessName=chrome; CPU=39431.296875}
@{Id=21292; ProcessName=OUTLOOK; CPU=23991.875}
@{Id=10548; ProcessName=CefSharp.BrowserSubprocess; CPU=20546.203125}
@{Id=312848; ProcessName=Taskmgr; CPU=13173.1875}
@{Id=10848; ProcessName=SnapClient; CPU=7014.265625}
@{Id=9760; ProcessName=Receiver; CPU=6792.359375}
@{Id=12040; ProcessName=Teams; CPU=5605.578125}
@{Id=498388; ProcessName=chrome; CPU=3062.453125}
@{Id=6900; ProcessName=chrome; CPU=2546.9375}
@{Id=9044; ProcessName=explorer; CPU=2358.765625}
5. példa: Adatrekordok mentése változóba
Az InformationVariable paraméterrel adatrekordokat menthet egy változóba. Ez lehetővé teszi az adatfolyam-üzenetek vizsgálatát a szkript későbbi részében.
Get-Process -Id $PID |
Select-Object ProcessName, CPU, Path |
Write-Information -Tags 'PowerShell' -InformationVariable 'InfoMsg'
$InfoMsg | Select-Object *
MessageData : @{ProcessName=pwsh; CPU=12.36; Path=/opt/microsoft/powershell/7/pwsh}
Source : Write-Information
TimeGenerated : 10/19/2023 11:28:15
Tags : {PowerShell}
User : sdwheeler
Computer : circumflex
ProcessId : 237
NativeThreadId : 261
ManagedThreadId : 10
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.
Paramétertulajdonságok
| Típus: | Object |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | Msg, Üzenet |
Paraméterkészletek
(All)
| Position: | 0 |
| Kötelező: | True |
| Folyamatból származó érték: | True |
| Folyamatból származó érték tulajdonságnév alapján: | False |
| Fennmaradó argumentumokból származó érték: | False |
-Tags
Egy vagy több karakterlánc, amellyel rendezheti és szűrheti az adatfolyamhoz a Write-Informationsegítségé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
Object
Az objektumokat az információs adatfolyamon keresztül továbbíthatja ehhez a cmdlethez.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet. Csak az információs üzenetfolyamba ír.
