Compartilhar via

Write-Verbose

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

Grava texto no fluxo de mensagens detalhado.

Sintaxe

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

Description

O cmdlet grava texto no fluxo de mensagens detalhado no Windows PowerShell. Normalmente, o fluxo de mensagens detalhado é usado para fornecer informações sobre o processamento de comando que é usado para depurar um comando.

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

Exemplos

Exemplo 1: escrever uma mensagem de status

PS C:\> Write-Verbose -Message "Searching the Application Event Log."
PS C:\> Write-Verbose -Message "Searching the Application Event Log." -Verbose

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

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

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

PS C:\> $VerbosePreference = "Continue"
PS C:\> Write-Verbose "Copying file $filename"

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

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

Parâmetros

-Message

Especifica a mensagem a ser exibida. Esse parâmetro é necessário. Você também pode canalizar uma cadeia de caracteres de mensagem para detalhado de gravação.

Tipo:String
Aliases:Msg
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém a mensagem para detalhado de gravação.

Saídas

None

gravação detalhada grava somente no fluxo de mensagens detalhado.

Observações

  • Mensagens detalhadas são retornadas somente quando o comando usa o parâmetro detalhado. Para obter mais informações, consulte about_CommonParameters.
  • Em trabalhos em segundo plano do Windows PowerShell e comandos remotos, a variável $VerbosePreference 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 variável $VerbosePreference, consulte about_Preference_Variables.