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.