Write-Information
Hiermee geeft u op hoe Windows PowerShell omgaat met gegevensstromen voor een opdracht.
Syntax
Default (Standaard)
Write-Information
[-MessageData] <Object>
[[-Tags] <String[]>]
[<CommonParameters>]
Description
De Write-Information cmdlet geeft aan hoe Windows PowerShell omgaat met gegevens uit de informatiestroom voor een opdracht.
Windows PowerShell 5.0 introduceert een nieuwe, gestructureerde gegevensstroom (nummer 6 in Windows PowerShell-gegevensstromen) die u kunt gebruiken om gestructureerde gegevens te verzenden tussen een script en de aanroepers (of hostingomgeving).
Write-Information kunt u een informatief bericht aan de gegevensstroom toevoegen en opgeven hoe Windows PowerShell omgaat met gegevens van de informatiestroom voor een opdracht. Informatiestromen werken ook voor PowerShell.Streams, taken, geplande taken en werkstromen.
Opmerking
De informatiestroom volgt niet de standaardconventie waarbij berichten worden voorafgegaan door '[Stream Name]:'. Dit was bedoeld voor beknoptheid en visuele netheid.
De waarde van de $InformationPreference voorkeursvariabele bepaalt of het bericht dat u opgeeft voor Write-Information wordt weergegeven op het verwachte punt in de bewerking van een script.
Omdat de standaardwaarde van deze variabele is SilentlyContinue, worden informatieve berichten standaard niet weergegeven.
Als u de waarde van $InformationPreferenceniet wilt wijzigen, kunt u de waarde overschrijven door de InformationAction gemeenschappelijke parameter aan uw opdracht toe te voegen.
Zie about_Preference_Variables en about_CommonParametersvoor meer informatie.
Opmerking
Vanaf Windows PowerShell 5.0 is Write-Host een wrapper voor Write-Information Hiermee kunt u Write-Host gebruiken om uitvoer naar de informatiestroom te verzenden.
Hierdoor kan de of onderdrukking gegevens vastleggen die zijn geschreven met behulp van Write-Host, terwijl achterwaartse compatibiliteit behouden blijft.
voor meer informatie zie Write-Host
Write-Information is ook een ondersteunde werkstroomactiviteit.
Voorbeelden
Voorbeeld 1: Schrijf informatie voor Get-resultaten
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 ziet u een informatief bericht, 'Got your features!', nadat u de Get-WindowsFeature opdracht hebt uitgevoerd om alle functies te vinden met een naamwaarde die begint met 'p'.
Omdat de $InformationPreference variabele nog steeds is ingesteld op de standaardinstelling, 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 getoond, maar dat het script of de opdracht doorgaat als het nog niet klaar is.
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 u Write-Information 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 de tag Instructies, wordt het hier opgegeven bericht een van de resultaten.
Voorbeeld 3: Gegevens naar een bestand schrijven
function Test-Info
{
Get-Process P*
Write-Information "Here you go"
}
Test-Info 6> Info.txt
In 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 'Alsjeblieft'.
Parameters
-MessageData
Hiermee geeft u een informatief bericht op dat u wilt weergeven voor gebruikers wanneer ze een script of opdracht uitvoeren. Plaats het informatieve bericht tussen aanhalingstekens voor de beste resultaten. Een voorbeeld is 'Test voltooid'.
Parametereigenschappen
| Type: | Object |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Msg |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Tags
Hiermee geeft u een eenvoudige tekenreeks op die u kunt gebruiken om berichten te sorteren en te filteren die u met Write-Informationaan de informatiestroom hebt toegevoegd.
Deze parameter werkt op dezelfde manier als de parameter Tags in New-ModuleManifest.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 1 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
None
Write-Information Accepteert geen overgesluisde invoer.