about_CommonParameters

Kurze Beschreibung

Beschreibt die Parameter, die mit jedem Cmdlet verwendet werden können.

Lange Beschreibung

Die allgemeinen Parameter sind eine Reihe von Cmdletparametern, die Sie mit jedem Cmdlet verwenden können. Sie werden von PowerShell implementiert, nicht vom Cmdlet-Entwickler, und sind automatisch für jedes Cmdlet verfügbar.

Sie können die allgemeinen Parameter mit jedem Cmdlet verwenden, aber sie wirken sich möglicherweise nicht auf alle Cmdlets aus. Wenn ein Cmdlet beispielsweise keine ausführliche Ausgabe generiert, hat die Verwendung des Verbose allgemeinen Parameters keine Auswirkung.

Die allgemeinen Parameter sind auch für erweiterte Funktionen verfügbar, die das CmdletBinding-Attribut oder das Parameter-Attribut verwenden.

Mehrere gängige Parameter überschreiben Systemstandardeinstellungen oder -einstellungen, die Sie mithilfe der PowerShell-Einstellungsvariablen festlegen. Im Gegensatz zu den Einstellungsvariablen wirken sich die allgemeinen Parameter nur auf die Befehle aus, in denen sie verwendet werden.

Weitere Informationen finden Sie unter about_Preference_Variables.

In der folgenden Liste werden die allgemeinen Parameter angezeigt. Ihre Aliase sind in Klammern aufgeführt.

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

Die Aktionsparameter sind Werte vom Typ "ActionPreference" . ActionPreference ist eine Enumeration mit den folgenden Werten:

Name	Wert
Break	6
Suspend	5
Ignore	4
Inquire	3
Continue	2
Stop	1
SilentlyContinue	0

Sie können den Namen oder den Wert mit dem Parameter verwenden.

Zusätzlich zu den allgemeinen Parametern bieten viele Cmdlets Parameter zur Risikominderung. Cmdlets, die Risiken für das System oder für Benutzerdaten beinhalten, bieten in der Regel diese Parameter an.

Die Parameter zur Risikominderung sind:

• WhatIf (wi)
• Confirm (siehe)

Allgemeine Parameterbeschreibungen

-Debug

Zeigt Details auf Programmiererebene über den Vorgang an, der mit dem Befehl ausgeführt wird. Dieser Parameter funktioniert nur, wenn der Befehl eine Debugmeldung generiert. Dieser Parameter funktioniert beispielsweise, wenn ein Befehl das Write-Debug Cmdlet enthält.

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

Standardmäßig werden Debugmeldungen nicht angezeigt, da der Wert der $DebugPreference Variablen SilentlyContinue ist.

Der Debug Parameter überschreibt den Wert der $DebugPreference Variablen für den aktuellen Befehl und legt den Wert auf $DebugPreferenceContinue fest.

-Debug:$true hat die gleiche Wirkung wie -Debug. Verwenden Sie -Debug:$false , um die Anzeige von Debugnachrichten zu unterdrücken, wenn $DebugPreference nicht SilentlyContinue ist, was der Standard ist.

-Erroraction

Bestimmt, wie das Cmdlet auf einen nicht beendenden Fehler des Befehls reagiert. Dieser Parameter funktioniert nur, wenn der Befehl einen nicht beendenden Fehler generiert, z. B. aus dem Write-Error Cmdlet.

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

Der ErrorAction-Parameter überschreibt den Wert der $ErrorActionPreference Variablen für den aktuellen Befehl. Da der Standardwert der $ErrorActionPreference Variablen Continue ist, werden Fehlermeldungen angezeigt und die Ausführung wird fortgesetzt, es sei denn, Sie verwenden den ErrorAction-Parameter .

Der ErrorAction-Parameter hat keine Auswirkungen auf das Beenden von Fehlern (z. B. fehlende Daten, ungültige Parameter oder unzureichende Berechtigungen), die verhindern, dass ein Befehl erfolgreich abgeschlossen wird.

• Break Gibt den Debugger ein, wenn ein Fehler auftritt oder eine Ausnahme ausgelöst wird.
• Continue zeigt die Fehlermeldung an und setzt die Ausführung des Befehls fort. Continue ist die Standardoption.
• Ignore unterdrückt die Fehlermeldung und setzt die Ausführung des Befehls fort. Im Gegensatz zu SilentlyContinue fügt Ignore die Fehlermeldung nicht zur automatischen $Error Variablen hinzu. Der Ignore-Wert wird in PowerShell 3.0 eingeführt.
• Inquire zeigt die Fehlermeldung an und fordert Sie zur Bestätigung auf, bevor Sie mit der Ausführung fortfahren. Dieser Wert wird selten verwendet.
• SilentlyContinue unterdrückt die Fehlermeldung und setzt die Ausführung des Befehls fort.
• Stop zeigt die Fehlermeldung an und beendet die Ausführung des Befehls.
• Suspend ist nur für Workflows verfügbar, die in PowerShell 6 und darüber hinaus nicht unterstützt werden.

Hinweis

Der ErrorAction-Parameter überschreibt, ersetzt jedoch nicht den Wert der $ErrorActionPreference Variablen, wenn der Parameter in einem Befehl zum Ausführen eines Skripts oder einer Funktion verwendet wird.

-ErrorVariable

Fehlerdatensätze werden automatisch in der automatischen $Error Variablen gespeichert. Weitere Informationen finden Sie unter about_Automatic_Variables.

Wenn Sie den ErrorVariable-Parameter für einen Befehl verwenden, speichert PowerShell auch die vom Befehl ausgegebenen Fehlerdatensätze in der vom Parameter angegebenen Variablen.

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

Standardmäßig überschreiben neue Fehlermeldungen Fehlermeldungen, die bereits in der Variablen gespeichert sind. Um die Fehlermeldung an den Variableninhalt anzufügen, setzen Sie ein Pluszeichen (+) vor dem Variablennamen.

Der folgende Befehl erstellt beispielsweise die $a Variable und speichert dann alle Fehler darin:

Get-Process -Id 6 -ErrorVariable a

Der folgende Befehl fügt der $a Variablen alle Fehlermeldungen hinzu:

Get-Process -Id 2 -ErrorVariable +a

Der folgende Befehl zeigt den Inhalt von an $a:

$a

Mit diesem Parameter können Sie eine Variable erstellen, die nur Fehlermeldungen von bestimmten Befehlen enthält und sich nicht auf das Verhalten der $Error automatischen Variablen auswirkt. Die $Error automatische Variable enthält Fehlermeldungen von allen Befehlen in der Sitzung. Sie können die Arraynotation verwenden, z $a[0] . B. oder $error[1,2] , um auf bestimmte Fehler zu verweisen, die in den Variablen gespeichert sind.

Hinweis

Die benutzerdefinierte Fehlervariable enthält alle vom Befehl generierten Fehler, einschließlich Der Fehler aus Aufrufen geschachtelter Funktionen oder Skripts.

-InformationAction

In PowerShell 5.0 eingeführt. Innerhalb des Befehls oder Skripts, in dem er verwendet wird, setzt der allgemeine Parameter InformationAction den Wert der $InformationPreference Einstellungsvariablen außer Kraft, die standardmäßig auf SilentlyContinue festgelegt ist. Wenn Sie in einem Skript mit InformationAction verwendenWrite-Information, Write-Information werden werte abhängig vom Wert des InformationAction-Parameters angezeigt. Weitere Informationen zu $InformationPreferencefinden Sie unter 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 Gibt den Debugger bei einem Vorkommen des Befehls ein Write-Information .
• Stop beendet einen Befehl oder ein Skript beim Auftreten des Write-Information Befehls.
• Ignore unterdrückt die Informationsmeldung und setzt die Ausführung des Befehls fort. Im Gegensatz zu SilentlyContinue vergisst Ignore die Informationsnachricht vollständig. Die Informationsmeldung wird dem Informationsstream nicht hinzugefügt.
• Inquire zeigt die Informationsmeldung an, die Sie in einem Write-Information Befehl angeben, und fragt dann, ob Sie fortfahren möchten.
• Continue zeigt die Informationsmeldung an und wird weiterhin ausgeführt.
• Suspend wird in PowerShell 6 und höher nicht unterstützt, da es nur für Workflows verfügbar ist.
• SilentlyContinue keine Auswirkung, da die Informationsmeldung nicht (Standard) angezeigt wird und das Skript ohne Unterbrechung fortgesetzt wird.

Hinweis

Der InformationAction-Parameter überschreibt, ersetzt aber nicht den Wert der $InformationAction Einstellungsvariablen, wenn der Parameter in einem Befehl zum Ausführen eines Skripts oder einer Funktion verwendet wird.

-InformationVariable

In PowerShell 5.0 eingeführt. Wenn Sie den allgemeinen Parameter InformationVariable verwenden, werden Informationssätze in einer Variablen gespeichert, die durch den Parameter angegeben wird. Und das PowerShell-Cmdlet kann Informationsdatensätze in den Informationsstream schreiben. Sie können das Write-Information Cmdlet auch verwenden, um Informationsdatensätze zu schreiben.

Informationseinträge werden standardmäßig als Nachrichten in der Konsole angezeigt. Sie können die Anzeige des Informationsdatensatzes mithilfe des allgemeinen Parameters InformationAction steuern. Sie können das Verhalten auch mithilfe der Einstellungsvariablen $InformationPreference ändern. Weitere Informationen zu $InformationPreferencefinden Sie unter about_Preference_Variables.

Hinweis

Die Informationsvariable enthält alle vom Befehl generierten Informationsmeldungen, einschließlich Informationsmeldungen von Aufrufen geschachtelter Funktionen oder Skripts.

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

Standardmäßig überschreibt ein neuer Informationsdatensatz Werte, die bereits in der Variablen gespeichert sind. Um die Fehlermeldung an den Variableninhalt anzufügen, setzen Sie ein Pluszeichen (+) vor dem Variablennamen.

-OutBuffer

Bestimmt die Anzahl der Objekte, die in einem Puffer angesammelt werden sollen, bevor Objekte über die Pipeline gesendet werden. Wenn Sie diesen Parameter weglassen, werden Objekte gesendet, während sie generiert werden.

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

Dieser Ressourcenverwaltungsparameter ist für fortgeschrittene Benutzer konzipiert. Wenn Sie diesen Parameter verwenden, sendet PowerShell Daten an das nächste Cmdlet in Batches von OutBuffer + 1.

Im folgenden Beispiel werden abwechselnd Blöcke angezeigt ForEach-Object , die das Write-Host Cmdlet verwenden. Die Anzeige wechselt in Batches von 2 oder 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

Speichert Ausgabeobjekte aus dem Befehl in der angegebenen Variablen, zusätzlich zum Senden der Ausgabe entlang der Pipeline.

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

Um die Ausgabe der Variablen hinzuzufügen, geben Sie ein Pluszeichen (+) vor dem Variablennamen ein, anstatt eine Ausgabe zu ersetzen, die möglicherweise bereits dort gespeichert ist.

Der folgende Befehl erstellt beispielsweise die $out Variable und speichert das Prozessobjekt darin:

Get-Process PowerShell -OutVariable out

Mit dem folgenden Befehl wird das Prozessobjekt der $out Variablen hinzugefügt:

Get-Process iexplore -OutVariable +out

Der folgende Befehl zeigt den Inhalt der $out Variablen an:

$out

Hinweis

Die vom OutVariable-Parameter erstellte Variable ist eine [System.Collections.ArrayList].

-PipelineVariable

PipelineVariable ermöglicht den Zugriff auf den neuesten Wert, der durch den Befehl, der diesen Parameter verwendet, an das nächste Pipelinesegment übergeben wird. Jeder Befehl in der Pipeline kann mithilfe des Namens PipelineVariable auf den Wert zugreifen. Der Wert wird der Variablen zugewiesen, wenn er an das nächste Pipelinesegment übergeben wird. Dadurch ist pipelineVariable einfacher zu verwenden als eine bestimmte temporäre Variable, die möglicherweise an mehreren Speicherorten zugewiesen werden muss.

Im Gegensatz zu $_ oder $PSItemermöglicht die Verwendung von PipelineVariable jedem Pipelinebefehl den Zugriff auf Pipelinewerte, die von anderen Befehlen als dem unmittelbar vorangehenden Befehl übergeben (und gespeichert werden). Pipelinebefehle können während der Verarbeitung des nächsten Elements, das die Pipeline durchläuft, auf den letzten Wert zugreifen. Dadurch kann ein Befehl seine Ausgabe an einen vorherigen Befehl (oder sich selbst) zurückgeben .

Hinweis

Erweiterte Funktionen können über bis zu drei Skriptblöcke verfügen: begin, processund end. Wenn Sie den Parameter PipelineVariable mit erweiterten Funktionen verwenden, werden der Variablen nur Werte aus dem ersten definierten Skriptblock zugewiesen, während die Funktion ausgeführt wird. Weitere Informationen finden Sie unter Erweiterte Funktionen. PowerShell 7.2 korrigiert dieses Verhalten.

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

Gültige Werte sind Zeichenfolgen, die identisch sind wie für alle Variablennamen.

Achtung

PipelineVariable ist auf die Pipeline ausgerichtet, in der sie aufgerufen wird. Variablen außerhalb der Pipeline, die denselben Namen verwenden, werden gelöscht, bevor die Pipeline ausgeführt wird. Der PipelineVariable-Bereich wird beendet, wenn die Pipeline beendet wird. Wenn mehrere Befehle innerhalb der Pipeline dieselbe PipelineVariable angeben, gibt es nur eine freigegebene Variable. Diese Variable wird mit der letzten Pipeausgabe des Befehls aktualisiert, der die Variable angibt.

Einige blockierende Befehle sammeln alle Pipelineelemente, bevor sie eine Ausgabe erzeugen, z. B Sort-Object . oder Select-Object -Last. Jede PipelineVariable , die in einem Befehl vor einem solchen blockierenden Befehl zugewiesen wurde, enthält immer das letzte Pipeelement aus dem vorherigen Befehl, wenn es in einem Befehl nach dem blockierenden Befehl verwendet wird.

Im Folgenden finden Sie ein Beispiel für die Funktionsweise von PipelineVariable . In diesem Beispiel wird der PipelineVariable-Parameter einem Foreach-Object Befehl hinzugefügt, um die Ergebnisse des Befehls in Variablen zu speichern. Ein Zahlenbereich von 1 bis 5 wird an den ersten Foreach-Object Befehl weitergeleitet, dessen Ergebnisse in einer Variablen mit dem Namen $tempgespeichert werden.

Die Ergebnisse des ersten Foreach-Object Befehls werden in einen zweiten Foreach-Object Befehl weitergeleitet, der die aktuellen Werte von $temp und $_anzeigt.

# 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

-Verbose

Zeigt detaillierte Informationen zum Vorgang an, der vom Befehl ausgeführt wird. Diese Informationen ähneln den Informationen in einer Ablaufverfolgung oder in einem Transaktionsprotokoll. Dieser Parameter funktioniert nur, wenn der Befehl eine ausführliche Nachricht generiert. Dieser Parameter funktioniert beispielsweise, wenn ein Befehl das Write-Verbose Cmdlet enthält.

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

Der Verbose Parameter überschreibt den Wert der $VerbosePreference Variablen für den aktuellen Befehl. Da der Standardwert der $VerbosePreference Variablen SilentlyContinue ist, werden ausführliche Nachrichten standardmäßig nicht angezeigt.

• -Verbose:$true hat den gleichen Effekt wie -Verbose
• -Verbose:$false unterdrückt die Anzeige ausführlicher Nachrichten. Verwenden Sie diesen Parameter, wenn der Wert von $VerbosePreference nicht SilentlyContinue (Standardwert) ist.

-WarningAction

Bestimmt, wie das Cmdlet auf eine Warnung aus dem Befehl reagiert. Continue ist der Standardwert. Dieser Parameter funktioniert nur, wenn der Befehl eine Warnmeldung generiert. Dieser Parameter funktioniert beispielsweise, wenn ein Befehl das Write-Warning Cmdlet enthält.

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

Der WarningAction-Parameter überschreibt den Wert der $WarningPreference Variablen für den aktuellen Befehl. Da der Standardwert der $WarningPreference Variablen Continue ist, werden Warnungen angezeigt, und die Ausführung wird fortgesetzt, es sei denn, Sie verwenden den WarningAction-Parameter .

• Break gibt den Debugger ein, wenn eine Warnung auftritt.
• Continue zeigt die Warnmeldungen an und setzt die Ausführung des Befehls fort. Continue ist die Standardoption.
• Inquire zeigt die Warnmeldung an und fordert Sie zur Bestätigung auf, bevor Sie die Ausführung fortsetzen. Dieser Wert wird selten verwendet.
• SilentlyContinue unterdrückt die Warnmeldung und setzt die Ausführung des Befehls fort.
• Stop zeigt die Warnmeldung an und beendet die Ausführung des Befehls.

Hinweis

Der WarningAction-Parameter überschreibt, ersetzt jedoch nicht den Wert der $WarningAction Einstellungsvariablen, wenn der Parameter in einem Befehl zum Ausführen eines Skripts oder einer Funktion verwendet wird.

-WarningVariable

Speichert Warnungsdatensätze zum Befehl in der angegebenen Variablen.

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

Alle generierten Warnungen werden in der Variablen gespeichert, auch wenn die Warnungen dem Benutzer nicht angezeigt werden.

Um die Warnungen an den Variableninhalt anzufügen, geben Sie ein Pluszeichen (+) vor dem Variablennamen ein, anstatt warnungen zu ersetzen, die möglicherweise bereits dort gespeichert sind.

Der folgende Befehl erstellt beispielsweise die $a Variable und speichert dann alle Warnungen darin:

Get-Process -Id 6 -WarningVariable a

Mit dem folgenden Befehl werden der $a Variablen alle Warnungen hinzugefügt:

Get-Process -Id 2 -WarningVariable +a

Der folgende Befehl zeigt den Inhalt von an $a:

$a

Sie können diesen Parameter verwenden, um eine Variable zu erstellen, die nur Warnungen aus bestimmten Befehlen enthält. Sie können die Arraynotation verwenden, z $a[0] . B. oder $warning[1,2] , um auf bestimmte Warnungen zu verweisen, die in der Variablen gespeichert sind.

Hinweis

Die Warnungsvariable enthält alle vom Befehl generierten Warnungen, einschließlich Warnungen vor Aufrufen geschachtelter Funktionen oder Skripts.

Beschreibungen von Risikomanagementparametern

-WhatIf

Zeigt eine Meldung an, die die Auswirkung des Befehls beschreibt, anstatt den Befehl auszuführen.

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

Der WhatIf-Parameter überschreibt den Wert der $WhatIfPreference Variablen für den aktuellen Befehl. Da der Standardwert der $WhatIfPreference Variablen 0 (deaktiviert) ist, wird das WhatIf-Verhalten nicht ohne den WhatIf-Parameter ausgeführt. Weitere Informationen finden Sie unter about_Preference_Variables.

• $true hat die gleiche Wirkung wie -WhatIf.
• $false unterdrückt das automatische WhatIf-Verhalten, das sich ergibt, wenn der Wert der $WhatIfPreference Variablen 1 ist.

Der folgende Befehl verwendet beispielsweise den -WhatIf Parameter in einem Remove-Item Befehl:

Remove-Item Date.csv -WhatIf

Anstatt das Element zu entfernen, listet PowerShell die Vorgänge auf, die es ausführen würde, und die Elemente, die betroffen wären. Dieser Befehl erstellt die folgende Ausgabe:

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

-Confirm

Fordert eine Bestätigung an, bevor der Befehl ausgeführt wird.

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

Der Confirm Parameter überschreibt den Wert der $ConfirmPreference Variablen für den aktuellen Befehl. Der Standardwert lautet „true“. Weitere Informationen finden Sie unter about_Preference_Variables.

• $true hat die gleiche Wirkung wie -Confirm.
• $false Unterdrückt die automatische Bestätigung, die auftritt, wenn der Wert von $ConfirmPreference kleiner oder gleich dem geschätzten Risiko des Cmdlets ist.

Der folgende Befehl verwendet z. B. den Confirm -Parameter mit einem Remove-Item -Befehl. Bevor das Element entfernt wird, listet PowerShell die Vorgänge auf, die es ausführen würde, und die elemente, die betroffen wären, und fordert die Genehmigung auf.

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

Die Confirm Antwortoptionen sind wie folgt:

Antwort	Ergebnis
Yes (Y)	Führen Sie die Aktion aus.
Yes to All (A)	Ausführen aller Aktionen und Unterdrücken nachfolgender Aktionen Confirm
	Abfragen für diesen Befehl.
No (N):	Führen Sie die Aktion nicht aus.
No to All (L):	Führen Sie keine Aktionen aus, und unterdrücken Sie nachfolgende
	Confirm Abfragen für diesen Befehl.
Suspend (S):	Halten Sie den Befehl an, und erstellen Sie eine temporäre Sitzung.
Help (?)	Hilfe zu diesen Optionen anzeigen.

Die Option Anhalten setzt den Befehl in den Haltepunkt und erstellt eine temporäre geschachtelte Sitzung, in der Sie arbeiten können, bis Sie bereit sind, eine Confirm Option auszuwählen. Die Eingabeaufforderung für die geschachtelte Sitzung verfügt über zwei zusätzliche Carets (>>), um anzugeben, dass es sich um einen untergeordneten Vorgang des ursprünglichen übergeordneten Befehls handelt. Sie können Befehle und Skripts in der geschachtelten Sitzung ausführen. Um die geschachtelte Sitzung zu beenden und zu den Confirm Optionen für den ursprünglichen Befehl zurückzukehren, geben Sie "exit" ein.

Im folgenden Beispiel wird die Option Anhalten (S) verwendet, um einen Befehl vorübergehend anzuhalten, während der Benutzer die Hilfe auf einen Befehlsparameter überprüft. Nach dem Abrufen der erforderlichen Informationen gibt der Benutzer "exit" ein, um die geschachtelte Eingabeaufforderung zu beenden, und wählt dann die Antwort Ja (y) auf die Confirm Abfrage aus.

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

Weitere Informationen

• about_Preference_Variables
• Schreiben-Debug
• Write-Error
• Schreiben-Verbose
• Write-Warning