Write-Information
Hiermee geeft u op hoe Windows PowerShell gegevensstroomgegevens voor een opdracht verwerkt.
Syntax
Write-Information
[-MessageData] <Object>
[[-Tags] <String[]>]
[<CommonParameters>]Description
De Write-Information cmdlet geeft aan hoe Windows PowerShell gegevensstroomgegevens voor een opdracht verwerkt.
Windows PowerShell 5.0 introduceert een nieuwe, gestructureerde informatiestroom (nummer 6 in Windows PowerShell streams) die u kunt gebruiken om gestructureerde gegevens te verzenden tussen een script en de aanroepers (of hostingomgeving).
Write-Informationhiermee kunt u een informatief bericht toevoegen aan de stream en opgeven hoe Windows PowerShell gegevens van een gegevensstroom verwerkt voor een opdracht. Informatiestromen werken ook voor PowerShell.Streams, taken, geplande taken en werkstromen.
Notitie
De informatiestroom volgt niet de standaardconventie van het voorvoegsel "[Stream Name]:". Dit was bedoeld voor de beknoptheid en visuele netheid.
De $InformationPreference waarde van de voorkeursvariabele bepaalt of het bericht dat u opgeeft Write-Information , wordt weergegeven op het verwachte punt in de bewerking van een script.
Omdat de standaardwaarde van deze variabele is, worden SilentlyContinueinformatieve berichten standaard niet weergegeven.
Als u de waarde van $InformationPreferenceniet wilt wijzigen, kunt u de waarde ervan overschrijven door de InformationAction algemene parameter toe te voegen aan uw opdracht.
Zie about_Preference_Variables en about_CommonParameters voor meer informatie.
Notitie
Vanaf Windows PowerShell 5.0 Write-Host is een wrapper voor Write-Information Hiermee kunt u uitvoer Write-Host verzenden naar de informatiestroom.
Dit maakt het mogelijk om gegevens die zijn geschreven met behulp Write-Host van vast te leggen of te onderdrukken, met behoud van compatibiliteit met eerdere versies.
Zie Write-Host voor meer informatie
Write-Information is ook een ondersteunde werkstroomactiviteit.
Voorbeelden
Voorbeeld 1: informatie schrijven voor Get- results
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!In dit voorbeeld geeft u een informatief bericht weer, 'Hebt uw functies!', nadat u de Get-WindowsFeature opdracht hebt uitgevoerd om alle functies te vinden die een Naam-waarde hebben die begint met 'p'.
Omdat de $InformationPreference variabele nog steeds is ingesteld op de standaardwaarde, , SilentlyContinuevoegt u de InformationAction parameter toe om de $InformationPreference waarde te overschrijven en geeft u het bericht weer.
De InformationAction waarde is Doorgaan, wat betekent dat uw bericht wordt weergegeven, maar dat het script of de opdracht wordt voortgezet als het nog niet is voltooid.
Voorbeeld 2: Informatie schrijven en taggen
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.In dit voorbeeld gebruikt Write-Information u om gebruikers te laten weten dat ze een andere opdracht moeten uitvoeren nadat ze klaar zijn met het uitvoeren van de huidige opdracht.
In het voorbeeld wordt de tag Instructies toegevoegd aan het informatieve bericht.
Als u na het uitvoeren van deze opdracht in de informatiestroom zoekt naar berichten met het label Instructies, wordt het hier opgegeven bericht opgenomen in de resultaten.
Voorbeeld 3: gegevens naar een bestand schrijven
function Test-Info
{
Get-Process P*
Write-Information "Here you go"
}
Test-Info 6> Info.txtIn dit voorbeeld leidt u de informatiestroom in de functie om naar een bestand, Info.txt, met behulp van de code 6>. Wanneer u het Info.txt-bestand opent, ziet u de tekst 'Hier gaat u heen'.
Parameters
-MessageData
Hiermee geeft u een informatief bericht dat u wilt weergeven aan gebruikers wanneer ze een script of opdracht uitvoeren. Voor de beste resultaten plaatst u het informatieve bericht tussen aanhalingstekens. Een voorbeeld is 'Test voltooid'.
| Type: | Object |
| Aliases: | Msg |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tags
Hiermee geeft u een eenvoudige tekenreeks op die u kunt gebruiken om berichten te sorteren en te filteren die u hebt toegevoegd aan de informatiestroom met Write-Information.
Deze parameter werkt op dezelfde manier als de parameter Tags in New-ModuleManifest.
| Type: | String[] |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Invoerwaarden
None
Write-Information accepteert geen doorgesluisde invoer.