Write-Verbose

  • Referência
Módulo:
Microsoft.PowerShell.Utility

Grava o texto para o fluxo de mensagem detalhada.

Syntax

Write-Verbose
     [-Message] <String>
     [<CommonParameters>]

Description

O Write-Verbose cmdlet grava texto no fluxo de mensagens detalhado no PowerShell. Normalmente, o fluxo de mensagens detalhado é usado para fornecer informações mais detalhadas sobre o processamento de comandos.

Por padrão, o fluxo de mensagens detalhado não é exibido, mas você pode exibi-lo alterando o valor da $VerbosePreference variável ou usando o parâmetro comum Detalhado em qualquer comando.

Exemplos

Exemplo 1: escrever uma mensagem de status

Write-Verbose -Message "Searching the Application Event Log."
Write-Verbose -Message "Searching the Application Event Log." -Verbose

Esses comandos usam o Write-Verbose cmdlet para exibir uma mensagem de status. Por padrão, a mensagem não é exibida.

O segundo comando usa o parâmetro comum Verbose , que exibe mensagens detalhadas, independentemente do valor da $VerbosePreference variável.

Exemplo 2: definir $VerbosePreference e gravar uma mensagem de status

$VerbosePreference = "Continue"
Write-Verbose "Copying file $filename"

Esses comandos usam o Write-Verbose cmdlet para exibir uma mensagem de status. Por padrão, a mensagem não é exibida.

O primeiro comando atribui um valor de Continuar à $VerbosePreference variável de preferência. O valor SilentlyContinuepadrão suprime mensagens detalhadas. O segundo comando grava uma mensagem detalhada.

Parâmetros

-Message

Especifica a mensagem a ser exibida. Este parâmetro é necessário. Você também pode canalizar uma cadeia de caracteres de mensagem para Write-Verbose.

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

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém a mensagem para Write-Verbose.

Saídas

None

Write-Verbose grava somente no fluxo de mensagens detalhado.

Observações

  • As mensagens detalhadas são retornadas somente quando o comando usa o parâmetro Verbose comum. Para obter mais informações, confira about_CommonParameters.
  • Em Windows PowerShell trabalhos em segundo plano e comandos remotos, a $VerbosePreference variável na sessão de trabalho e na sessão remota determina se a mensagem detalhada é exibida por padrão. Para obter mais informações sobre a $VerbosePreference variável, consulte about_Preference_Variables.