Write-Information
Specifica il modo in cui Windows PowerShell gestisce i dati del flusso di informazioni per un comando.
Sintassi
Default (Impostazione predefinita)
Write-Information
[-MessageData] <Object>
[[-Tags] <String[]>]
[<CommonParameters>]
Descrizione
Il Write-Information cmdlet specifica il modo in cui Windows PowerShell gestisce i dati del flusso di informazioni per un comando.
In Windows PowerShell 5.0 è stato introdotto un nuovo flusso di informazioni strutturate (il numero 6 nei flussi di Windows PowerShell) che è possibile utilizzare per trasmettere dati strutturati tra uno script e i relativi chiamanti (o l'ambiente host).
Write-Information consente di aggiungere un messaggio informativo al flusso e di specificare il modo in cui Windows PowerShell gestisce i dati del flusso di informazioni per un comando. I flussi di informazioni funzionano anche per PowerShell.Streamsi processi, i processi pianificati e i flussi di lavoro.
Annotazioni
Il flusso di informazioni non segue la convenzione standard di prefisso dei messaggi con "[Nome flusso]:". Questo è stato progettato per brevità e pulizia visiva.
Il valore della variabile di preferenza $InformationPreference determina se il messaggio specificato per Write-Information viene visualizzato nel punto previsto nell'operazione di uno script.
Poiché il valore predefinito di questa variabile è SilentlyContinue, per impostazione predefinita, i messaggi informativi non vengono visualizzati.
Se non si desidera modificare il valore di $InformationPreference, è possibile sovrascrivere il relativo valore aggiungendo il InformationAction parametro common al comando.
Per ulteriori informazioni, vedere Informazioni_su_Variabili_di_Preferenza e Informazioni_su_Parametri_Comuni.
Annotazioni
A partire da Windows PowerShell 5.0, Write-Host è un wrapper per Write-Information. Questo consente di usare Write-Host per emettere output nel flusso di informazioni.
In questo modo, l'acquisizione di o l'eliminazione di di dati scritti usando Write-Host mantenendo al tempo stesso la compatibilità con le versioni precedenti.
per ulteriori informazioni, vedere Write-Host
Write-Information è anche un'attività del flusso di lavoro supportata.
Esempio
Esempio 1: Scrivere informazioni per ottenere i risultati
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 questo esempio, viene visualizzato un messaggio informativo, "Got your features!", dopo aver eseguito il Get-WindowsFeature comando per trovare tutte le funzionalità che hanno un valore Name che inizia con 'p'.
Poiché la $InformationPreference variabile è ancora impostata sul valore predefinito, SilentlyContinueè possibile aggiungere il parametro per eseguire l'override InformationAction del $InformationPreference valore e visualizzare il messaggio.
Il InformationAction valore è Continua, il che significa che il messaggio viene visualizzato, ma lo script o il comando continua, se non è ancora terminato.
Esempio 2: Scrivere informazioni e contrassegnarlo
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 questo esempio si usa Write-Information per informare gli utenti che dovranno eseguire un altro comando al termine dell'esecuzione del comando corrente.
Nell'esempio viene aggiunto il tag Instructions al messaggio informativo.
Dopo aver eseguito questo comando, se si cerca nel flusso di informazioni i messaggi contrassegnati con Istruzioni, il messaggio specificato qui sarà tra i risultati.
Esempio 3: Scrivere informazioni in un file
function Test-Info
{
Get-Process P*
Write-Information "Here you go"
}
Test-Info 6> Info.txt
In questo esempio, si reindirizza il flusso di informazioni nella funzione a un file, Info.txt, utilizzando il codice 6>. Quando apri il file Info.txt, viene visualizzato il testo "Ecco fatto".
Parametri
-MessageData
Specifica un messaggio informativo che si desidera visualizzare agli utenti durante l'esecuzione di uno script o di un comando. Per ottenere risultati ottimali, racchiudere il messaggio informativo tra virgolette. Un esempio è "Test completato".
Proprietà dei parametri
| Tipo: | Object |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Msg |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Tags
Specifica una stringa semplice che è possibile usare per ordinare e filtrare i messaggi aggiunti al flusso di informazioni con Write-Information.
Questo parametro funziona in modo analogo al parametro Tags in New-ModuleManifest.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
None
Write-Information Non accetta l'input convogliato.