Sdílet prostřednictvím

Write-Verbose

  • Reference
Modul:
Microsoft.PowerShell.Utility

Zapíše text do podrobného datového proudu zpráv.

Syntaxe

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

Description

Rutina Write-Verbose zapisuje text do podrobného datového proudu zpráv v prostředí Windows PowerShell. Podrobný datový proud zpráv se obvykle používá k doručování informací o zpracování příkazů, které se používají k ladění příkazu.

Ve výchozím nastavení se podrobný datový proud zpráv nezobrazuje, ale můžete ho zobrazit změnou hodnoty proměnné $VerbosePreference nebo použitím podrobného společný parametr v libovolném příkazu.

Příklady

Příklad 1: Zápis stavové zprávy

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

Tyto příkazy používají rutinu Write-Verbose k zobrazení stavové zprávy. Ve výchozím nastavení se zpráva nezobrazí.

Druhý příkaz používá Podrobný společný parametr, který zobrazuje všechny podrobné zprávy bez ohledu na hodnotu proměnné $VerbosePreference.

Příklad 2: Nastavení $VerbosePreference a zápis stavové zprávy

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

Tyto příkazy používají rutinu Write-Verbose k zobrazení stavové zprávy. Ve výchozím nastavení se zpráva nezobrazí.

První příkaz přiřadí hodnotu Continue proměnné předvolby $VerbosePreference. Výchozí hodnota SilentlyContinue potlačí podrobné zprávy. Druhý příkaz zapíše podrobnou zprávu.

Parametry

-Message

Určuje zprávu, která se má zobrazit. Tento parametr je povinný. Můžete také převést řetězec zprávy Write-Verbose.

Typ:String
Aliasy:Msg
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

Vstupy

String

Můžete přát řetězec, který obsahuje zprávu pro Write-Verbose.

Výstupy

None

zápisu se zapisuje pouze do podrobného datového proudu zpráv.

Poznámky

  • Podrobné zprávy jsou vráceny pouze v případech, kdy příkaz používá Podrobné společný parametr. Další informace najdete v tématu about_CommonParameters.
  • V úlohách a vzdálených příkazech prostředí Windows PowerShell na pozadí určuje proměnná $VerbosePreference v relaci úlohy a vzdálená relace, jestli se ve výchozím nastavení zobrazí podrobná zpráva. Další informace o proměnné $VerbosePreference naleznete v tématu about_Preference_Variables.