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í CmdletBinding atribut nebo Parameter atribut. 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	0
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)

Běž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 (Chybová akce)

Určuje, jak rutina reaguje na neukončující chybu z příkazu. Tento parametr funguje jenom v případě, že příkaz vygeneruje neukončující chybu, například chybu z rutiny 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 $ErrorActionPreference proměnné 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í možnost.
• Ignore potlačuje 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čuje chybovou zprávu a pokračuje v provádění příkazu.
• Stop zobrazí chybovou zprávu a zastaví spuštění příkazu.
• Suspend je k dispozici pouze pro pracovní postupy, které nejsou podporované v PowerShellu 6 a novějších verzí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.

-ChybováProměnná

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 $a proměnné 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á $Error proměnná obsahuje chybové zprávy ze všech příkazů v relaci. Maticový zápis můžete použít, například $a[0] odkazovat $Error[1,2] na konkrétní chyby uložené v proměnných.

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ů.

-Informační akce

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 Write-Information příkazu.
• Stop zastaví příkaz nebo skript v výskytu Write-Information příkazu.
• Ignore potlačuje 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 Write-Information příkazu, a pak se zeptá, jestli chcete pokračovat.
• Continue zobrazí informační zprávu a pokračuje ve spuštění.
• Suspend PowerShell 6 a vyšší nepodporuje, protože je k dispozici jenom pro pracovní postupy.
• SilentlyContinue Nezobrazují se žádné efekty, protože informační zpráva není zobrazená (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.

-InformačníProměnná

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í. Rutinu můžete použít také k zápisu Write-Information informačních záznamů.

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 také změnit pomocí $InformationPreference proměnné předvoleb. 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 (Odchozí) vyrovnávací paměť

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. Když použijete tento parametr, PowerShell odešle data do další rutiny v dávkách OutBuffer + 1.

Následující příklad alternativy se zobrazí mezi ForEach-Object procesem bloků, 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 mohl být již 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ží objekt procesu do něj:

Get-Process powershell -OutVariable out

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

Get-Process iexplore -OutVariable +out

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

$out

Poznámka:

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

-Proměnná potrubí

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 nasílnout zpět svůj výstup do předchozího příkazu (nebo samotného).

Poznámka:

Pokročilé funkce mohou mít až tři bloky skriptu: begin, processa end. Při použití parametru PipelineVariable s pokročilými funkcemi se proměnné při spuštění funkce přiřadí pouze hodnoty z prvního definovaného bloku 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.

Upozornění

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

Upozornění

Existují dva známé problémy s používáním parametru PipelineVariable v kanálu, který obsahuje 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 parametr PipelineVariable .

Get-Partition -pv pvar

Při použití PipelineVariable v prostředí Windows PowerShell verze 5.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ů, zůstane PipelineVariable 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

-Pokroková akce

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 Write-Progress příkazu.
• 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 $VerbosePreference proměnné 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í).

-Výstražná akce

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 $WarningPreference proměnné 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 zadá ladicí program, když dojde k upozornění.
• Continue zobrazí zprávy s upozorněním a pokračuje v provádění příkazu. Continue je výchozí možnost.
• 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čuje zprávu upozornění a pokračuje v provádění příkazu.
• Stop zobrazí zprávu s upozorněním a ukončí provádění příkazu.

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.

-VýstražnáProměnná

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 upozornění připojit 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é všechna upozornění $a :

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ů. Zápis pole, například $a[0] nebo $warning[1,2] odkaz na konkrétní upozornění uložená v proměnné, můžete použít.

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 $WhatIfPreference proměnné 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é chování WhatIf, které má za následek, když je hodnota $WhatIfPreference proměnné 1.

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

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 $ConfirmPreference proměnné 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á Confirm parametr 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 Confirm odpovědi jsou následující:

Odezva	Výsledek
Yes (Y)	Proveďte akci.
Yes to All (A)	Provedení všech akcí a potlačení následných akcí 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é karety (>>), 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 Confirm dotaz.

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