o_obecných_Parametrech

Krátký popis

Popisuje parametry, které lze použít s libovolnou rutinou.

Dlouhý popis

Běžné parametry jsou sada parametrů rutiny, které můžete použít s libovolnou rutinou. Implementují se v PowerShellu, ne vývojáři rutin a jsou automaticky dostupné pro libovolnou rutinu.

Běžné parametry můžete použít s libovolnou rutinou, ale nemusí mít vliv na všechny rutiny. Pokud například rutina negeneruje žádný podrobný výstup, použití Verbose společného parametru nemá žádný vliv.

Běžné parametry jsou k dispozici také u pokročilých funkcí, které používají atribut CmdletBinding nebo atribut Parameter. Při použití těchto atributů PowerShell automaticky přidá společné parametry. Nemůžete vytvořit žádné parametry, které používají stejné názvy jako společné parametry.

Několik běžných parametrů přepisuje výchozí hodnoty systému nebo předvolby, které jste nastavili pomocí proměnných předvoleb PowerShellu. Na rozdíl od proměnných předvoleb mají společné parametry vliv jenom na příkazy, ve kterých se používají.

Další informace najdete v tématu about_Preference_Variables.

Následující seznam zobrazuje společné parametry. Jejich aliasy jsou uvedeny v závorkách.

• Debug (db)
• ErrorAction (ea)
• ErrorVariable (ev)
• InformationAction (infa)
• InformationVariable (iv)
• OutVariable (ov)
• OutBuffer (ob)
• PipelineVariable (pv)
• ProgressAction (proga)
• Verbose (vb)
• WarningAction (wa)
• WarningVariable (wv)

Parametry akce jsou ActionPreference hodnoty typu. ActionPreference je výčet s následujícími hodnotami:

Jméno	Hodnota
Break	6
Suspend	5
Ignore	4
Inquire	3
Continue	2
Stop	1
SilentlyContinue	0

Název nebo hodnotu můžete použít s parametrem.

Kroměběžnýchch Rutiny, které zahrnují riziko pro systém nebo uživatelská data, obvykle nabízejí tyto parametry.

Parametry zmírnění rizik jsou:

• WhatIf (wi)
• Confirm (cf)

Společné parametry

-Debug

Zobrazí podrobnosti na úrovni programátora o operaci provedené příkazem. Tento parametr funguje pouze v případě, že příkaz vygeneruje zprávu ladění. Tento parametr například funguje, když příkaz obsahuje rutinu Write-Debug.

Type: SwitchParameter
Aliases: db
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Ve výchozím nastavení se zprávy ladění nezobrazují, protože hodnota $DebugPreference proměnné je SilentlyContinue.

Parametr Debug přepíše hodnotu $DebugPreference proměnné pro aktuální příkaz a nastaví hodnotu $DebugPreference na Continuehodnotu .

-Debug:$true má stejný účinek jako -Debug. Slouží -Debug:$false k potlačení zobrazení zpráv ladění, pokud $DebugPreference není SilentlyContinue, což je výchozí hodnota.

-ErrorAction

Určuje, jak rutina reaguje na neukončující chybu z příkazu. Tento parametr funguje pouze v případě, že příkaz vygeneruje neukončující chybu, například v rutině Write-Error.

Type: ActionPreference
Aliases: ea
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Parametr ErrorAction přepíše hodnotu proměnné $ErrorActionPreference pro aktuální příkaz. Vzhledem k tomu, že výchozí hodnota $ErrorActionPreference proměnné je Continue, zobrazí se chybové zprávy a provádění bude pokračovat, pokud parametr nepoužijete ErrorAction .

Parametr ErrorAction nemá žádný vliv na ukončení chyb (například chybějící data, parametry, které nejsou platné nebo nedostatečná oprávnění), které brání úspěšnému dokončení příkazu.

• Break Zadá ladicí program, když dojde k chybě nebo dojde k výjimce.
• Continue zobrazí chybovou zprávu a pokračuje v provádění příkazu. Continue je výchozí.
• Ignore potlačí chybovou zprávu a pokračuje v provádění příkazu. Na rozdíl od SilentlyContinuefunkce Ignore nepřidá chybovou $Error zprávu do automatické proměnné. Hodnota Ignore se zavádí v PowerShellu 3.0.
• Inquire zobrazí chybovou zprávu a před pokračováním v provádění vás vyzve k potvrzení. Tato hodnota se používá zřídka.
• SilentlyContinue potlačí chybovou zprávu a pokračuje v provádění příkazu.
• Stop zobrazí chybovou zprávu a ukončí provádění příkazu.
• Suspend je k dispozici pouze pro pracovní postupy, které nejsou v PowerShellu 6 a novějších podporovaných.

Poznámka

Parametr ErrorAction přepíše, ale nenahrazuje hodnotu $ErrorActionPreference proměnné, pokud se parametr použije v příkazu ke spuštění skriptu nebo funkce.

-ErrorVariable

Chybové záznamy se automaticky ukládají do $Error automatické proměnné. Další informace najdete v tématu about_Automatic_Variables.

Při použití parametru ErrorVariable v příkazu uloží PowerShell také záznamy chyb generované příkazem v proměnné určené parametrem.

Type: String
Aliases: ev
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Ve výchozím nastavení nové chybové zprávy přepíší chybové zprávy, které jsou již uloženy v proměnné. Pokud chcete k obsahu proměnné připojit chybovou zprávu, před název proměnné vložte znaménko plus (+).

Například následující příkaz vytvoří proměnnou $a a uloží do ní všechny chyby:

Get-Process -Id 6 -ErrorVariable a

Následující příkaz přidá do proměnné $a všechny chybové zprávy:

Get-Process -Id 2 -ErrorVariable +a

Následující příkaz zobrazí obsah $a:

$a

Tento parametr můžete použít k vytvoření proměnné, která obsahuje pouze chybové zprávy z konkrétních příkazů a nemá vliv na chování $Error automatické proměnné. Automatická proměnná $Error obsahuje chybové zprávy ze všech příkazů v relaci. K odkazování na konkrétní chyby uložené v proměnných můžete použít zápis pole, například $a[0] nebo $Error[1,2].

Poznámka

Vlastní proměnná chyby obsahuje všechny chyby vygenerované příkazem, včetně chyb z volání vnořených funkcí nebo skriptů.

-InformationAction

Představeno v PowerShellu 5.0. V rámci příkazu nebo skriptu, ve kterém se používá, InformationAction přepíše společný parametr hodnotu $InformationPreference proměnné předvolby, která je ve výchozím nastavení nastavena na SilentlyContinue. Při použití Write-Information ve skriptu se InformationActionWrite-Information zobrazí hodnoty v závislosti na hodnotě parametruInformationAction. Další informace najdete v $InformationPreferencetématu about_Preference_Variables.

Type: ActionPreference
Aliases: infa
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

• Break Zadá ladicí program při výskytu příkazu Write-Information.
• Stop zastaví příkaz nebo skript na výskytu příkazu Write-Information.
• Ignore potlačí informační zprávu a pokračuje ve spuštění příkazu. Na rozdíl od SilentlyContinue, Ignore zcela zapomene informační zprávu; nepřidá informační zprávu do informačního datového proudu.
• Inquire zobrazí informační zprávu, kterou zadáte v příkazu Write-Information, a pak se zeptá, jestli chcete pokračovat.
• Continue zobrazí informační zprávu a pokračuje ve spuštění.
• Suspend se v PowerShellu 6 a novějším nepodporuje, protože je k dispozici jenom pro pracovní postupy.
• SilentlyContinue žádný vliv, protože informační zpráva se nezobrazuje (výchozí) a skript pokračuje bez přerušení.

Poznámka

Parametr InformationAction přepíše, ale nenahrazuje hodnotu $InformationAction proměnné předvolby, pokud se parametr používá v příkazu ke spuštění skriptu nebo funkce.

-InformationVariable

Představeno v PowerShellu 5.0. Při použití běžného parametru InformationVariable jsou informační záznamy uloženy v proměnné určené parametrem. Rutina PowerShellu může do datového Information proudu zapisovat záznamy informací. K zápisu informačních záznamů můžete použít také rutinu Write-Information.

Informační záznamy se ve výchozím nastavení zobrazují jako zprávy v konzole. Zobrazení záznamu informací můžete řídit pomocí společného parametru InformationAction . Chování můžete změnit také pomocí proměnné předvoleb $InformationPreference. Další informace najdete v $InformationPreferencetématu about_Preference_Variables.

Poznámka

Informační proměnná obsahuje všechny informační zprávy generované příkazem, včetně informačních zpráv z volání vnořených funkcí nebo skriptů.

Type: String
Aliases: iv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Ve výchozím nastavení nový záznam informací přepíše hodnoty, které jsou již uloženy v proměnné. Pokud chcete k obsahu proměnné připojit chybovou zprávu, před název proměnné vložte znaménko plus (+).

-OutBuffer

Určuje počet objektů, které se mají nahromadět ve vyrovnávací paměti před odesláním jakýchkoli objektů prostřednictvím kanálu. Pokud tento parametr vynecháte, objekty se posílají při jejich vygenerování.

Type: Int32
Aliases: ob
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Tento parametr správy prostředků je určený pro pokročilé uživatele. Pokud použijete tento parametr, PowerShell odešle data do další rutiny v dávkách OutBuffer + 1.

Následující příklad se liší mezi bloky procesu ForEach-Object, které používají rutinu Write-Host. Alternativy zobrazení v dávkách 2 nebo OutBuffer + 1.

1..4 | ForEach-Object {
        Write-Host "$($_): First"; $_
      } -OutBuffer 1 | ForEach-Object {
                        Write-Host "$($_): Second" }

1: First
2: First
1: Second
2: Second
3: First
4: First
3: Second
4: Second

-OutVariable

Ukládá výstupní objekty z příkazu do zadané proměnné kromě odesílání výstupu v kanálu.

Type: String
Aliases: ov
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Pokud chcete přidat výstup do proměnné, místo nahrazení jakéhokoli výstupu, který by tam již mohl být uložen, zadejte před název proměnné znaménko plus (+).

Například následující příkaz vytvoří proměnnou $out a uloží do ní objekt procesu:

Get-Process powershell -OutVariable out

Následující příkaz přidá objekt procesu do proměnné $out:

Get-Process iexplore -OutVariable +out

Následující příkaz zobrazí obsah proměnné $out:

$out

Poznámka

Proměnná vytvořená parametrem OutVariable je .[System.Collections.ArrayList]

-PipelineVariable

PipelineVariable umožňuje přístup k nejnovější hodnotě předané do dalšího segmentu kanálu příkazem, který používá tento parametr. Jakýkoli příkaz v kanálu má přístup k hodnotě pomocí pojmenovaného PipelineVariable. Hodnota se přiřadí proměnné, když se předá do dalšího segmentu kanálu. To usnadňuje PipelineVariable použití než konkrétní dočasná proměnná, která může být potřeba přiřadit ve více umístěních.

Na rozdíl od $_ příkazu nebo $PSItempoužití PipelineVariable příkazu pro kanál umožňuje přístup k hodnotám kanálu předanými (a uloženými) jinými příkazy než bezprostředně předchozím příkazem. Příkazy kanálu mají přístup k poslední hodnotě předané při zpracování další položky procházející kanálem. To umožňuje příkazu jeho výstupu do předchozího příkazu (nebo samotného).

Poznámka

Pokročilé funkce mohou mít až tři bloky skriptů: begin, processa end. Při použití parametru PipelineVariable s pokročilými funkcemi se proměnné přiřazují při spuštění funkce pouze hodnoty z prvního definovaného skriptu. Další informace naleznete v tématu Pokročilé funkce. PowerShell 7.2 toto chování opraví.

Type: String
Aliases: pv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Platné hodnoty jsou řetězce, stejné jako u názvů proměnných.

Opatrnost

Rozsah PipelineVariable je vymezen na kanál, ve kterém je vyvolán. Proměnné mimo kanál, které používají stejný název, se před spuštěním kanálu vymažou. Po PipelineVariable ukončení kanálu dojde k výpadku rozsahu. Pokud několik příkazů v rámci kanálu určuje stejné PipelineVariable , existuje pouze jedna sdílená proměnná. Tato proměnná se aktualizuje nejnovějším výstupem kanálu z příkazu, který tuto proměnnou určuje.

Některé blokující příkazy shromažďují všechny položky kanálu před vytvořením jakéhokoli výstupu, například Sort-ObjectSelect-Object -Last. Všechny PipelineVariable přiřazené v příkazu před takovým blokovacím příkazem vždy obsahují konečnou položku kanálu z předchozího příkazu, pokud se použije v příkazu za příkazem blokování.

Následující příklad ukazuje, jak funguje PipelineVariable . V tomto příkladu se pět čísel předá do prvního ForEach-Object příkazu. Každá položka v kanálu je uložena v proměnné kanálu s názvem $Temp.

Blok Process prvního ForEach-Object příkazu předá položku kanálu do podřízeného ForEach-Object příkazu. Stav proměnných se zobrazí v každém kroku.

# Create a variable named $Temp
$Temp = 8
Get-Variable Temp | Format-Table

$InformationPreference = 'Continue'
Write-Information '-------------------------------------------------'
111,222,333,444,555 | ForEach-Object -PipelineVariable Temp -Begin {

  # Note that the newly create $Temp variable doesn't contain the value 8
  # assigned before the pipeline started and that $PSItem is empty in
  # the Begin block.
  Write-Information "Upstream (Begin):   PSItem = '$PSItem', Temp = '$Temp'"

} -Process {

  Write-Information "Upstream (Process): PSItem = '$PSItem', Temp = '$Temp'"
  return $PSItem

} | ForEach-Object -Process {

  Write-Information "`tDownstream: PSItem = '$PSItem', Temp = '$Temp'"

}
Write-Information '-------------------------------------------------'

# The $Temp variable is deleted when the pipeline finishes
Get-Variable Temp | Format-Table

Name                           Value
----                           -----
Temp                           8

-------------------------------------------------
Upstream (Begin):   PSItem = '', Temp = ''
Upstream (Process): PSItem = '111', Temp = ''
        Downstream: PSItem = '111', Temp = '111'
Upstream (Process): PSItem = '222', Temp = '111'
        Downstream: PSItem = '222', Temp = '222'
Upstream (Process): PSItem = '333', Temp = '222'
        Downstream: PSItem = '333', Temp = '333'
Upstream (Process): PSItem = '444', Temp = '333'
        Downstream: PSItem = '444', Temp = '444'
Upstream (Process): PSItem = '555', Temp = '444'
        Downstream: PSItem = '555', Temp = '555'
-------------------------------------------------

Name                           Value
----                           -----
Temp

Opatrnost

Existují dva známé problémy s používáním parametru PipelineVariable v kanálu, který zahrnuje rutiny CimCmdlets nebo CDXML. V následujících příkladech Get-Partition je funkce CDXML a Get-CimInstance je CimCmdlet.

Problém 1: Funkce CDXML používají [CmdletBinding()], což umožňuje PipelineVariable parametr.

Get-Partition -pv pvar

Při použití PipelineVariable v prostředí Windows PowerShell v5.1 se však zobrazí následující chyba.

Get-Partition : Cannot retrieve the dynamic parameters for the cmdlet.
Object reference not set to an instance of an object.

At line:1 char:1
+ get-partition -PipelineVariable pvar
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidArgument: (:) [Get-Partition], ParameterBindingException
    + FullyQualifiedErrorId : GetDynamicParametersException,Get-Partition

Problém 2: Pokud předchozí příkaz není příkaz CDXML a podřízený obsahuje některý z typů příkazů, PipelineVariable zůstává jako poslední kumulovaný objekt.

Get-CimInstance Win32_DiskDrive -pv pvar |
    ForEach-Object {
        Write-Host "Upstream: Disk $($pvar.Index)"
        return [pscustomobject]@{ DiskNumber = $_.Index }
    } | Get-Partition | ForEach-Object {
        Write-Host "Downstream: Disk $($pvar.Index)"
    }

Všimněte si, že hodnota nastavená $pvar na poslední objekt v kanálu pro druhý ForEach-Object příkaz.

Upstream: Disk 1
Upstream: Disk 2
Upstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0
Downstream: Disk 0

-ProgressAction

Určuje, jak PowerShell reaguje na aktualizace průběhu 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. Parametr ProgressAction byl přidán v PowerShellu 7.4.

Parametr ProgressAction přebírá jednu z hodnot výčtu ActionPreference : SilentlyContinue, Stop, Continue, Inquire, Ignore, , , Suspend, nebo Break.

Platné hodnoty jsou následující:

• Break Zadá ladicí program při výskytu příkazu Write-Progress.
• Stop: Nezobrazuje indikátor průběhu. Místo toho zobrazí chybovou zprávu a přestane se s ní provádět.
• Inquire: Nezobrazuje indikátor průběhu. Zobrazí výzvu k pokračování oprávnění. Pokud odpovíte pomocí Y nebo A, zobrazí se indikátor průběhu.
• Continue: (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.

Type: ActionPreference
Aliases: proga
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

-Verbose

Zobrazí podrobné informace o operaci provedené příkazem. Tyto informace se podobají informacím v trasování nebo v transakčním protokolu. Tento parametr funguje pouze v případě, že příkaz vygeneruje podrobnou zprávu. Tento parametr například funguje, když příkaz obsahuje rutinu Write-Verbose.

Type: SwitchParameter
Aliases: vb
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Parametr Verbose přepíše hodnotu proměnné $VerbosePreference pro aktuální příkaz. Vzhledem k tomu, že výchozí hodnota $VerbosePreference proměnné je SilentlyContinue, podrobné zprávy se ve výchozím nastavení nezobrazují.

• -Verbose:$true má stejný účinek jako -Verbose
• -Verbose:$false potlačí zobrazení podrobných zpráv. Tento parametr použijte, $VerbosePreference pokud hodnota není SilentlyContinue (výchozí).

-WarningAction

Určuje, jak rutina reaguje na upozornění z příkazu. Continue je výchozí hodnota. Tento parametr funguje pouze v případě, že příkaz vygeneruje zprávu s upozorněním. Tento parametr například funguje, když příkaz obsahuje rutinu Write-Warning.

Type: ActionPreference
Aliases: wa
Accepted values: Break, Suspend, Ignore, Inquire, Continue, Stop, SilentlyContinue
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Parametr WarningAction přepíše hodnotu proměnné $WarningPreference pro aktuální příkaz. Vzhledem k tomu, že výchozí hodnota $WarningPreference proměnné je Continue, zobrazí se upozornění a provádění bude pokračovat, pokud tento parametr nepoužijete WarningAction .

• Break při výskytu upozornění zadá ladicí program.
• Continue zobrazí zprávy upozornění a pokračuje v provádění příkazu. Continue je výchozí.
• Inquire zobrazí zprávu s upozorněním a před pokračováním v provádění vás vyzve k potvrzení. Tato hodnota se používá zřídka.
• SilentlyContinue potlačí zprávu upozornění a pokračuje v provádění příkazu.
• Stop zobrazí zprávu s upozorněním a přestane příkaz spustit.

Poznámka

Parametr WarningAction přepíše, ale nenahrazuje hodnotu $WarningAction proměnné předvolby, pokud se parametr používá v příkazu ke spuštění skriptu nebo funkce.

-WarningVariable

Ukládá záznamy upozornění o příkazu v zadané proměnné.

Type: String
Aliases: wv
Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Všechna vygenerovaná upozornění se ukládají do proměnné, i když se upozornění uživateli nezobrazí.

Pokud chcete přidat upozornění k obsahu proměnné, místo nahrazení všech upozornění, která by tam již mohla být uložena, zadejte před název proměnné znaménko plus (+).

Například následující příkaz vytvoří proměnnou $a a uloží do ní všechna upozornění:

Get-Process -Id 6 -WarningVariable a

Následující příkaz přidá do proměnné $a upozornění:

Get-Process -Id 2 -WarningVariable +a

Následující příkaz zobrazí obsah $a:

$a

Tento parametr můžete použít k vytvoření proměnné, která obsahuje pouze upozornění z konkrétních příkazů. K odkazování na konkrétní upozornění uložená v proměnné můžete použít zápis pole, například $a[0] nebo $warning[1,2].

Poznámka

Proměnná upozornění obsahuje všechna upozornění vygenerovaná příkazem, včetně upozornění z volání vnořených funkcí nebo skriptů.

Parametry řízení rizik

-WhatIf

Zobrazí zprávu, která popisuje účinek příkazu místo spuštění příkazu.

Type: SwitchParameter
Aliases: wi
Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Parametr WhatIf přepíše hodnotu proměnné $WhatIfPreference pro aktuální příkaz. Vzhledem k tomu, že výchozí hodnota $WhatIfPreference proměnné je 0 (zakázáno), WhatIf chování se neprovede bez parametru WhatIf . Další informace najdete v tématu about_Preference_Variables.

• $true má stejný účinek jako -WhatIf.
• $false potlačuje automatické WhatIf chování, které vede k tomu, že hodnota $WhatIfPreference proměnné je 1.

Například následující příkaz používá parametr -WhatIf v příkazu Remove-Item:

Remove-Item Date.csv -WhatIf

Místo odebrání položky PowerShell zobrazí seznam operací, které by udělal, a položek, které by to ovlivnilo. Tento příkaz vytvoří následující výstup:

What if: Performing operation "Remove File" on
Target "C:\ps-test\date.csv".

-Confirm

Před provedením příkazu vás vyzve k potvrzení.

Type: SwitchParameter
Aliases: cf
Required: False
Position: Named
Default value: Depends on preference variable
Accept pipeline input: False
Accept wildcard characters: False

Parametr Confirm přepíše hodnotu proměnné $ConfirmPreference pro aktuální příkaz. Výchozí hodnota je true. Další informace najdete v tématu about_Preference_Variables.

• $true má stejný účinek jako -Confirm.
• $false potlačí automatické potvrzení, ke kterému dochází, když je hodnota $ConfirmPreference menší nebo rovna odhadovanému riziku rutiny.

Například následující příkaz používá parametr Confirm s příkazem Remove-Item. Před odebráním položky PowerShell zobrazí seznam operací, které by udělal, a položek, které by to ovlivnilo, a požádal o schválení.

PS C:\ps-test> Remove-Item tmp*.txt -Confirm

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

Možnosti odpovědi Confirm jsou následující:

Odpověď	Výsledek
Yes (Y)	Proveďte akci.
Yes to All (A)	Provedení všech akcí a potlačení následných Confirm
	dotazy pro tento příkaz.
No (N):	Tuto akci neprovádějte.
No to All (L):	Neprovádějte žádné akce a potlačit následné akce.
	Confirm dotazy pro tento příkaz.
Suspend (S):	Pozastavte příkaz a vytvořte dočasnou relaci.
Help (?)	Zobrazit nápovědu k těmto možnostem

Možnost Suspend umístí příkaz do blokování a vytvoří dočasnou vnořenou relaci, ve které můžete pracovat, dokud nebudete připraveni zvolit Confirm možnost. Příkazový řádek pro vnořenou relaci obsahuje dvě nadbytečné nářezy (>>), které indikují, že se jedná o podřízenou operaci původního nadřazeného příkazu. Vnořené relaci můžete spouštět příkazy a skripty. Pokud chcete ukončit vnořenou relaci a vrátit se k Confirm možnostem původního příkazu, zadejte "exit".

V následujícím příkladu Suspend se možnost (S) používá k dočasnému zastavení příkazu, zatímco uživatel zkontroluje nápovědu k parametru příkazu. Po získání potřebných informací uživatel zadá příkaz "exit" pro ukončení vnořené výzvy a pak vybere odpověď Ano (y) na dotaz Confirm.

PS C:\ps-test> New-Item -ItemType File -Name Test.txt -Confirm

Confirm
Are you sure you want to perform this action?

Performing operation "Create File" on Target "Destination:
C:\ps-test\test.txt".
[Y] Yes [A] Yes to All [N] No [L] No to All [S] Suspend [?] Help (default
is "Y"): s

PS C:\ps-test> Get-Help New-Item -Parameter ItemType

-ItemType <string>
Specifies the provider-specified type of the new item.

Required?                    false
Position?                    named
Default value
Accept pipeline input?       true (ByPropertyName)
Accept wildcard characters?  false

PS C:\ps-test> exit

Confirm
Are you sure you want to perform this action?
Performing operation "Create File" on Target "Destination: C:\ps-test\test
.txt".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (defau
lt is "Y"): y

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
-a---         8/27/2010   2:41 PM          0 test.txt

Viz také

• o_Preferenčních_Proměnných
• Write-Debug
• Write-Error
• Write-Verbose
• Write-Warning