Write-Verbose

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee schrijft u tekst naar de uitgebreide berichtstroom.

Syntax

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, die uitgebreide berichten weergeeft, 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, SilentlyContinueonderdrukt 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.

Type:String
Aliases:Msg
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

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_CommonParameters voor meer informatie.
  • In Windows PowerShell-achtergrondtaken en externe opdrachten bepaalt de $VerbosePreference variabele in de taaksessie en externe sessie of het uitgebreide bericht standaard wordt weergegeven. Zie about_Preference_Variables voor meer informatie over de $VerbosePreference variabele.