Megosztás a következőn keresztül:

Write-Information

Modul:
Microsoft.PowerShell.Utility Module

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

Write-Information a Windows PowerShell 5.1-ben is támogatott munkafolyamat-tevékenység.

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: 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.

$psproc = Get-Process -Id $PID | Select-Object ProcessName, CPU, Path
Write-Information -MessageData $psproc -Tags 'PowerShell' -InformationVariable 'InfoMsg'
$InfoMsg | Select-Object *

MessageData     : @{ProcessName=powershell; CPU=1.609375;
                  Path=C:\WINDOWS\System32\WindowsPowerShell\v1.0\powershell.exe}
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

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

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

None

Ez a parancsmag nem ad vissza kimenetet. Csak az információs üzenetfolyamba ír.