about_Preference_Variables

Krátký popis

Proměnné, které přizpůsobují chování PowerShellu.

Dlouhý popis

PowerShell obsahuje sadu proměnných, které umožňují přizpůsobit jeho chování. Tyto proměnné předvoleb fungují podobně jako možnosti v systémech založených na grafickém uživatelském rozhraní.

Proměnné předvoleb ovlivňují provozní prostředí PowerShellu a všechny příkazy se spouští v prostředí. V mnoha případech mají rutiny parametry, které můžete použít k přepsání chování předvoleb pro konkrétní příkaz.

Následující tabulka uvádí proměnné předvoleb a jejich výchozí hodnoty.

Proměnná Výchozí hodnota
$ConfirmPreference High
$DebugPreference SilentlyContinue
$ErrorActionPreference Continue
$ErrorView ConciseView
$FormatEnumerationLimit 4
$InformationPreference SilentlyContinue
$LogCommandHealthEvent $False (nezaprotokolováno)
$LogCommandLifecycleEvent $False (nezaprotokolováno)
$LogEngineHealthEvent $True (protokolováno)
$LogEngineLifecycleEvent $True (protokolováno)
$LogProviderLifecycleEvent $True (protokolováno)
$LogProviderHealthEvent $True (protokolováno)
$MaximumHistoryCount 4096
$OFS Znak mezery (" ")
$OutputEncoding UTF8Encoding objekt
$ProgressPreference Continue
$PSDefaultParameterValues @{} (prázdná tabulka hash)
$PSEmailServer $Null (žádné)
$PSModuleAutoLoadingPreference All
$PSSessionApplicationName 'wsman'
$PSSessionConfigurationName 'http://schemas.microsoft.com/powershell/Microsoft.PowerShell'
$PSSessionOption PSSessionOption objekt
$Transcript $Null (žádné)
$VerbosePreference SilentlyContinue
$WarningPreference Continue
$WhatIfPreference $False

PowerShell obsahuje následující proměnné prostředí, které ukládají uživatelské předvolby. Další informace o těchto proměnných prostředí najdete v tématu about_Environment_Variables.

  • env:PSExecutionPolicyPreference
  • $env:PSModulePath

Poznámka

Změny v proměnné předvoleb se projeví pouze ve skriptech a funkcích, pokud jsou tyto skripty nebo funkce definovány ve stejném oboru jako obor, ve kterém se předvolba použila. Další informace najdete v tématu about_Scopes.

Práce s proměnnými předvoleb

Tento dokument popisuje jednotlivé proměnné předvoleb.

Pokud chcete zobrazit aktuální hodnotu konkrétní proměnné předvoleb, zadejte název proměnné. Například následující příkaz zobrazí $ConfirmPreference hodnotu proměnné.

 $ConfirmPreference
High

Pokud chcete změnit hodnotu proměnné, použijte příkaz přiřazení. Například následující příkaz změní hodnotu parametru $ConfirmPreference na Střední.

$ConfirmPreference = "Medium"

Hodnoty, které jste nastavili, jsou specifické pro aktuální relaci PowerShellu. Pokud chcete, aby proměnné byly efektivní ve všech relacích PowerShellu, přidejte je do svého profilu PowerShellu. Další informace najdete v tématu about_Profiles.

Práce vzdáleně

Pokud spouštíte příkazy na vzdáleném počítači, vzdálené příkazy podléhají jenom předvolbám nastaveným v klientovi PowerShellu vzdáleného počítače. Například při spuštění vzdáleného příkazu určuje hodnota proměnné vzdáleného počítače $DebugPreference způsob reakce PowerShellu na ladicí zprávy.

Další informace o vzdálených příkazech najdete v tématu about_Remote.

$ConfirmPreference

Určuje, jestli PowerShell před spuštěním rutiny nebo funkce automaticky vyzve k potvrzení.

Proměnná $ConfirmPreference přebírá jednu z možnostíConfirmImpact Výčtové hodnoty: Vysoká, Střední, Nízká nebo Žádná.

Rutiny a funkce mají přiřazené riziko vysoké, střední nebo nízké. Pokud je hodnota $ConfirmPreference proměnné menší nebo rovna riziku přiřazeného rutině nebo funkci, PowerShell vás před spuštěním rutiny nebo funkce automaticky vyzve k potvrzení.

Pokud je hodnota $ConfirmPreference proměnné None, PowerShell vás nikdy automaticky nezobrazí před spuštěním rutiny nebo funkce.

Pokud chcete změnit potvrzovací chování pro všechny rutiny a funkce v relaci, změňte $ConfirmPreference hodnotu proměnné.

K přepsání $ConfirmPreference jednoho příkazu použijte parametr Confirm rutiny nebo funkce. Pokud chcete požádat o potvrzení, použijte -Confirm. Chcete-li potlačit potvrzení, použijte -Confirm:$false.

Platné hodnoty $ConfirmPreference:

  • Žádné: PowerShell automaticky nezobrazí výzvu. Pokud chcete požádat o potvrzení konkrétního příkazu, použijte parametr Confirm rutiny nebo funkce.
  • Nízká: PowerShell před spuštěním rutin nebo funkcí s nízkým, středním nebo vysokým rizikem zobrazí výzvu k potvrzení.
  • Střední: PowerShell vyzve k potvrzení před spuštěním rutin nebo funkcí se středním nebo vysokým rizikem.
  • Vysoká: PowerShell před spuštěním rutin nebo funkcí s vysokým rizikem vyzve k potvrzení.

Podrobné vysvětlení

PowerShell vás může před provedením akce automaticky vyzvat k potvrzení. Pokud například rutina nebo funkce výrazně ovlivní systém odstranění dat nebo použití významného množství systémových prostředků.

Remove-Item -Path C:\file.txt
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target "C:\file.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [?] Help (default is "Y"):

Odhad rizika je atributem rutiny nebo funkce, která se označuje jako jeho ConfirmImpact. Uživatelé ho nemůžou změnit.

Rutiny a funkce, které mohou představovat riziko pro systém, mají parametr Confirm , který můžete použít k vyžádání nebo potlačení potvrzení pro jeden příkaz.

Vzhledem k tomu, že většina rutin a funkcí používá výchozí hodnotu rizika, ConfirmImpact, of Medium a výchozí hodnota $ConfirmPreference je Vysoká, dochází k automatickému potvrzení zřídka. Automatické potvrzení však můžete aktivovat změnou hodnoty $ConfirmPreference na Střední nebo Nízká.

Příklady

Tento příklad ukazuje účinek $ConfirmPreference výchozí hodnoty proměnné, Vysoká. Vysoká hodnota pouze potvrzuje vysoce rizikové rutiny a funkce. Vzhledem k tomu, že většina rutin a funkcí je středně riziková, nejsou automaticky potvrzeny a Remove-Item odstraňují soubor. Přidání -Confirm do příkazového řádku uživateli k potvrzení.

$ConfirmPreference
High
Remove-Item -Path C:\temp1.txt

Slouží -Confirm k vyžádání potvrzení.

Remove-Item -Path C:\temp2.txt -Confirm
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target "C:\temp2.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All
[?] Help (default is "Y"):

Následující příklad ukazuje účinek změny hodnoty $ConfirmPreference na Střední. Vzhledem k tomu, že většina rutin a funkcí je středně riziková, jsou automaticky potvrzena. Chcete-li potlačit výzvu k potvrzení pro jeden příkaz, použijte parametr Confirm s hodnotou $false.

$ConfirmPreference = "Medium"
Remove-Item -Path C:\temp2.txt
Confirm
Are you sure you want to perform this action?
Performing operation "Remove File" on Target "C:\temp2.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All
[?] Help (default is "Y"):
Remove-Item -Path C:\temp3.txt -Confirm:$false

$DebugPreference

Určuje, jak PowerShell reaguje na ladicí zprávy generované skriptem, rutinou nebo poskytovatelem nebo příkazem Write-Debug na příkazovém řádku.

Proměnná $DebugPreference přebírá jednu z možnostíActionPreference Hodnoty výčtu: SilentlyContinue, Stop, Continue, Inquire, Ignore, Suspend nebo Break.

Některé rutiny zobrazují zprávy ladění, které jsou obvykle technické zprávy navržené pro programátory a odborníky na technickou podporu. Ve výchozím nastavení se zprávy ladění nezobrazují, ale můžete zobrazit ladicí zprávy změnou hodnoty $DebugPreference.

Pomocí běžného parametru Ladění rutiny můžete zobrazit nebo skrýt zprávy ladění pro konkrétní příkaz. Další informace najdete v tématu about_CommonParameters.

Platné hodnoty jsou následující:

  • Stop: Zobrazí ladicí zprávu a zastaví provádění. Zapíše chybu do konzoly.
  • Inquire: Zobrazí ladicí zprávu a zeptá se, jestli chcete pokračovat. Přidání běžného parametru Debug do příkazu, když je příkaz nakonfigurován pro vygenerování ladicí zprávy, změní hodnotu $DebugPreference proměnné na Inquire.
  • Pokračovat: Zobrazí zprávu ladění a pokračuje v provádění.
  • SilentlyContinue: (Výchozí) Žádný efekt. Zpráva ladění se nezobrazí a provádění bude pokračovat bez přerušení.

Příklady

Následující příklady ukazují účinek změny hodnot $DebugPreference při Write-Debug zadání příkazu na příkazovém řádku. Tato změna ovlivňuje všechny zprávy ladění, včetně zpráv generovaných rutinami a skripty. Příklady ukazují parametr Ladění , který zobrazí nebo skryje ladicí zprávy související s jedním příkazem.

Tento příklad ukazuje efekt $DebugPreference výchozí hodnoty proměnné SilentlyContinue. Ve výchozím nastavení Write-Debug se zpráva ladění rutiny nezobrazuje a zpracování pokračuje. Při použití parametru Debug přepíše předvolbu pro jeden příkaz. Zobrazí se zpráva ladění.

$DebugPreference
SilentlyContinue
Write-Debug -Message "Hello, World"
Write-Debug -Message "Hello, World" -Debug
DEBUG: Hello, World

Tento příklad ukazuje efekt s $DebugPreference hodnotou Pokračovat . Zobrazí se zpráva ladění a příkaz bude dál zpracovávat.

$DebugPreference = "Continue"
Write-Debug -Message "Hello, World"
DEBUG: Hello, World

Tento příklad používá parametr Debug s hodnotou $false potlačování zprávy pro jeden příkaz. Zpráva ladění se nezobrazuje.

Write-Debug -Message "Hello, World" -Debug:$false

Tento příklad ukazuje účinek $DebugPreference nastavení na hodnotu Stop . Zobrazí se zpráva ladění a příkaz se zastaví.

$DebugPreference = "Stop"
Write-Debug -Message "Hello, World"
DEBUG: Hello, World
Write-Debug : The running command stopped because the preference variable
 "DebugPreference" or common parameter is set to Stop: Hello, World
At line:1 char:1
+ Write-Debug -Message "Hello, World"

Tento příklad používá parametr Debug s hodnotou $false potlačování zprávy pro jeden příkaz. Zpráva ladění se nezobrazuje a zpracování se nezastaví.

Write-Debug -Message "Hello, World" -Debug:$false

Tento příklad ukazuje účinek $DebugPreference nastavení na hodnotu Inquire . Zobrazí se zpráva ladění a uživateli se zobrazí výzva k potvrzení.

$DebugPreference = "Inquire"
Write-Debug -Message "Hello, World"
DEBUG: Hello, World

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):

Tento příklad používá parametr Debug s hodnotou $false potlačování zprávy pro jeden příkaz. Zpráva ladění se nezobrazuje a zpracování pokračuje.

Write-Debug -Message "Hello, World" -Debug:$false

$ErrorActionPreference

Určuje, jak PowerShell reaguje na neukončující chybu, chybu, která nezastaví zpracování rutiny. Například na příkazovém řádku nebo ve skriptu, rutině nebo poskytovateli, jako jsou chyby generované rutinou Write-Error .

Proměnná $ErrorActionPreference přebírá jednu z možnostíActionPreference Hodnoty výčtu: SilentlyContinue, Stop, Continue, Inquire, Ignore, Suspend nebo Break.

Pomocí běžného parametru ErrorAction rutiny můžete přepsat předvolbu konkrétního příkazu.

Platné hodnoty jsou následující:

  • Konec – Zadejte ladicí program, když dojde k chybě nebo když dojde k výjimce.
  • Pokračovat: (výchozí) Zobrazí chybovou zprávu a pokračuje v provádění.
  • Ignorovat: Potlačí chybovou zprávu a bude pokračovat spuštěním příkazu. Hodnota Ignorovat je určená pro použití pro jednotlivé příkazy, nikoli pro použití jako uložená předvolba. Ignorovat není platná hodnota proměnné $ErrorActionPreference .
  • Inquire: Zobrazí chybovou zprávu a zeptá se vás, jestli chcete pokračovat.
  • TišeContinue: Žádný efekt. Chybová zpráva se nezobrazí a provádění pokračuje bez přerušení.
  • Stop: Zobrazí chybovou zprávu a zastaví provádění. Kromě vygenerované chyby vygeneruje hodnota Stop objekt ActionPreferenceStopException do datového proudu chyb.
  • Pozastavení: Automaticky pozastaví úlohu pracovního postupu, aby bylo možné provést další šetření. Po šetření je možné pracovní postup obnovit. Hodnota Pozastavení je určena pro použití pro jednotlivé příkazy, nikoli pro použití jako uložená předvolba. Pozastavení není platná hodnota proměnné $ErrorActionPreference .

$ErrorActionPreference a parametr ErrorAction nemá vliv na to, jak PowerShell reaguje na ukončující chyby, které zastavují zpracování rutin. Další informace o společném parametru ErrorAction najdete v tématu about_CommonParameters.

Příklady

Tyto příklady ukazují účinek různých hodnot $ErrorActionPreference proměnné. Parametr ErrorAction se používá k přepsání $ErrorActionPreference hodnoty.

Tento příklad ukazuje $ErrorActionPreference výchozí hodnotu Continue. Vygeneruje se nekončující chyba. Zpráva se zobrazí a zpracování bude pokračovat.

# Change the ErrorActionPreference to 'Continue'
$ErrorActionPreference = 'Continue'
# Generate a non-terminating error and continue processing the script.
Write-Error -Message  'Test Error' ; Write-Host 'Hello World'
Write-Error: Test Error
Hello World

Tento příklad ukazuje $ErrorActionPreference výchozí hodnotu Inquire. Vygeneruje se chyba a zobrazí se výzva k akci.

# Change the ErrorActionPreference to 'Inquire'
$ErrorActionPreference = 'Inquire'
Write-Error -Message 'Test Error' ; Write-Host 'Hello World'
Confirm
Test Error
[Y] Yes  [A] Yes to All  [H] Halt Command  [S] Suspend  [?] Help (default is "Y"):

Tento příklad ukazuje $ErrorActionPreference sadu na SilentlyContinue. Chybová zpráva je potlačena.

# Change the ErrorActionPreference to 'SilentlyContinue'
$ErrorActionPreference = 'SilentlyContinue'
# Generate an error message
Write-Error -Message 'Test Error' ; Write-Host 'Hello World'
# Error message is suppressed and script continues processing
Hello World

V tomto příkladu je nastavená $ErrorActionPreference možnost Zastavit. Zobrazuje také extra objekt vygenerovaný pro proměnnou $Error .

# Change the ErrorActionPreference to 'Stop'
$ErrorActionPreference = 'Stop'
# Error message is is generated and script stops processing
Write-Error -Message 'Test Error' ; Write-Host 'Hello World'

# Show the ActionPreferenceStopException and the error generated
$Error[0]
$Error[1]
Write-Error: Test Error

ErrorRecord                 : Test Error
WasThrownFromThrowStatement : False
TargetSite                  : System.Collections.ObjectModel.Collection`1[System.Management.Automation.PSObject]
                              Invoke(System.Collections.IEnumerable)
StackTrace                  :    at System.Management.Automation.Runspaces.PipelineBase.Invoke(IEnumerable input)
                                 at Microsoft.PowerShell.Executor.ExecuteCommandHelper(Pipeline tempPipeline,
                              Exception& exceptionThrown, ExecutionOptions options)
Message                     : The running command stopped because the preference variable "ErrorActionPreference" or
                              common parameter is set to Stop: Test Error
Data                        : {System.Management.Automation.Interpreter.InterpretedFrameInfo}
InnerException              :
HelpLink                    :
Source                      : System.Management.Automation
HResult                     : -2146233087

Write-Error: Test Error

$ErrorView

Určuje formát zobrazení chybových zpráv v PowerShellu.

Proměnná $ErrorView přebírá jednu z hodnot výčtu ErrorView : NormalView, CategoryView nebo ConciseView.

Platné hodnoty jsou následující:

  • ConciseView: (Výchozí) Poskytuje stručnou chybovou zprávu a refaktorované zobrazení pro pokročilé tvůrce modulů. Od PowerShellu 7.2 je-li chyba z příkazového řádku nebo modulu skriptu, výstup je chybová zpráva s jedním řádkem. V opačném případě se zobrazí chybová zpráva s víceřádkovými řádky, která obsahuje chybu a ukazatel na chybu zobrazující, kde se na daném řádku vyskytuje. Pokud terminál podporuje virtuální terminál, použijí se barevné kódy ANSI k zajištění barevného zvýraznění. Barvu zvýraznění lze změnit na .$Host.PrivateData.ErrorAccentColor Rutinu použijte Get-Error k komplexnímu podrobnému zobrazení plně kvalifikované chyby, včetně vnitřních výjimek.

    Funkce ConciseView byla přidána v PowerShellu 7.

  • NormalView: Podrobné zobrazení navržené pro většinu uživatelů Skládá se z popisu chyby a názvu objektu, který je součástí chyby.

  • CategoryView: Stručné strukturované zobrazení navržené pro produkční prostředí. Formát je následující:

    {Category}: ({TargetName}:{TargetType}):[{Activity}], {Reason}

Další informace o polích v CategoryView naleznete v tématu ErrorCategoryInfo třída.

Příklady

Tento příklad ukazuje, jak se zobrazí chyba, když je výchozí hodnota $ErrorViewConciseView. Get-ChildItem slouží k vyhledání neexistující adresáře.

Get-ChildItem -path 'C:\NoRealDirectory'
Get-ChildItem: Cannot find path 'C:\NoRealDirectory' because it does not exist.

Tento příklad ukazuje, jak se zobrazí chyba, když je výchozí hodnota $ErrorViewConciseView. Script.ps1 je spuštěn a vyvolá chybu z Get-Item příkazu.

./Script.ps1
Get-Item: C:\Script.ps1
Line |
  11 | Get-Item -Path .\stuff
     | ^ Cannot find path 'C:\demo\stuff' because it does not exist.

Tento příklad ukazuje, jak se zobrazí chyba při změně hodnoty $ErrorViewnormalview. Get-ChildItem slouží k vyhledání neexistujícího souboru.

Get-ChildItem -Path C:\nofile.txt
Get-ChildItem : Cannot find path 'C:\nofile.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path C:\nofile.txt

Tento příklad ukazuje, jak se zobrazí stejná chyba, když se hodnota $ErrorView změní na CategoryView.

$ErrorView = "CategoryView"
Get-ChildItem -Path C:\nofile.txt
ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem], ItemNotFoundException

Tento příklad ukazuje, že hodnota $ErrorView pouze ovlivňuje zobrazení chyby. Nezmění strukturu objektu chyby, který je uložený v $Error automatické proměnné. Informace o $Error automatické proměnné najdete v tématu about_automatic_variables.

Následující příkaz převezme objekt ErrorRecord přidružený k nejnovější chybě v poli chyby, elementu 0 a naformátuje všechny vlastnosti objektu chyby v seznamu.

$Error[0] | Format-List -Property * -Force
PSMessageDetails      :
Exception             : System.Management.Automation.ItemNotFoundException:
                          Cannot find path 'C:\nofile.txt' because it does
                          not exist.
                        at System.Management.Automation.SessionStateInternal.
                          GetChildItems(String path, Boolean recurse, UInt32
                          depth, CmdletProviderContext context)
                        at System.Management.Automation.ChildItemCmdlet
                          ProviderIntrinsics.Get(String path, Boolean
                          recurse, UInt32 depth, CmdletProviderContext context)
                        at Microsoft.PowerShell.Commands.GetChildItemCommand.
                          ProcessRecord()
TargetObject          : C:\nofile.txt
CategoryInfo          : ObjectNotFound: (C:\nofile.txt:String) [Get-ChildItem],
                          ItemNotFoundException
FullyQualifiedErrorId : PathNotFound,
                          Microsoft.PowerShell.Commands.GetChildItemCommand
ErrorDetails          :
InvocationInfo        : System.Management.Automation.InvocationInfo
ScriptStackTrace      : at <ScriptBlock>, <No file>: line 1
PipelineIterationInfo : {0, 1}

$FormatEnumerationLimit

Určuje, kolik položek výčtu je součástí zobrazení. Tato proměnná nemá vliv na podkladové objekty, pouze zobrazení. Pokud je hodnota $FormatEnumerationLimit menší než počet výčtových položek, PowerShell přidá tři tečky (...) k označení položek, které se nezobrazují.

Platné hodnoty: Celá čísla (Int32)

Výchozí hodnota: 4

Příklady

Tento příklad ukazuje, jak použít proměnnou $FormatEnumerationLimit ke zlepšení zobrazení výčtu položek.

Příkaz v tomto příkladu vygeneruje tabulku, která obsahuje všechny služby spuštěné v počítači ve dvou skupinách: jednu pro spuštěné služby a jednu pro zastavené služby. Pomocí Get-Service příkazu získá všechny služby a pak výsledky odešle prostřednictvím kanálu do Group-Object rutiny, která seskupí výsledky podle stavu služby.

Výsledkem je tabulka, která uvádí stav ve sloupci Název a procesy ve sloupci Skupina . Pokud chcete změnit popisky sloupců, použijte tabulku hash, viz about_Hash_Tables. Další informace najdete v příkladech ve formátu tabulky.

Najděte aktuální hodnotu .$FormatEnumerationLimit

$FormatEnumerationLimit
4

Zobrazí seznam všech služeb seskupených podle stavu. Pro každý stav je uvedeno maximálně čtyři služby ve sloupci Skupina , protože $FormatEnumerationLimit má hodnotu 4.

Get-Service | Group-Object -Property Status
Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv...}
41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart...}

Pokud chcete zvýšit počet položek uvedených, zvyšte hodnotu $FormatEnumerationLimitna 1000. Použijte Get-Service a Group-Object zobrazte služby.

$FormatEnumerationLimit = 1000
Get-Service | Group-Object -Property Status
Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv, BITS, CcmExec...
41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart, Browser, CiSvc...

Pomocí Format-Table parametru Wrap zobrazte seznam služeb.

Get-Service | Group-Object -Property Status | Format-Table -Wrap
Count  Name       Group
-----  ----       -----
60     Running    {AdtAgent, ALG, Ati HotKey Poller, AudioSrv, BITS, CcmExec,
                  Client for NFS, CryptSvc, DcomLaunch, Dhcp, dmserver,
                  Dnscache, ERSvc, Eventlog, EventSystem, FwcAgent, helpsvc,
                  HidServ, IISADMIN, InoRPC, InoRT, InoTask, lanmanserver,
                  lanmanworkstation, LmHosts, MDM, Netlogon, Netman, Nla,
                  NtLmSsp, PlugPlay, PolicyAgent, ProtectedStorage, RasMan,
                  RemoteRegistry, RpcSs, SamSs, Schedule, seclogon, SENS,
                  SharedAccess, ShellHWDetection, SMT PSVC, Spooler,
                  srservice, SSDPSRV, stisvc, TapiSrv, TermService, Themes,
                  TrkWks, UMWdf, W32Time, W3SVC, WebClient, winmgmt, wscsvc,
                  wuauserv, WZCSVC, zzInterix}

41     Stopped    {Alerter, AppMgmt, aspnet_state, ATI Smart, Browser, CiSvc,
                  ClipSrv, clr_optimization_v2.0.50727_32, COMSysApp,
                  CronService, dmadmin, FastUserSwitchingCompatibility,
                  HTTPFilter, ImapiService, Mapsvc, Messenger, mnmsrvc,
                  MSDTC, MSIServer, msvsmon80, NetDDE, NetDDEdsdm, NtmsSvc,
                  NVSvc, ose, RasAuto, RDSessMgr, RemoteAccess, RpcLocator,
                  SCardSvr, SwPrv, SysmonLog, TlntSvr, upnphost, UPS, VSS,
                  WmdmPmSN, Wmi, WmiApSrv, xmlprov}

$InformationPreference

Proměnná $InformationPreference umožňuje nastavit předvolby informačního streamu, které chcete uživatelům zobrazit. Konkrétně informační zprávy, které jste přidali do příkazů nebo skriptů přidáním rutiny Write-Information . Pokud se použije parametr InformationAction , jeho hodnota přepíše hodnotu $InformationPreference proměnné. Write-Information byl představen v PowerShellu 5.0.

Proměnná $InformationPreference přebírá jednu z možnostíActionPreference Hodnoty výčtu: SilentlyContinue, Stop, Continue, Inquire, Ignore, Suspend nebo Break.

Platné hodnoty jsou následující:

  • Zastavení: Zastaví příkaz nebo skript při výskytu Write-Information příkazu.
  • Inquire: Zobrazí informační zprávu, kterou zadáte v Write-Information příkazu, a pak se zeptá, jestli chcete pokračovat.
  • Pokračovat: Zobrazí informační zprávu a bude pokračovat ve spuštění.
  • Pozastavení je dostupné jenom pro pracovní postupy, které nejsou podporované v PowerShellu 6 a novějších verzích.
  • SilentlyContinue: (Výchozí) Žádný efekt. Informační zprávy se nezobrazují a skript bude pokračovat bez přerušení.

$Log*Událost

Proměnné předvoleb událostí protokolu*určují, které typy událostí se zapisují do protokolu událostí PowerShellu v Prohlížeč událostí. Ve výchozím nastavení se protokolují pouze události modulu a zprostředkovatele. Proměnné předvoleb událostí protokolu ale můžete použít k přizpůsobení protokolu, například protokolování událostí o příkazech.

Proměnné předvoleb událostí protokolu jsou následující:

  • $LogCommandHealthEvent: Protokoluje chyby a výjimky při inicializaci a zpracování příkazů. Výchozí hodnota je $false (nezaprotokolována).
  • $LogCommandLifecycleEvent: Zaznamenává spouštění a zastavování příkazů a kanálů příkazů a výjimek zabezpečení při zjišťování příkazů. Výchozí hodnota je $false (nezaprotokolována).
  • $LogEngineHealthEvent: Protokoluje chyby a selhání relací. Výchozí hodnota je $true (protokolovaná).
  • $LogEngineLifecycleEvent: Zaznamená otevření a uzavření relací. Výchozí hodnota je $true (protokolovaná).
  • $LogProviderHealthEvent: Protokoluje chyby poskytovatele, jako jsou chyby čtení a zápisu, chyby vyhledávání a vyvolání. Výchozí hodnota je $true (protokolovaná).
  • $LogProviderLifecycleEvent: Zaznamenává přidávání a odebírání zprostředkovatelů PowerShellu. Výchozí hodnota je $true (protokolovaná). Informace o zprostředkovatelech PowerShellu najdete v tématu about_Providers.

Pokud chcete povolit událost protokolu*, zadejte proměnnou s hodnotou $true, například:

$LogCommandLifeCycleEvent = $true

Pokud chcete zakázat typ události, zadejte proměnnou s hodnotou $false, například:

$LogCommandLifeCycleEvent = $false

Události, které povolíte, jsou platné pouze pro aktuální konzolu PowerShellu. Pokud chcete použít konfiguraci pro všechny konzoly, uložte nastavení proměnné v profilu PowerShellu. Další informace najdete v tématu about_Profiles.

$MaximumHistoryCount

Určuje, kolik příkazů se uloží v historii příkazů pro aktuální relaci.

Platné hodnoty: 1 – 32768 (Int32)

Výchozí: 4096

Pokud chcete určit počet příkazů, které jsou aktuálně uložené v historii příkazů, zadejte:

(Get-History).Count

Pokud chcete zobrazit příkazy uložené v historii relací, použijte tuto rutinu Get-History . Další informace najdete v tématu about_History.

$OFS

Oddělovač výstupního pole (OFS) určuje znak, který odděluje prvky pole, které je převedeno na řetězec.

Platné hodnoty: Libovolný řetězec.

Výchozí: Mezerník

Ve výchozím nastavení $OFS proměnná neexistuje a oddělovač výstupních souborů je mezera, ale tuto proměnnou můžete přidat a nastavit ji na libovolný řetězec. Hodnotu $OFS relace můžete změnit zadáním $OFS="<value>".

Poznámka

Pokud očekáváte výchozí hodnotu mezery (" ") ve skriptu, modulu nebo výstupu konfigurace, dávejte pozor, aby $OFS se výchozí hodnota nezměnila jinde v kódu.

Příklady

Tento příklad ukazuje, že mezera slouží k oddělení hodnot při převodu pole na řetězec. V tomto případě je pole celých čísel uloženo v proměnné a pak se proměnná přetypuje jako řetězec.

$array = 1,2,3,4
[string]$array
1 2 3 4

Pokud chcete změnit oddělovač, přidejte $OFS proměnnou tak, že k ní přiřadíte hodnotu. Proměnná musí mít název $OFS.

$OFS = "+"
[string]$array
1+2+3+4

Pokud chcete obnovit výchozí chování, můžete k hodnotě $OFS proměnné přiřadit mezeru (" ") nebo ji odstranit. Následující příkazy odstraňují proměnnou a ověřte, že oddělovač je mezera.

Remove-Variable OFS
[string]$array
1 2 3 4

$OutputEncoding

Určuje metodu kódování znaků, kterou PowerShell používá při odesílání textu do jiných aplikací.

Pokud například aplikace vrátí řetězce Unicode do PowerShellu, možná budete muset změnit hodnotu na UnicodeEncoding , aby se znaky odeslaly správně.

Platné hodnoty jsou následující: Objekty odvozené z třídy Encoding, jako je ASCIIEncoding, UTF7Encoding, UTF8Encoding, UTF32Encoding a UnicodeEncoding.

Výchozí: UTF8Encoding objekt.

Příklady

Tento příklad ukazuje, jak nastavit, aby příkaz Windowsfindstr.exe fungoval v PowerShellu v počítači, který je lokalizovaný pro jazyk, který používá znaky Unicode, například čínštinu.

První příkaz najde hodnotu $OutputEncoding. Vzhledem k tomu, že hodnota je objekt kódování, zobrazte pouze jeho Vlastnost EncodingName .

$OutputEncoding.EncodingName

V tomto příkladu se příkaz findstr.exe používá k vyhledání dvou čínských znaků, které jsou přítomné v Test.txt souboru. Pokud je tento příkaz findstr.exe spuštěn v příkazovém řádku Windows (cmd.exe), findstr.exe najde znaky v textovém souboru. Pokud ale spustíte stejný příkaz findstr.exe v PowerShellu, znaky se nenašly, protože PowerShell je odesílá dofindstr.exe v textu ASCII místo v textu Unicode.

findstr <Unicode-characters>

Pokud chcete, aby příkaz fungoval v PowerShellu, nastavte hodnotu $OutputEncoding na hodnotu outputEncoding vlastnosti konzoly, která je založená na národním prostředí vybraném pro Windows. Vzhledem k tomu, že OutputEncoding je statická vlastnost konzoly, použijte v příkazu dvojité dvojtečky (::).

$OutputEncoding = [console]::OutputEncoding
$OutputEncoding.EncodingName
OEM United States

Po změně kódování příkazfindstr.exe najde znaky Unicode.

findstr <Unicode-characters>
test.txt:         <Unicode-characters>

$ProgressPreference

Určuje, jak PowerShell reaguje na probíhající aktualizace generované skriptem, rutinou nebo poskytovatelem, jako jsou indikátory průběhu vygenerované rutinou Write-Progress . Rutina Write-Progress vytvoří indikátory průběhu, které zobrazují stav příkazu.

Proměnná $ProgressPreference přebírá jednu z možnostíActionPreference Hodnoty výčtu: SilentlyContinue, Stop, Continue, Inquire, Ignore, Suspend nebo Break.

Platné hodnoty jsou následující:

  • Zastavte: Nezobrazuje indikátor průběhu. Místo toho zobrazí chybovou zprávu a přestane se s ní provádět.
  • Diagnostika: Nezobrazuje indikátor průběhu. Zobrazí výzvu k pokračování oprávnění. Pokud odpovíte nebo YA, zobrazí se indikátor průběhu.
  • Pokračovat: (Výchozí) Zobrazí indikátor průběhu a pokračuje v provádění.
  • SilentlyContinue: Spustí příkaz, ale nezobrazí indikátor průběhu.

$PSDefaultParameterValues

Určuje výchozí hodnoty parametrů rutin a pokročilých funkcí. Hodnota $PSDefaultParameterValues je tabulka hash, ve které se klíč skládá z názvu rutiny a názvu parametru odděleného dvojtekou (:). Hodnota je vlastní výchozí hodnota, kterou zadáte.

$PSDefaultParameterValues byl představen v PowerShellu 3.0.

Další informace o této proměnné předvoleb najdete v tématu about_Parameters_Default_Values.

$PSEmailServer

Určuje výchozí e-mailový server, který se používá k odesílání e-mailových zpráv. Tuto proměnnou předvoleb používají rutiny, které odesílají e-maily, například rutinu Send-MailMessage .

$PSModuleAutoloadingPreference

Povolí a zakáže automatický import modulů v relaci. Vše je výchozí. Pokud chcete importovat modul, získejte nebo použijte libovolný příkaz v modulu. Použijte Get-Commandnapříklad . Proměnná $PSModuleAutoloadingPreference ve výchozím nastavení neexistuje. Výchozí chování, pokud proměnná není definována, je stejná jako $PSModuleAutoloadingPreference = 'All'.

Bez ohledu na hodnotu proměnné můžete modul importovat pomocí modulu Import-Module .

Proměnná $PSModuleAutoloadingPreference přebírá jednu z možnostíPSModuleAutoLoadingPreference Hodnoty výčtu: None, ModuleQualified nebo All.

Platné hodnoty jsou:

  • Vše: Moduly se automaticky importují při prvním použití.
  • ModuleQualified: Moduly se importují automaticky pouze v případě, že uživatel používá v modulu kvalifikovaný název příkazu. Pokud například typy uživatelů MyModule\MyCommandnaimportuje PowerShell modul MyModule .
  • Žádné: Automatické importování modulů je v relaci zakázané. K importu modulu použijte rutinu Import-Module .

Další informace o automatickém importu modulů najdete v tématu about_Modules.

$PSNativeCommandArgumentPassing

Poznámka

$PSNativeCommandArgumentPassing je k dispozici pouze v případě, že PSNativeCommandArgumentPassing je povolená experimentální funkce. Další informace najdete v tématu about_Experimental_Features a používání experimentálních funkcí.

Pokud je tato experimentální funkce povolená, PowerShell používá ArgumentList vlastnost objektu StartProcessInfo místo našeho aktuálního mechanismu rekonstruování řetězce při vyvolání nativního spustitelného souboru.

Upozornění

Nové chování je zásadní změnou od aktuálního chování. To může narušit skripty a automatizaci, které fungují s různými problémy při vyvolání nativních aplikací. V minulosti je nutné uvozovky uvozovek poskytnout nativní aplikaci.

Tato funkce přidá novou automatickou proměnnou $PSNativeCommandArgumentPassing , která umožňuje vybrat chování za běhu. Platné hodnoty jsou Legacy, Standarda Windows. Legacy je historické chování. Výchozí hodnota, když je povolená experimentální funkce, je nové Standard chování.

Když je proměnná předvoleb nastavená na Windows vyvolání následujících souborů, automaticky použije Legacy předávání argumentu stylu.

  • cmd.exe
  • cscript.exe
  • wscript.exe
  • končící na .bat
  • končící na .cmd
  • končící na .js
  • končící na .vbs
  • končící na .wsf

Pokud je nastavena $PSNativeArgumentPassing na nebo LegacyStandard, kontrola těchto souborů se neprojeví. Výchozí chování je specifické pro platformu. Na platformách Windows je Windows výchozí nastavení a jiné platformy než Windows jsou Standard.

Nové chování, které tato změna zpřístupní:

  • Literály nebo rozbalitelné řetězce s vloženými uvozovkami se teď zachovají:

    PS > $a = 'a" "b'
    PS > $PSNativeCommandArgumentPassing = "Legacy"
    PS > testexe -echoargs $a 'a" "b' a" "b
    Arg 0 is <a b>
    Arg 1 is <a b>
    Arg 2 is <a b>
    PS > $PSNativeCommandArgumentPassing = "Standard"
    PS > testexe -echoargs $a 'a" "b' a" "b
    Arg 0 is <a" "b>
    Arg 1 is <a" "b>
    Arg 2 is <a b>
    
  • Prázdné řetězce jako argumenty jsou teď zachovány:

    PS>  $PSNativeCommandArgumentPassing = "Legacy"
    PS> testexe -echoargs '' a b ''
    Arg 0 is <a>
    Arg 1 is <b>
    PS> $PSNativeCommandArgumentPassing = "Standard"
    PS> testexe -echoargs '' a b ''
    Arg 0 is <>
    Arg 1 is <a>
    Arg 2 is <b>
    Arg 3 is <>
    

Nové chování nemění vyvolání, která vypadají takto:

PS> $PSNativeCommandArgumentPassing = "Legacy"
PS> testexe -echoargs -k com:port=\\devbox\pipe\debug,pipe,resets=0,reconnect
Arg 0 is <-k>
Arg 1 is <com:port=\\devbox\pipe\debug,pipe,resets=0,reconnect>
PS> $PSNativeCommandArgumentPassing = "Standard"
PS> testexe -echoargs -k com:port=\\devbox\pipe\debug,pipe,resets=0,reconnect
Arg 0 is <-k>
Arg 1 is <com:port=\\devbox\pipe\debug,pipe,resets=0,reconnect>

Kromě toho je teď k dispozici trasování parametrů, takže Trace-Command poskytuje užitečné informace pro ladění.

PS> $PSNativeCommandArgumentPassing = "Legacy"
PS> trace-command -PSHOST -Name ParameterBinding { testexe -echoargs $a 'a" "b' a" "b }
DEBUG: 2021-02-01 17:19:53.6438 ParameterBinding Information: 0 : BIND NAMED native application line args [/Users/james/src/github/forks/jameswtruher/PowerShell-1/test/tools/TestExe/bin/testexe]
DEBUG: 2021-02-01 17:19:53.6440 ParameterBinding Information: 0 :     BIND argument [-echoargs a" "b a" "b "a b"]
DEBUG: 2021-02-01 17:19:53.6522 ParameterBinding Information: 0 : CALLING BeginProcessing
Arg 0 is <a b>
Arg 1 is <a b>
Arg 2 is <a b>
PS> $PSNativeCommandArgumentPassing = "Standard"
PS> trace-command -PSHOST -Name ParameterBinding { testexe -echoargs $a 'a" "b' a" "b }
DEBUG: 2021-02-01 17:20:01.9829 ParameterBinding Information: 0 : BIND NAMED native application line args [/Users/james/src/github/forks/jameswtruher/PowerShell-1/test/tools/TestExe/bin/testexe]
DEBUG: 2021-02-01 17:20:01.9829 ParameterBinding Information: 0 :     BIND cmd line arg [-echoargs] to position [0]
DEBUG: 2021-02-01 17:20:01.9830 ParameterBinding Information: 0 :     BIND cmd line arg [a" "b] to position [1]
DEBUG: 2021-02-01 17:20:01.9830 ParameterBinding Information: 0 :     BIND cmd line arg [a" "b] to position [2]
DEBUG: 2021-02-01 17:20:01.9831 ParameterBinding Information: 0 :     BIND cmd line arg [a b] to position [3]
DEBUG: 2021-02-01 17:20:01.9908 ParameterBinding Information: 0 : CALLING BeginProcessing
Arg 0 is <a" "b>
Arg 1 is <a" "b>
Arg 2 is <a b>

$PSNativeCommandUseErrorActionPreference

Tato proměnná předvoleb je dostupná jenom v PowerShellu 7.3 s povolenou PSNativeCommandErrorActionPreference funkcí.

Pokud je tato funkce povolená, nativní příkazy s nenulovými ukončovacími kódy vydávají chyby podle $ErrorActionPreference toho, kdy $PSNativeCommandUseErrorActionPreference je $true.

Další informace najdete v tématu PSNativeCommandErrorActionPreference.

$PSSessionApplicationName

Určuje výchozí název aplikace pro vzdálený příkaz, který používá technologii Webové služby pro správu (WS-Management). Další informace naleznete v tématu O vzdálené správě systému Windows.

Výchozí název aplikace systému je WSMAN, ale tuto proměnnou předvoleb můžete použít ke změně výchozího nastavení.

Název aplikace je poslední uzel v identifikátoru URI připojení. Například název aplikace v následujícím ukázkovém identifikátoru URI je WSMAN.

http://Server01:8080/WSMAN

Výchozí název aplikace se používá, když vzdálený příkaz nezadává identifikátor URI připojení ani název aplikace.

Služba WinRM používá název aplikace k výběru naslouchacího procesu pro službu žádosti o připojení. Hodnota parametru by měla odpovídat hodnotě vlastnosti URLPrefix naslouchacího procesu na vzdáleném počítači.

Pokud chcete přepsat výchozí hodnotu systému a hodnotu této proměnné a vybrat jiný název aplikace pro konkrétní relaci, použijte parametry ConnectionURI nebo ApplicationNamerutiny New-PSSession, Enter-PSSession nebo Invoke-Command .

Proměnná $PSSessionApplicationName předvoleb je nastavená na místním počítači, ale určuje naslouchací proces na vzdáleném počítači. Pokud zadaný název aplikace ve vzdáleném počítači neexistuje, příkaz pro navázání relace selže.

$PSSessionConfigurationName

Určuje výchozí konfiguraci relace, která se používá pro psSessions vytvořené v aktuální relaci.

Tato proměnná předvoleb je nastavená na místním počítači, ale určuje konfiguraci relace umístěnou ve vzdáleném počítači.

Hodnota $PSSessionConfigurationName proměnné je plně kvalifikovaný identifikátor URI prostředku.

Výchozí hodnota http://schemas.microsoft.com/PowerShell/microsoft.PowerShell označuje konfiguraci relace Microsoft.PowerShellu na vzdáleném počítači.

Pokud zadáte jenom název konfigurace, předzálohuje se následující identifikátor URI schématu:

http://schemas.microsoft.com/PowerShell/

Výchozí nastavení můžete přepsat a vybrat jinou konfiguraci relace pro konkrétní relaci pomocí parametru ConfigurationName parametru New-PSSession, Enter-PSSessionnebo Invoke-Command rutin.

Hodnotu této proměnné můžete kdykoli změnit. Pokud to uděláte, nezapomeňte, že konfigurace relace, kterou vyberete, musí existovat na vzdáleném počítači. Pokud ne, příkaz pro vytvoření relace, která používá konfiguraci relace, selže.

Tato proměnná předvoleb nezodpovědí, které konfigurace místních relací se použijí, když vzdálení uživatelé vytvoří relaci, která se připojí k tomuto počítači. Pomocí oprávnění pro konfigurace místní relace ale můžete určit, kteří uživatelé je můžou používat.

$PSSessionOption

Vytvoří výchozí hodnoty pro pokročilé možnosti uživatele ve vzdálené relaci. Tyto předvolby možností přepíší výchozí hodnoty systému pro možnosti relace.

Proměnná $PSSessionOption obsahuje objekt PSSessionOption . Další informace najdete v tématu System.Management.Automation.Remoting.PSSessionOption. Každá vlastnost objektu představuje možnost relace. Například vlastnost NoCompression změní kompresi dat během relace.

Proměnná ve výchozím nastavení $PSSessionOption obsahuje objekt PSSessionOption s výchozími hodnotami pro všechny možnosti, jak je znázorněno níže.

MaximumConnectionRedirectionCount : 5
NoCompression                     : False
NoMachineProfile                  : False
ProxyAccessType                   : None
ProxyAuthentication               : Negotiate
ProxyCredential                   :
SkipCACheck                       : False
SkipCNCheck                       : False
SkipRevocationCheck               : False
OperationTimeout                  : 00:03:00
NoEncryption                      : False
UseUTF16                          : False
IncludePortInSPN                  : False
OutputBufferingMode               : None
Culture                           :
UICulture                         :
MaximumReceivedDataSizePerCommand :
MaximumReceivedObjectSize         : 209715200
ApplicationArguments              :
OpenTimeout                       : 00:03:00
CancelTimeout                     : 00:01:00
IdleTimeout                       : -00:00:00.0010000

Popisy těchto možností a další informace najdete v tématu New-PSSessionOption. Další informace o vzdálených příkazech a relacích najdete v tématu about_Remote a about_PSSessions.

Pokud chcete změnit hodnotu $PSSessionOption proměnné předvoleb, použijte New-PSSessionOption rutinu k vytvoření objektu PSSessionOption s upřednostňovanými hodnotami možností. Uložte výstup do proměnné s názvem $PSSessionOption.

$PSSessionOption = New-PSSessionOption -NoCompression

Pokud chcete použít $PSSessionOption proměnnou předvoleb v každé relaci PowerShellu, přidejte New-PSSessionOption příkaz, který vytvoří proměnnou $PSSessionOption do profilu PowerShellu. Další informace najdete v tématu about_Profiles.

Můžete nastavit vlastní možnosti pro konkrétní vzdálenou relaci. Možnosti, které nastavíte, mají přednost před výchozími hodnotami systému a hodnotou $PSSessionOption proměnné předvoleb.

Pokud chcete nastavit vlastní možnosti relace, použijte New-PSSessionOption rutinu k vytvoření objektu PSSessionOption . Pak použijte objekt PSSessionOption jako hodnotu parametru SessionOption v rutinách, které vytvářejí relaci, například New-PSSession, Enter-PSSessiona Invoke-Command.

$PSStyle

Od PowerShellu 7.2 teď máte přístup k $PSStyle automatické proměnné, abyste mohli zobrazit a změnit vykreslování výstupu řetězce ANSI. Proměnná obsahuje následující vlastnosti:

  • Reset - Vypne všechna dekorace
  • Blink – zapne Blink
  • BlinkOff – Vypne Blink
  • Tučné – zapne tučné písmo.
  • BoldOff – vypne tučné
  • Skryté – zapne se skryté
  • HiddenOff – Vypne skrytou
  • Obráceně – zapne zpětnou zpětnou
  • ReverseOff – vypne zpětnou zpětnou
  • Kurzíva – Zapne kurzívu
  • Kurzíva – Vypne kurzívu
  • Podtržení – zapne podtržení
  • Podtržení – Vypne podtržení
  • OutputRendering – Řízení při použití vykreslování výstupu
  • Pozadí – vnořený objekt pro řízení barev pozadí
  • Popředí – Vnořený objekt pro řízení barev popředí
  • Formátování – vnořený objekt, který řídí výchozí formátování výstupních datových proudů
  • Průběh – vnořený objekt, který řídí vykreslování indikátorů průběhu
  • FileInfo – (experimentální) Vnořený objekt pro řízení barev FileInfo objektů.

Základní členové vracejí řetězce řídicích sekvencí ANSI mapovaných na jejich názvy. Hodnoty jsou nastavené tak, aby umožňovaly přizpůsobení. Můžete například změnit tučné písmo na podtržené. Názvy vlastností usnadňují vytváření zdobených řetězců pomocí dokončování tabulátoru:

"$($PSStyle.Background.BrightCyan)Power$($PSStyle.Underline)$($PSStyle.Bold)Shell$($PSStyle.Reset)"

Následující členové určují, jak nebo kdy se používá formátování ANSI:

  • $PSStyle.OutputRenderingSystem.Management.Automation.OutputRendering je výčet s hodnotami:

    • ANSI: Toto je výchozí chování. ANSI se vždy předává tak, jak je.

      Důležité

      Režim ANSI byste měli použít při přesměrování výstupu na soubor nebo kanál, který má být spuštěn podřízený. Tím se zajistí, že se výstup nezmění. Použití jakéhokoli jiného režimu mění výstup odebráním řídicích sekvencí ANSI, které mohou změnit chování provádění.

    • Prostý text: Řídicí sekvence ANSI jsou vždy odstraněny, takže je to jenom prostý text.

    • Hostitel: Řídicí sekvence ANSI se odeberou v přesměrovaném nebo kanálovém výstupu.

  • $PSStyle.Foreground Členové $PSStyle.Background jsou řetězce, které obsahují řídicí sekvence ANSI pro 16 standardních barev konzoly.

    • Black
    • BrightBlack
    • White
    • BrightWhite
    • Red
    • BrightRed
    • Fialový
    • BrightMagenta
    • Blue
    • BrightBlue
    • Azurová
    • BrightCyan
    • Green
    • BrightGreen
    • Žlutý
    • BrightYellow

    Hodnoty jsou nastavené a mohou obsahovat libovolný počet řídicích sekvencí ANSI. Existuje také FromRgb() metoda pro určení 24bitové barvy. Metodu FromRgb() lze volat dvěma způsoby.

    • string FromRgb(byte red, byte green, byte blue)
    • string FromRgb(int rgb)

    V některém z následujících příkladů můžete nastavit barvu pozadí 24bitovou barvou béžové barvy.

    $PSStyle.Background.FromRgb(245, 245, 220)
    $PSStyle.Background.FromRgb(0xf5f5dc)
    
  • $PSStyle.Formatting je vnořený objekt pro řízení výchozího formátování ladění, chyb, podrobných a varovných zpráv. Můžete také řídit atributy, jako je tučné písmo a podtržení. Nahrazuje $Host.PrivateData se jako způsob správy barev pro vykreslování formátování. $Host.PrivateData nadále existuje pro zpětnou kompatibilitu, ale není připojen k $PSStyle.Formatting.

  • $PSStyle.Progress umožňuje řídit vykreslování pruhů zobrazení průběhu.

    • Styl – řetězec ANSI, který nastavuje styl vykreslování.
    • MaxWidth – nastaví maximální šířku zobrazení. Nastavte na 0 šířku konzoly. Výchozí hodnota: 120
    • Zobrazení – výčt s hodnotami Minimal a Classic. Classic je stávající vykreslování beze změn. Minimal je jeden řádek s minimálním vykreslováním. Minimal je výchozí možnost.
    • UseOSCIndicator – výchozí hodnoty .$false Nastavte tuto možnost pro $true terminály, které podporují indikátory OSC.

    Poznámka

    Pokud hostitel nepodporuje virtuální terminál, $PSStyle.Progress.View nastaví se automaticky na Classichodnotu .

    Následující příklad nastaví styl vykreslování na minimální indikátor průběhu.

    $PSStyle.Progress.View = Minimal
    

$PSStyle.FileInfo je vnořený objekt pro řízení barev FileInfo objektů.

  • Adresář – předdefinovaný člen pro určení barvy pro adresáře
  • Symbolický odkaz – Předdefinovaný člen pro určení barvy pro symbolické odkazy
  • Spustitelný soubor – předdefinovaný člen, který určuje barvu spustitelných souborů.
  • Přípona – Tento člen slouží k definování barev pro různé přípony souborů. Člen rozšíření obsahuje předpřipravená rozšíření pro archivaci a soubory PowerShellu.

Poznámka

$PSStyle.FileInfo je k dispozici pouze v PSAnsiRenderingFileInfo případech, kdy je povolená experimentální funkce. Další informace najdete v tématu about_Experimental_Features a používání experimentálních funkcí.

$Transcript

Start-Transcript Slouží k zadání názvu a umístění souboru přepisu. Pokud nezadáte hodnotu parametru Path , Start-Transcript použije cestu v hodnotě $Transcript globální proměnné. Pokud jste tuto proměnnou nevytvořili, Start-Transcript uloží se přepisy v $Home\My Documents adresáři jako \PowerShell_transcript.<time-stamp>.txt soubory.

$VerbosePreference

Určuje, jak PowerShell reaguje na podrobné zprávy generované skriptem, rutinou nebo poskytovatelem, jako jsou zprávy generované rutinou Write-Verbose . Podrobné zprávy popisují akce prováděné při spuštění příkazu.

Ve výchozím nastavení se podrobné zprávy nezobrazují, ale toto chování můžete změnit změnou hodnoty $VerbosePreference.

Proměnná $VerbosePreference přebírá jednu z možnostíActionPreference Hodnoty výčtu: SilentlyContinue, Stop, Continue, Inquire, Ignore, Suspend nebo Break.

Platné hodnoty jsou následující:

  • Stop: Zobrazí podrobnou zprávu a chybovou zprávu a pak se zastaví spuštění.
  • Inquire: Zobrazí podrobnou zprávu a pak zobrazí výzvu, která vás vyzve, jestli chcete pokračovat.
  • Pokračovat: Zobrazí podrobnou zprávu a pak pokračuje v provádění.
  • SilentlyContinue: (Výchozí) Nezobrazuje podrobnou zprávu. Pokračuje v provádění.

Pomocí podrobného běžného parametru rutiny můžete zobrazit nebo skrýt podrobné zprávy pro konkrétní příkaz. Další informace najdete v tématu about_CommonParameters.

Příklady

Tyto příklady ukazují účinek různých hodnot $VerbosePreference a podrobného parametru pro přepsání hodnoty předvoleb.

Tento příklad ukazuje efekt hodnoty SilentlyContinue , což je výchozí hodnota. Příkaz používá parametr Message , ale nezapisuje zprávu do konzoly PowerShellu.

Write-Verbose -Message "Verbose message test."

Při použití podrobného parametru se zpráva zapíše.

Write-Verbose -Message "Verbose message test." -Verbose
VERBOSE: Verbose message test.

Tento příklad ukazuje účinek hodnoty Continue . Proměnná je nastavena $VerbosePreference na Continue (Pokračovat ) a zobrazí se zpráva.

$VerbosePreference = "Continue"
Write-Verbose -Message "Verbose message test."
VERBOSE: Verbose message test.

Tento příklad používá podrobný parametr s hodnotou $false , která přepíše hodnotu Continue . Zpráva se nezobrazí.

Write-Verbose -Message "Verbose message test." -Verbose:$false

Tento příklad ukazuje účinek hodnoty Stop . Proměnná $VerbosePreference je nastavená na Zastavit a zobrazí se zpráva. Příkaz se zastaví.

$VerbosePreference = "Stop"
Write-Verbose -Message "Verbose message test."
VERBOSE: Verbose message test.
Write-Verbose : The running command stopped because the preference variable
  "VerbosePreference" or common parameter is set to Stop: Verbose message test.
At line:1 char:1
+ Write-Verbose -Message "Verbose message test."

Tento příklad používá podrobný parametr s hodnotou $false , která přepíše hodnotu Stop . Zpráva se nezobrazí.

Write-Verbose -Message "Verbose message test." -Verbose:$false

Tento příklad ukazuje účinek hodnoty Inquire . Proměnná $VerbosePreference je nastavená na Inquire. Zobrazí se zpráva a uživateli se zobrazí výzva k potvrzení.

$VerbosePreference = "Inquire"
Write-Verbose -Message "Verbose message test."
VERBOSE: Verbose message test.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):

Tento příklad používá příkazový parametr s hodnotou $false , která přepíše hodnotu Inquire . Uživatel se nezobrazí a zpráva se nezobrazí.

Write-Verbose -Message "Verbose message test." -Verbose:$false

$WarningPreference

Určuje, jak PowerShell reaguje na zprávy upozornění generované skriptem, rutinou nebo poskytovatelem, jako jsou zprávy generované rutinou Write-Warning .

Ve výchozím nastavení se zobrazují zprávy upozornění a provádění pokračuje, ale toto chování můžete změnit změnou hodnoty $WarningPreference.

Proměnná $WarningPreference přebírá jednu z možnostíActionPreference Hodnoty výčtu: SilentlyContinue, Stop, Continue, Inquire, Ignore, Suspend nebo Break.

Platné hodnoty jsou následující:

  • Stop: Zobrazí zprávu s upozorněním a chybovou zprávu a pak se zastaví spuštění.
  • Inquire: Zobrazí zprávu s upozorněním a zobrazí výzvu k pokračování oprávnění.
  • Pokračovat: (výchozí) Zobrazí zprávu s upozorněním a pak bude pokračovat v provádění.
  • TišeContinue: Nezobrazuje se zpráva upozornění. Pokračuje v provádění.

Pomocí běžného parametru WarningAction rutiny můžete určit, jak PowerShell reaguje na upozornění z konkrétního příkazu. Další informace najdete v tématu about_CommonParameters.

Příklady

Tyto příklady ukazují účinek různých hodnot $WarningPreference. Parametr WarningAction přepíše hodnotu předvolby.

Tento příklad ukazuje účinek výchozí hodnoty , Pokračovat.

$m = "This action can delete data."
Write-Warning -Message $m
WARNING: This action can delete data.

Tento příklad používá parametr WarningAction s hodnotou SilentlyContinue k potlačení upozornění. Zpráva se nezobrazí.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction SilentlyContinue

Tento příklad změní proměnnou $WarningPreference na hodnotu SilentlyContinue . Zpráva se nezobrazí.

$WarningPreference = "SilentlyContinue"
$m = "This action can delete data."
Write-Warning -Message $m

Tento příklad používá parametr WarningAction k zastavení při vygenerování upozornění.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction Stop
WARNING: This action can delete data.
Write-Warning : The running command stopped because the preference variable
  "WarningPreference" or common parameter is set to Stop:
    This action can delete data.
At line:1 char:1
+ Write-Warning -Message $m -WarningAction Stop

Tento příklad změní proměnnou $WarningPreference na hodnotu Inquire . Uživatel se zobrazí výzva k potvrzení.

$WarningPreference = "Inquire"
$m = "This action can delete data."
Write-Warning -Message $m
WARNING: This action can delete data.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):

Tento příklad používá parametr WarningAction s hodnotou SilentlyContinue. Příkaz se bude dál spouštět a nezobrazí se žádná zpráva.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction SilentlyContinue

Tento příklad změní $WarningPreference hodnotu na Zastavit.

$WarningPreference = "Stop"
$m = "This action can delete data."
Write-Warning -Message $m
WARNING: This action can delete data.
Write-Warning : The running command stopped because the preference variable
  "WarningPreference" or common parameter is set to Stop:
    This action can delete data.
At line:1 char:1
+ Write-Warning -Message $m

Tento příklad používá WarningAction s hodnotou Inquire . Uživateli se zobrazí výzva, když dojde k upozornění.

$m = "This action can delete data."
Write-Warning -Message $m -WarningAction Inquire
WARNING: This action can delete data.

Confirm
Continue with this operation?
[Y] Yes  [A] Yes to All  [H] Halt Command  [?] Help (default is "Y"):

$WhatIfPreference

Určuje, jestli je funkce WhatIf automaticky povolená pro každý příkaz, který ho podporuje. Když je funkce WhatIf povolená, rutina hlásí očekávaný účinek příkazu, ale nespustí příkaz.

Platné hodnoty jsou následující:

  • False (0, nepovoleno): (Výchozí) WhatIf není automaticky povoleno. Pokud ho chcete povolit ručně, použijte parametr WhatIf rutiny.
  • True (1, povoleno): WhatIf je automaticky povoleno u libovolného příkazu, který ho podporuje. Uživatelé můžou parametr WhatIf s hodnotou False zakázat ručně, například -WhatIf:$false.

Příklady

Tyto příklady ukazují účinek různých hodnot $WhatIfPreference. Ukazují, jak pomocí parametru WhatIf přepsat hodnotu předvolby pro konkrétní příkaz.

Tento příklad ukazuje účinek $WhatIfPreference proměnné nastavené na výchozí hodnotu False. Slouží Get-ChildItem k ověření, že soubor existuje. Remove-Item odstraní soubor. Po odstranění souboru můžete odstranění ověřit pomocí Get-ChildItempříkazu .

Get-ChildItem -Path .\test.txt
Remove-Item -Path ./test.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           9/13/2019    10:53             10 test.txt
Get-ChildItem -Path .\test.txt
Get-ChildItem : Cannot find path 'C:\Test\test.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -File test.txt

Tento příklad ukazuje účinek použití parametru WhatIf , pokud je hodnota $WhatIfPreferenceFalse.

Ověřte, že soubor existuje.

Get-ChildItem -Path .\test2.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

Pomocí parametru WhatIf určete výsledek pokusu o odstranění souboru.

Remove-Item -Path .\test2.txt -WhatIf
What if: Performing the operation "Remove File" on target "C:\Test\test2.txt".

Ověřte, že se soubor neodstranil.

Get-ChildItem -Path .\test2.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

Tento příklad ukazuje účinek $WhatIfPreference proměnné nastavené na hodnotu True. Když použijete Remove-Item k odstranění souboru, zobrazí se cesta k souboru, ale soubor se neodstraní.

Pokus o odstranění souboru Zobrazí se zpráva o tom, co se stane, když Remove-Item se spustí, ale soubor se neodstraní.

$WhatIfPreference = "True"
Remove-Item -Path .\test2.txt
What if: Performing the operation "Remove File" on target "C:\Test\test2.txt".

Slouží Get-ChildItem k ověření, že se soubor neodstranil.

Get-ChildItem -Path .\test2.txt
    Directory: C:\Test

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---           2/28/2019    17:06             12 test2.txt

Tento příklad ukazuje, jak odstranit soubor, když je hodnota $WhatIfPreferenceTrue. Používá parametr WhatIf s hodnotou .$false Slouží Get-ChildItem k ověření odstranění souboru.

Remove-Item -Path .\test2.txt -WhatIf:$false
Get-ChildItem -Path .\test2.txt
Get-ChildItem : Cannot find path 'C:\Test\test2.txt' because it does not exist.
At line:1 char:1
+ Get-ChildItem -Path .\test2.txt

Tady jsou příklady Get-Process rutiny, která nepodporuje WhatIf a Stop-Process která podporuje WhatIf. Hodnota $WhatIfPreference proměnné je True.

Get-Process nepodporuje WhatIf. Po spuštění příkazu se zobrazí proces Winword .

Get-Process -Name Winword
 NPM(K)    PM(M)      WS(M)     CPU(s)      Id  SI ProcessName
 ------    -----      -----     ------      --  -- -----------
    130   119.84     173.38       8.39   15024   4 WINWORD

Stop-Process podporuje WhatIf. Proces Winword není zastavený.

Stop-Process -Name Winword
What if: Performing the operation "Stop-Process" on target "WINWORD (15024)".

Chování Stop-ProcessWhatIf můžete přepsat pomocí parametru WhatIf s hodnotou .$false Proces Winword se zastaví.

Stop-Process -Name Winword -WhatIf:$false

Chcete-li ověřit, že byl proces Winword zastaven, použijte Get-Process.

Get-Process -Name Winword
Get-Process : Cannot find a process with the name "Winword".
  Verify the process name and call the cmdlet again.
At line:1 char:1
+ Get-Process -Name Winword

Viz také