Write-Verbose
Hiermee schrijft u tekst naar de uitgebreide berichtstroom.
Syntaxis
Default (Standaard)
Write-Verbose
[-Message] <String>
[<CommonParameters>]
Description
De Write-Verbose cmdlet schrijft tekst naar de uitgebreide berichtstroom in PowerShell. Normaal gesproken wordt de uitgebreide berichtstroom gebruikt om uitgebreidere informatie over de verwerking van opdrachten te leveren.
Standaard wordt de uitgebreide berichtstroom niet weergegeven, maar u kunt deze weergeven door de waarde van de $VerbosePreference variabele te wijzigen of door de uitgebreide algemene parameter in elke opdracht te gebruiken.
Voorbeelden
Voorbeeld 1: Een statusbericht schrijven
Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose
Deze opdrachten gebruiken de Write-Verbose cmdlet om een statusbericht weer te geven. Standaard wordt het bericht niet weergegeven.
De tweede opdracht maakt gebruik van de uitgebreide algemene parameter, waarin uitgebreide berichten worden weergegeven, ongeacht de waarde van de $VerbosePreference variabele.
Voorbeeld 2: $VerbosePreference instellen en een statusbericht schrijven
$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"
Deze opdrachten gebruiken de Write-Verbose cmdlet om een statusbericht weer te geven. Standaard wordt het bericht niet weergegeven.
Met de eerste opdracht wordt een waarde van Continue toegewezen aan de $VerbosePreference voorkeursvariabele. De standaardwaarde, SilentlyContinue, onderdrukt uitgebreide berichten. Met de tweede opdracht wordt een uitgebreid bericht geschreven.
Parameters
-Message
Hiermee geeft u het bericht weer te geven. Deze parameter is vereist. U kunt ook een berichttekenreeks doorsturen naar Write-Verbose.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Msg |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| 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
String
U kunt een tekenreeks met het bericht doorsturen naar deze cmdlet.
Uitvoerwaarden
None
Deze cmdlet retourneert geen uitvoer. Het schrijft alleen naar de uitgebreide berichtstroom.
Notities
- Uitgebreide berichten worden alleen geretourneerd wanneer de opdracht gebruikmaakt van de Uitgebreide algemene parameter. Zie about_CommonParametersvoor meer informatie.
- In Windows PowerShell-achtergrondtaken en externe opdrachten bepaalt de
$VerbosePreferencevariabele in de taaksessie en externe sessie of het uitgebreide bericht standaard wordt weergegeven. Zie$VerbosePreferencevoor meer informatie over de variabele .