Sdílet prostřednictvím

Write-Verbose

Modul:
Microsoft.PowerShell.Utility Module

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

Syntax

Default (Výchozí) 

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

Description

Cmdlet Write-Verbose zapíše text do podrobného výstupu 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 verbózní stream zpráv nezobrazuje, ale můžete ho zobrazit změnou hodnoty proměnné $VerbosePreference nebo použitím společného parametru Verbózní 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á výstižný společný parametr, který zobrazuje všechny výstižné zprávy bez ohledu na hodnotu proměnné $VerbosePreference.

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 proměnné předvolby $VerbosePreference. Výchozí hodnota, SilentlyContinue, potlačí podrobné zprávy. Druhý příkaz zapíše obsáhlou 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 na Write-Verbose.

Vlastnosti parametru

Typ:String
Default value:None
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Msg

Sady parametrů

(All)
Position:0
Povinné:True
Hodnota z kanálu:True
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

Do tohoto cmdletu můžete předat řetězec, který obsahuje zprávu.

Výstupy

None

Tento cmdlet nevrátí žádný výstup. Zapisuje pouze do verbózní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 about_CommonParameters.
  • V úlohách na pozadí v prostředí Windows PowerShell a ve vzdálených příkazech určuje proměnná $VerbosePreference v relaci úlohy a ve vzdálené relaci, zda se podrobná zpráva zobrazí ve výchozím nastavení. Další informace o proměnné $VerbosePreference naleznete v tématu about_Preference_Variables.