Delen via


Write-Verbose

Hiermee schrijft u tekst naar de uitgebreide berichtstroom.

Syntaxis

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.

Type:String
Aliassen:Msg
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

U kunt een tekenreeks met het bericht doorsturen naar Write-Verbose.

Uitvoerwaarden

None

Write-Verbose 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 $VerbosePreference variabele in de taaksessie en externe sessie of het uitgebreide bericht standaard wordt weergegeven. Zie about_Preference_Variablesvoor meer informatie over de variabele $VerbosePreference.