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 $DebugPreference
Continue 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 $InformationPreference
finden 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 einWrite-Information
.Stop
beendet einen Befehl oder ein Skript beim Auftreten desWrite-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 einemWrite-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 $InformationPreference
finden 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 $PSItem
ermö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
, process
und 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 $temp
gespeichert 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