Compartilhar via


Write-Verbose

Grava o texto no fluxo de mensagem detalhado.

Sintaxe

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

Descrição

O cmdlet Write-Verbose grava texto no fluxo de mensagem detalhado no Windows PowerShell. Normalmente, o fluxo de mensagem detalhado é usado para entregar informações sobre processamento de comandos que é usado para depurar um comando.

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

Parâmetros

-Message <string>

Especifica a mensagem a ser exibida. Esse parâmetro é obrigatório. Você também pode canalizar uma cadeia de caracteres de mensagem para Verbose-Message.

Necessário?

true

Posição?

1

Valor padrão

Aceitar entrada do pipeline?

true (ByValue)

Aceitar caracteres curinga?

false

<CommonParameters>

Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.

Entradas e saídas

O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.

Entradas

System.String

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

Saídas

Nenhum

Write-Verbose só grava no fluxo de mensagem detalhado.

Exemplo 1

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

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

Descrição
-----------
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 comum Verbose que exibe qualquer mensagem detalhada independentemente do valor da variável $ VerbosePreference.





Exemplo 2

C:\PS>$VerbosePreference = "Continue"

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

Descrição
-----------
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 "Continue" à variável de preferência $VerbosePreference. O valor padrão, "SilentlyContinue", suprime mensagens detalhadas.

O segundo comando grava uma mensagem detalhada.





Consulte também

Conceitos

Write-Error
Write-Warning
about_Preference_Variables