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 zapíše text do podrobného datového proudu zpráv v PowerShellu. Podrobný datový proud zpráv se obvykle používá k doručování podrobnějších informací o zpracování příkazů.

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

Příklady

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

Write-Verbose -Message "Searching the Application Event Log."
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 $VerbosePreference proměnné.

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

$VerbosePreference = "Continue"
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 k $VerbosePreference proměnné předvoleb. Výchozí hodnota , SilentlyContinuepotlačuje 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ý. Řetězec zprávy můžete také převést na 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

Do této rutiny můžete zamísit řetězec, který obsahuje zprávu.

Výstupy

None

Tato rutina nevrátí žádný výstup. Zapisuje se pouze do podrobného datového proudu zpráv.

Poznámky

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