Write-Verbose
Zapíše text do podrobného datového proudu zpráv.
Syntax
Default (Výchozí)
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 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 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
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 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.