about_CommonParameters

Rövid leírás

A parancsmagokkal használható paramétereket ismerteti.

Hosszú leírás

A gyakori paraméterek olyan parancsmagparaméterek, amelyeket bármely parancsmaggal használhat. Ezeket a PowerShell implementálja, nem a parancsmag fejlesztője, és automatikusan elérhetővé válnak bármely parancsmag számára.

A gyakori paramétereket bármely parancsmaggal használhatja, de előfordulhat, hogy ezek nem minden parancsmagra hatással vannak. Ha például egy parancsmag nem hoz létre kimenetet verbose , a Verbose közös paraméter használata nincs hatással.

A gyakori paraméterek olyan speciális függvényeken is elérhetők, amelyek az attribútumot vagy az CmdletBinding Parameter attribútumot használják. Ha ezeket az attribútumokat használja, a PowerShell automatikusan hozzáadja a gyakori paramétereket. Nem hozhat létre olyan paramétereket, amelyek ugyanazokat a neveket használják, mint a Common Parameters.

Számos gyakori paraméter felülbírálja a rendszer alapértelmezett beállításait vagy a PowerShell beállítási változóinak használatával beállított beállításokat. A beállítási változókkal ellentétben a gyakori paraméterek csak azokat a parancsokat érintik, amelyekben használják őket.

További információ: about_Preference_Variables.

Az alábbi lista a gyakori paramétereket jeleníti meg. Az aliasok zárójelben vannak felsorolva.

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

A műveleti paraméterek ActionPreference típusú értékek. Az ActionPreference egy enumerálás a következő értékekkel:

Név szerint	Érték
Break	6
Suspend	5
Ignore	4
Inquire	3
Continue	2
Stop	0
SilentlyContinue	0

Használhatja a nevet vagy az értéket a paraméterrel.

A gyakori paraméterek mellett számos parancsmag kínál kockázatcsökkentési paramétereket. A rendszer vagy a felhasználói adatok kockázatával járó parancsmagok általában ezeket a paramétereket kínálják.

A kockázatcsökkentési paraméterek a következők:

• WhatIf (wi)
• Confirm (cf)

Gyakori paraméterleírások

-Debug

A parancs által végrehajtott művelet programozói szintű részleteit jeleníti meg. Ez a paraméter csak akkor működik, ha a parancs hibakeresési üzenetet hoz létre. Ez a paraméter például akkor működik, ha egy parancs tartalmazza a Write-Debug parancsmagot.

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

Alapértelmezés szerint a hibakeresési üzenetek nem jelennek meg, mert a $DebugPreference változó értéke SilentlyContinue.

A Debug paraméter felülbírálja az $DebugPreference aktuális parancs változójának értékét, és a Continue (Folytatás) értéket állítja $DebugPreference be.

-Debug:$true hatása megegyezik -Debuga . A hibakeresési üzenetek megjelenítésének letiltására használható -Debug:$false , ha $DebugPreference nem a SilentlyContinue az alapértelmezett.

-ErrorAction

Meghatározza, hogy a parancsmag hogyan reagál a parancs nem végződő hibájára. Ez a paraméter csak akkor működik, ha a parancs nem végződő hibát okoz, például a Write-Error parancsmagból származókat.

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

Az ErrorAction paraméter felülbírálja az $ErrorActionPreference aktuális parancs változójának értékét. Mivel a változó alapértelmezett értéke a $ErrorActionPreference Folytatás, hibaüzenetek jelennek meg, és a végrehajtás folytatódik, hacsak nem használja az ErrorAction paramétert.

Az ErrorAction paraméternek nincs hatása olyan hibák (például hiányzó adatok, érvénytelen paraméterek vagy nem megfelelő engedélyek) megszüntetésére, amelyek megakadályozzák a parancsok sikeres végrehajtását.

• Break Hiba vagy kivétel felmerülésekor adja meg a hibakeresőt.
• Continue megjeleníti a hibaüzenetet, és folytatja a parancs végrehajtását. A Continue az alapértelmezett formátum.
• Ignore letiltja a hibaüzenetet, és folytatja a parancs végrehajtását. A SilentlyContinue-kel ellentétben az Ignore nem adja hozzá a hibaüzenetet az $Error automatikus változóhoz. A Kihagyás érték a PowerShell 3.0-ban lesz bevezetve.
• Inquire megjeleníti a hibaüzenetet, és megerősítést kér a végrehajtás folytatása előtt. Ezt az értéket ritkán használják.
• SilentlyContinue letiltja a hibaüzenetet, és folytatja a parancs végrehajtását.
• Stop megjeleníti a hibaüzenetet, és leállítja a parancs végrehajtását.
• Suspend csak olyan munkafolyamatokhoz érhető el, amelyek nem támogatottak a PowerShell 6-ban és azon túl.

Feljegyzés

Az ErrorAction paraméter felülbírálja, de nem helyettesíti a $ErrorActionPreference változó értékét, ha a paramétert parancsban használják szkript vagy függvény futtatásához.

-ErrorVariable

A hibarekordok automatikusan az $Error automatikus változóban lesznek tárolva. További információ: about_Automatic_Variables.

Ha az ErrorVariable paramétert egy parancson használja, a PowerShell a parancs által kibocsátott hibarekordokat is tárolja a paraméter által megadott változóban.

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

Alapértelmezés szerint az új hibaüzenetek felülírják a változóban már tárolt hibaüzeneteket. Ha hozzá szeretné fűzni a hibaüzenetet a változó tartalmához, tegyen egy pluszjelet (+) a változó neve elé.

A következő parancs például létrehozza a változót $a , majd tárolja benne a hibákat:

Get-Process -Id 6 -ErrorVariable a

A következő parancs minden hibaüzenetet hozzáad a $a változóhoz:

Get-Process -Id 2 -ErrorVariable +a

A következő parancs a következő tartalommal jelenik meg $a:

$a

Ezzel a paraméterrel olyan változót hozhat létre, amely csak adott parancsokból származó hibaüzeneteket tartalmaz, és nem befolyásolja az $Error automatikus változó viselkedését. Az $Error automatikus változó a munkamenet összes parancsából tartalmaz hibaüzeneteket. A tömb jelölését használhatja, például $a[0] $error[1,2] hivatkozhat a változókban tárolt konkrét hibákra.

Feljegyzés

Az egyéni hibaváltozó tartalmazza a parancs által generált összes hibát, beleértve a beágyazott függvényekbe vagy szkriptekbe irányuló hívások hibáit is.

-InformationAction

A PowerShell 5.0-ban bevezetett. Az InformationAction common paraméter felülbírálja a beállítási változó értékét $InformationPreference a parancson vagy szkripten belül, amely alapértelmezés szerint SilentlyContinue értékre van állítva. Amikor InformationAction-parancsprogramban használja, Write-Information az Értékek az InformationAction paraméter értékétől függően jelennek Write-Information meg. További információ: $InformationPreferenceabout_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 A parancs előfordulásakor adja meg a hibakeresőt Write-Information .
• Stop parancs vagy szkript leállítása a Write-Information parancs előfordulásakor.
• Ignore letiltja az információs üzenetet, és folytatja a parancs futtatását. A SilentlyContinue-kel ellentétben az Ignore teljesen elfelejti az információs üzenetet; nem adja hozzá az információs üzenetet az információs adatfolyamhoz.
• Inquire megjeleníti a parancsban Write-Information megadott tájékoztató üzenetet, majd megkérdezi, hogy folytatja-e.
• Continue megjeleníti az információs üzenetet, és továbbra is fut.
• Suspend a PowerShell 6-os és újabb verziói nem támogatottak, mivel csak munkafolyamatokhoz érhető el.
• SilentlyContinue nincs hatása, mivel az információs üzenet nem jelenik meg (alapértelmezett), és a szkript megszakítás nélkül folytatódik.

Feljegyzés

Az InformationAction paraméter felülbírálja, de nem helyettesíti a $InformationAction beállítási változó értékét, ha a paramétert parancsban használják szkript vagy függvény futtatásához.

-InformationVariable

A PowerShell 5.0-ban bevezetett. Az InformationVariable gyakori paraméter használatakor az információrekordok a paraméter által megadott változóban lesznek tárolva. A PowerShell-parancsmag pedig képes adatrekordokat írni az információs adatfolyamba. A parancsmaggal Write-Information adatrekordokat is írhat.

Az információs rekordok alapértelmezés szerint üzenetekként jelennek meg a konzolon. Az információs rekord megjelenítését az InformationAction common paraméterrel szabályozhatja. A viselkedést a beállításváltozóval $InformationPreference is módosíthatja. További információ: $InformationPreferenceabout_Preference_Variables.

Feljegyzés

Az információs változó tartalmazza a parancs által létrehozott összes információs üzenetet, beleértve a beágyazott függvényekbe vagy szkriptekbe irányuló hívásokból érkező információs üzeneteket is.

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

Alapértelmezés szerint az új információrekord felülírja a változóban már tárolt értékeket. Ha hozzá szeretné fűzni a hibaüzenetet a változó tartalmához, tegyen egy pluszjelet (+) a változó neve elé.

-OutBuffer

Meghatározza, hogy hány objektum halmozódjon fel egy pufferben, mielőtt a folyamaton keresztül bármilyen objektumot elküldenének. Ha kihagyja ezt a paramétert, az objektumok a létrehozásukkor lesznek elküldve.

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

Ez az erőforrás-kezelési paraméter speciális felhasználók számára lett kialakítva. Ha ezt a paramétert használja, a PowerShell adatokat küld a következő parancsmagnak a következő parancsmagra a következő parancsmagban OutBuffer + 1.

Az alábbi példa a parancsmagot használó Write-Host blokkok között ForEach-Object jelenik meg. A megjelenítés 2 vagy OutBuffer + 12 kötegben váltakozik.

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

A kimeneti objektumokat a parancsból tárolja a megadott változóban, a kimenetnek a folyamat mentén történő elküldése mellett.

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

Ha hozzá szeretné adni a kimenetet a változóhoz, ahelyett, hogy lecserélné a már ott tárolt kimenetet, írjon be egy pluszjelet (+) a változó neve elé.

A következő parancs például létrehozza a változót $out , és tárolja benne a folyamatobjektumot:

Get-Process PowerShell -OutVariable out

A következő parancs hozzáadja a folyamatobjektumot a $out változóhoz:

Get-Process iexplore -OutVariable +out

A következő parancs megjeleníti a változó tartalmát $out :

$out

Feljegyzés

Az OutVariable paraméter által létrehozott változó egy [System.Collections.ArrayList].

-PipelineVariable

A PipelineVariable lehetővé teszi a következő folyamatszegmensbe a paramétert használó parancs által átadott legújabb érték elérését. A folyamat bármely parancsa hozzáférhet az értékhez a nevesített PipelineVariable használatával. Az érték akkor lesz hozzárendelve a változóhoz, amikor a következő folyamatszegmensbe kerül. Ez megkönnyíti a PipelineVariiable használatát, mint egy adott ideiglenes változót, amelyet több helyen kell hozzárendelni.

A PipelineVariable használatával ellentétben $_ a $PSItemfolyamatparancsok az előző parancstól eltérő parancsok által átadott (és mentett) folyamatértékeket is elérhetik. A folyamatparancsok hozzáférhetnek a folyamaton áthaladó következő elem feldolgozása során az utolsó pipaértékhez. Ez lehetővé teszi a parancsok számára, hogy visszatáplálást hajtsanak végre egy előző parancsra (vagy magára).

Feljegyzés

A speciális függvények legfeljebb három szkriptblokkot tartalmazhatnak: begin, processés end. Ha a PipelineVariable paramétert speciális függvényekkel használja, a függvény futtatásakor csak az első definiált szkriptblokk értékei lesznek hozzárendelve a változóhoz. További információ: Speciális függvények. A PowerShell 7.2 kijavítja ezt a viselkedést.

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

Az érvényes értékek sztringek, ugyanúgy, mint bármely változónév esetében.

Figyelemfelhívás

A PipelineVariable hatóköre arra a folyamatra terjed ki, amelyben meghívják. A folyamaton kívüli változók, amelyek ugyanazt a nevet használják, törlődnek a folyamat végrehajtása előtt. A PipelineVariable a folyamat leállásakor kimegy a hatókörből. Ha a folyamaton belül több parancs is ugyanazt a PipelineVariable értéket adja meg, akkor csak egy megosztott változó van. Ez a változó a változót meghatározó parancs legújabb csőkimenetével frissül.

Egyes blokkoló parancsok összegyűjtik az összes folyamatelemet, mielőtt bármilyen kimenetet állítanának elő, például Sort-Object vagy Select-Object -Last. Az ilyen blokkolási parancsok előtt egy parancsban hozzárendelt PipelineVariable mindig tartalmazza az előző parancs utolsó piped elemét, ha a blokkolási parancsot követő parancsban használják.

Az alábbiakban egy példa látható a PipelineVariable működésére. Ebben a példában a PipelineVariable paraméter hozzáadódik egy Foreach-Object parancshoz a parancs eredményeinek változókban való tárolásához. Egy 1 és 5 közötti számtartomány az első Foreach-Object parancsba van állítva, amelynek eredményeit egy nevesített $tempváltozó tárolja.

Az első Foreach-Object parancs eredményei egy második Foreach-Object parancsba vannak állítva, amely megjeleníti az aktuális és $temp $_a .

# Create a variable named $temp
$temp=8
Get-Variable temp
# Note that the variable just created isn't available on the
# pipeline when -PipelineVariable creates the same variable name
1..5 | ForEach-Object -PipelineVariable temp -Begin {
    Write-Host "Step1[BEGIN]:`$temp=$temp"
} -Process {
  Write-Host "Step1[PROCESS]:`$temp=$temp - `$_=$_"
  Write-Output $_
} | ForEach-Object {
  Write-Host "`tStep2[PROCESS]:`$temp=$temp - `$_=$_"
}
# The $temp variable is deleted when the pipeline finishes
Get-Variable temp

Name                           Value
----                           -----
temp                           8

Step1[BEGIN]:$temp=
Step1[PROCESS]:$temp= - $_=1
        Step2[PROCESS]:$temp=1 - $_=1
Step1[PROCESS]:$temp=1 - $_=2
        Step2[PROCESS]:$temp=2 - $_=2
Step1[PROCESS]:$temp=2 - $_=3
        Step2[PROCESS]:$temp=3 - $_=3
Step1[PROCESS]:$temp=3 - $_=4
        Step2[PROCESS]:$temp=4 - $_=4
Step1[PROCESS]:$temp=4 - $_=5
        Step2[PROCESS]:$temp=5 - $_=5

Name                           Value
----                           -----
temp

-ProgressAction

Meghatározza, hogy a PowerShell hogyan reagál a szkript, parancsmag vagy szolgáltató által létrehozott folyamatfrissítésekre, például a Write-Progress parancsmag által létrehozott folyamatjelző sávokra. A Write-Progress parancsmag olyan folyamatjelző sávokat hoz létre, amelyek egy parancs állapotát mutatják. A ProgressAction paraméter a PowerShell 7.4-ben lett hozzáadva.

A ProgressAction paraméter a ActionPreference következő enumerálási értékek egyikét veszi fel: SilentlyContinue, Stop, Continue, Inquire, , IgnoreSuspendvagy Break.

Az érvényes értékek a következők:

• Break A parancs előfordulásakor adja meg a hibakeresőt Write-Progress .
• Stop: Nem jelenik meg a folyamatjelző sáv. Ehelyett hibaüzenetet jelenít meg, és leállítja a végrehajtást.
• Inquire: Nem jelenik meg a folyamatjelző sáv. Engedélyt kér a folytatáshoz. Ha válaszol vagy Y A, megjelenik a folyamatjelző sáv.
• Continue: (Alapértelmezett) Megjeleníti a folyamatjelző sávot, és folytatja a végrehajtást.
• SilentlyContinue: Végrehajtja a parancsot, de nem jeleníti meg a folyamatjelző sávot.

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

Részletes információkat jelenít meg a parancs által végrehajtott műveletről. Ez az információ hasonlít a nyomkövetésben vagy a tranzakciónaplóban szereplő információkra. Ez a paraméter csak akkor működik, ha a parancs létrehoz egy verbose üzenetet. Ez a paraméter például akkor működik, ha egy parancs tartalmazza a Write-Verbose parancsmagot.

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

A Verbose paraméter felülírja az $VerbosePreference aktuális parancs változójának értékét. Mivel a változó alapértelmezett értéke SilentlyContinue$VerbosePreference, verbose az üzenetek alapértelmezés szerint nem jelennek meg.

• -Verbose:$true hatása megegyezik a -Verbose
• -Verbose:$false letiltja az üzenetek megjelenítését verbose . Akkor használja ezt a paramétert, ha az értéke $VerbosePreference nem SilentlyContinue (az alapértelmezett).

-WarningAction

Meghatározza, hogy a parancsmag hogyan reagál a parancs figyelmeztetésére. A Folytatás az alapértelmezett érték. Ez a paraméter csak akkor működik, ha a parancs figyelmeztető üzenetet hoz létre. Ez a paraméter például akkor működik, ha egy parancs tartalmazza a Write-Warning parancsmagot.

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

A WarningAction paraméter felülírja az $WarningPreference aktuális parancs változójának értékét. Mivel a változó alapértelmezett értéke a $WarningPreference Folytatás, figyelmeztetések jelennek meg, és a végrehajtás folytatódik, kivéve, ha a WarningAction paramétert használja.

• Break figyelmeztetés esetén a hibakeresőt adja meg.
• Continue megjeleníti a figyelmeztető üzeneteket, és folytatja a parancs végrehajtását. A Continue az alapértelmezett formátum.
• Inquire megjeleníti a figyelmeztető üzenetet, és megerősítést kér a végrehajtás folytatása előtt. Ezt az értéket ritkán használják.
• SilentlyContinue letiltja a figyelmeztető üzenetet, és folytatja a parancs végrehajtását.
• Stop megjeleníti a figyelmeztető üzenetet, és leállítja a parancs végrehajtását.

Feljegyzés

A WarningAction paraméter felülbírálja, de nem helyettesíti a $WarningAction beállítási változó értékét, ha a paramétert parancsban használják szkript vagy függvény futtatásához.

-WarningVariable

A megadott változóban tárolja a parancsra vonatkozó figyelmeztető rekordokat.

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

A rendszer akkor is menti az összes generált figyelmeztetést a változóba, ha a figyelmeztetések nem jelennek meg a felhasználó számára.

Ha hozzá szeretné fűzni a figyelmeztetéseket a változó tartalmához, ahelyett, hogy lecserélné a már ott tárolt figyelmeztetéseket, írjon be egy pluszjelet (+) a változó neve elé.

A következő parancs például létrehozza a változót $a , majd tárolja benne az esetleges figyelmeztetéseket:

Get-Process -Id 6 -WarningVariable a

A következő parancs minden figyelmeztetést hozzáad a $a változóhoz:

Get-Process -Id 2 -WarningVariable +a

A következő parancs a következő tartalommal jelenik meg $a:

$a

Ezzel a paraméterrel olyan változót hozhat létre, amely csak adott parancsokból származó figyelmeztetéseket tartalmaz. A tömb jelölését használhatja, például $a[0] $warning[1,2] hivatkozhat a változóban tárolt konkrét figyelmeztetésekre.

Feljegyzés

A figyelmeztető változó tartalmazza a parancs által generált összes figyelmeztetést, beleértve a beágyazott függvényekre vagy szkriptekre irányuló hívásokra vonatkozó figyelmeztetéseket is.

Kockázatkezelési paraméter leírásai

-WhatIf

A parancs végrehajtása helyett a parancs hatását leíró üzenetet jelenít meg.

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

A WhatIf paraméter felülbírálja az $WhatIfPreference aktuális parancs változójának értékét. Mivel a $WhatIfPreference változó alapértelmezett értéke 0 (letiltva), a WhatIf viselkedése nem történik meg a WhatIf paraméter nélkül. További információ: about_Preference_Variables.

• $true hatása megegyezik -WhatIfa .
• $false letiltja az automatikus WhatIf viselkedést, amely akkor jön létre, ha a $WhatIfPreference változó értéke 1.

A következő parancs például egy parancs paraméterét -WhatIf Remove-Item használja:

Remove-Item Date.csv -WhatIf

Az elem eltávolítása helyett a PowerShell felsorolja az általa végzett műveleteket és az érintett elemeket. Ez a parancs a következő kimenetet hozza létre:

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

-Confirm

A parancs végrehajtása előtt megerősítést kér.

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

A Confirm paraméter felülírja az $ConfirmPreference aktuális parancs változójának értékét. Az alapértelmezett érték igaz. További információ: about_Preference_Variables.

• $true hatása megegyezik -Confirma .
• $false letiltja az automatikus megerősítést, amely akkor fordul elő, ha az érték $ConfirmPreference kisebb vagy egyenlő a parancsmag becsült kockázatával.

Az alábbi parancs például egy paranccsal használja a Confirm paramétert Remove-Item . Az elem eltávolítása előtt a PowerShell felsorolja az általa végzett műveleteket és az érintett elemeket, és jóváhagyást kér.

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"):

A Confirm válaszlehetőségek a következők:

Válasz	Eredmény
Yes (Y)	A művelet végrehajtása.
Yes to All (A)	Hajtsa végre az összes műveletet, és tiltsa le az azt követő műveleteket Confirm
	lekérdezéseket a parancshoz.
No (N):	Ne hajtsa végre a műveletet.
No to All (L):	Ne végezzen semmilyen műveletet, és tiltsa le az azt követő műveleteket
	Confirm lekérdezéseket a parancshoz.
Suspend (S):	Szüneteltesse a parancsot, és hozzon létre egy ideiglenes munkamenetet.
Help (?)	Súgó megjelenítése ezekhez a beállításokhoz.

A Felfüggesztés beállítás felfüggeszti a parancsot, és létrehoz egy ideiglenes beágyazott munkamenetet, amelyben addig dolgozhat, amíg készen nem áll a Confirm beállítás kiválasztására. A beágyazott munkamenet parancssora két további simítással (>>) jelzi, hogy az az eredeti szülőparancs gyermekművelete. A beágyazott munkamenetben parancsokat és szkripteket futtathat. A beágyazott munkamenet befejezéséhez és az Confirm eredeti parancs beállításaihoz való visszatéréshez írja be a "kilépés" kifejezést.

Az alábbi példában a Felfüggesztés beállítás (S) segítségével ideiglenesen leállítja a parancsokat, miközben a felhasználó egy parancsparamétert keres a súgóban. A szükséges információk beszerzése után a felhasználó a "kilépés" típust választja a beágyazott kérdés befejezéséhez, majd kiválasztja az Igen (y) választ a Confirm lekérdezésre.

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

Lásd még

• about_Preference_Variables
• Ír-Debug
• Írási hiba
• Ír-Verbose
• Írási figyelmeztetés