Write-Verbose

Módulo:: Microsoft.PowerShell.Utility Module

Grava texto no fluxo de mensagens detalhado.

Sintaxe

Default (Default)

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

Description

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

Por padrão, a transmissão de mensagem detalhada não é exibida, mas você pode exibi-la alterando o valor da variável $VerbosePreference ou usando o parâmetro comum Verbose 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 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 mensagens verbosas, independentemente do valor da variável $VerbosePreference.

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

$VerbosePreference = "Continue"
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 verbosas. O segundo comando grava uma mensagem detalhada.

Parâmetros

-Message

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

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False
Aliases:	Msg

Conjuntos de parâmetros

(All)

Cargo:	0
Obrigatório:	True
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém a mensagem para este cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída. Ela grava somente o texto para o fluxo de mensagem detalhada.

Observações

As mensagens detalhadas só são retornadas quando o comando usa o parâmetro comum Verbose. 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 aparece por padrão. Para obter mais informações sobre a variável $VerbosePreference, consulte about_Preference_Variables.

Compartilhar via