Write-Information
Meghatározza, hogy a PowerShell hogyan kezeli a parancsok adatfolyamadatait.
Syntax
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, hogyan kezeli a PowerShell az adatfolyam adatait egy parancshoz. Az információs adatfolyamok a feladatokhoz és az ütemezett tevékenységekhez PowerShell.Streams
is működnek.
Feljegyzé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 Write-Information
a 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 a SilentlyContinue, alapértelmezés szerint a tájékoztató üzenetek nem jelennek meg.
Ha nem szeretné módosítani az értékét $InformationPreference
, felülbírálhatja annak értékét úgy, hogy hozzáadja az InformationAction közös paramétert a parancshoz. További információ: about_Preference_Variables és about_CommonParameters.
Feljegyzés
A Windows PowerShell 5.0-tól Write-Host
kezdődően ez egy burkoló Write-Information
, amellyel Write-Host
kimenetet bocsáthat ki az adatfolyamba. Ez lehetővé teszi a visszafelé kompatibilitás megőrzése mellett írt Write-Host
adatok rögzítését vagy letiltását. További információ: Write-Host
Példák
1. példa: Információk írása a Get- eredményekhez
Ebben a példában a "P"-vel kezdődő folyamatok című tájékoztató üzenetet jeleníti meg, mielőtt futtatja a parancsot, hogy megkeresse az Get-Process
összes olyan folyamatot, amelynek névértéke "p" betűvel kezdődik.
Mivel a $InformationPreference
változó továbbra is az alapértelmezett (SilentlyContinue) értékre van állítva, az InformationAction paramétert hozzáadva felülbírálhatja az $InformationPreference
értéket, és megjelenítheti az üzenetet. Az InformationAction értéke Folytatás, ami azt jelenti, hogy megjelenik az üzenet, 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 tudatja Write-Information
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ímkét "Instructions"
az információs üzenethez. A parancs futtatása után, amikor a címkézett "Instructions"
üzenetekre keres az információs 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 átirányítja a függvényben lévő információfolyamot Info.txt
a kód 6>
használatára. A fájl megnyitásakor Info.txt
megjelenik az "Itt vagy" 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 írásához
Ebben a példában a 10 legnagyobb processzorkihasználtsági folyamat megírására használható Write-Information
a Get-Process
több folyamaton áthaladó objektumkimenetből.
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.
Type: | Object |
Aliases: | Msg, Message |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Tags
Egy vagy több sztring, amellyel rendezheti és szűrheti az információs adatfolyamhoz Write-Information
hozzáadott üzeneteket. Ez a paraméter a Címkék paraméterhez hasonlóan működik a következőbenNew-ModuleManifest
: .
Type: | String[] |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Bevitelek
Az objektumokat a parancsmagnak továbbíthatja az információs adatfolyamnak.
Kimenetek
None
Ez a parancsmag nem ad vissza kimenetet. Csak az információs üzenetfolyamba ír.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: