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 sie sind automatisch für jedes Cmdlet verfügbar.

Sie können die allgemeinen Parameter mit jedem Cmdlet verwenden, haben aber möglicherweise keine Auswirkungen auf alle Cmdlets. Wenn beispielsweise ein Cmdlet 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 werden 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 ActionPreference-Typwerte . ActionPreference ist eine Aufzählung 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 Risikominderungsparameter. Cmdlets, die Risiken für das System oder benutzerspezifische Daten beinhalten, bieten diese Parameter in der Regel an.

Die Risikominderungsparameter sind:

  • WhatIf (wi)
  • Confirm (cf)

Allgemeine Parameterbeschreibungen

-Debug

Zeigt Programmierebenendetail über den Vorgang an, der vom Befehl ausgeführt wird. Dieser Parameter funktioniert nur, wenn der Befehl eine Debugnachricht 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 Debuggingnachrichten nicht angezeigt, da der Wert der $DebugPreference Variablen "SilentlyContinue" lautet.

Im interaktiven Modus überschreibt der Debug Parameter den Wert der $DebugPreference Variablen für den aktuellen Befehl, und legt den Wert auf $DebugPreference "Inquire" fest.

Im nicht interaktiven Modus überschreibt der Debug Parameter den Wert der $DebugPreference Variablen für den aktuellen Befehl, und legt den Wert auf $DebugPreference "Weiter" fest.

-Debug:$true hat dieselbe Wirkung wie -Debug. Wird verwendet -Debug:$false , um die Anzeige von Debuggingnachrichten zu unterdrücken, wenn $DebugPreference dies nicht "SilentlyContinue" ist, was die Standardeinstellung ist.

-ErrorAction

Bestimmt, wie das Cmdlet auf einen nicht beendeten Fehler aus dem Befehl reagiert. Dieser Parameter funktioniert nur, wenn der Befehl einen Nicht-Terminierungsfehler generiert, z. B. solche 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 Parameter ErrorAction überschreibt den Wert der $ErrorActionPreference Variablen für den aktuellen Befehl. Da der Standardwert der $ErrorActionPreference Variablen "Weiter" lautet, werden Fehlermeldungen angezeigt und die Ausführung wird fortgesetzt, es sei denn, Sie verwenden den ErrorAction-Parameter .

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

-ErrorAction:Break Gibt den Debugger ein, wenn ein Fehler auftritt oder eine Ausnahme ausgelöst wird.

-ErrorAction:Continue zeigt die Fehlermeldung an und führt den Befehl weiter aus. Continue ist die Standardoption.

-ErrorAction:Ignore unterdrückt die Fehlermeldung und führt den Befehl weiter aus. Im Gegensatz zu SilentlyContinue fügt Ignore die Fehlermeldung nicht zur $Error automatischen Variablen hinzu. Der Wert "Ignorieren" wird in PowerShell 3.0 eingeführt.

-ErrorAction:Inquire zeigt die Fehlermeldung an und fordert Sie zur Bestätigung auf, bevor Sie die Ausführung fortsetzen. Dieser Wert wird selten verwendet.

-ErrorAction:SilentlyContinue unterdrückt die Fehlermeldung und führt den Befehl weiter aus.

-ErrorAction:Stop zeigt die Fehlermeldung an und beendet die Ausführung des Befehls.

-ErrorAction: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

ErrorVariable speichert Fehlermeldungen über den Befehl in der angegebenen Variable und in der $Error automatischen Variablen. Weitere Informationen finden Sie unter about_Automatic_Variables.

Type: String
Aliases: ev

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

Standardmäßig überschreiben neue Fehlermeldungen, die bereits in der Variablen gespeichert sind. Wenn Sie die Fehlermeldung an den Variableninhalt anfügen möchten, geben Sie vor dem Variablennamen ein Pluszeichen (+) ein.

Der folgende Befehl erstellt z. B. die $a Variable und speichert dann alle Fehler darin:

Get-Process -Id 6 -ErrorVariable a

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

Get-Process -Id 2 -ErrorVariable +a

Der folgende Befehl zeigt den Inhalt von $a:

$a

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

Hinweis

Die benutzerdefinierte Fehlervariable enthält alle Fehler, die vom Befehl generiert werden, einschließlich Fehler von Aufrufen von geschachtelten Funktionen oder Skripts.

-InformationAction

In PowerShell 5.0 eingeführt. Innerhalb des Befehls oder Skripts, in dem sie verwendet wird, überschreibt der allgemeine InformationAction-Parameter den Wert der $InformationPreference Einstellungsvariable, die standardmäßig auf SilentlyContinue festgelegt ist. Wenn Sie in einem Skript mit InformationAction verwendenWrite-Information, Write-Information werden die Werte abhängig vom Wert des InformationAction-Parameters angezeigt. Weitere Informationen finden $InformationPreferenceSie unter about_Preference_Variables.

Type: ActionPreference
Aliases: ia
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

-InformationAction:Break Gibt den Debugger an einem Vorkommen des Write-Information Befehls ein.

-InformationAction:Stop stoppt einen Befehl oder ein Skript bei einem Vorkommen des Write-Information Befehls.

-InformationAction:Ignore unterdrückt die Informationsmeldung und führt den Befehl weiter aus. Im Gegensatz zu SilentlyContinue wird die Informationsnachricht vollständig ignoriert ; sie fügt die Informationsnachricht nicht dem Informationsdatenstrom hinzu.

-InformationAction:Inquire zeigt die informationale Meldung an, die Sie in einem Write-Information Befehl angeben, und fragt dann, ob Sie fortfahren möchten.

-InformationAction:Continue zeigt die Informationsmeldung an und wird fortgesetzt.

-InformationAction:Suspend wird in PowerShell 6 und höher nicht unterstützt, da sie nur für Workflows verfügbar ist.

-InformationAction:SilentlyContinue keine Auswirkung, da die Informationsmeldung nicht angezeigt wird (Standard), und das Skript wird ohne Unterbrechung fortgesetzt.

Hinweis

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

-InformationVariable

In PowerShell 5.0 eingeführt. Innerhalb des Befehls oder Skripts, in dem sie verwendet wird, speichert der allgemeine InformationVariable-Parameter in einer Variablen eine Zeichenfolge, die Sie durch Hinzufügen des Write-Information Befehls angeben. Write-Information Werte werden abhängig vom Wert des allgemeinen InformationAction-Parameters angezeigt; Wenn Sie den allgemeinen Parameter "InformationAction " nicht hinzufügen, Write-Information werden Zeichenfolgen abhängig vom Wert der $InformationPreference Einstellungsvariable angezeigt. Weitere Informationen finden $InformationPreferenceSie unter about_Preference_Variables.

Hinweis

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

Type: String
Aliases: iv

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-OutBuffer

Bestimmt die Anzahl der Objekte, die in einem Puffer gesammelt werden sollen, bevor objekte über die Pipeline gesendet werden. Wenn Sie diesen Parameter weglassen, werden Objekte beim Generieren gesendet.

Type: Int32
Aliases: ob

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

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

Im folgenden Beispiel werden ForEach-Object zwischen Prozessblöcken angezeigt, die das Write-Host Cmdlet verwenden. Die Anzeigevarianten 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 Variable 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

Wenn Sie die Ausgabe zur Variablen hinzufügen möchten, geben Sie vor dem Variablennamen ein Pluszeichen (+) 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

Der folgende Befehl fügt der $out Variablen das Prozessobjekt hinzu:

Get-Process iexplore -OutVariable +out

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

$out

Hinweis

Die variable, die vom OutVariable-Parameter erstellt wurde, ist ein [System.Collections.ArrayList].

-PipelineVariable

PipelineVariable ermöglicht den Zugriff auf den zuletzt an das nächste Pipelinesegment übergebenen Wert durch den Befehl, der diesen Parameter verwendet. Jeder Befehl in der Pipeline kann auf den Wert mit dem Namen PipelineVariable zugreifen. Der Wert wird der Variablen zugewiesen, wenn sie in das nächste Pipelinesegment übergeben wird. Dies erleichtert die Verwendung der PipelineVariable als eine bestimmte temporäre Variable, die möglicherweise an mehreren Speicherorten zugewiesen werden muss.

Anders $_ als bei $PSItemverwendung eines PipelineVariable-Befehls kann jeder Pipelinebefehl auf pipelinewerte zugreifen, die von anderen Befehlen als dem unmittelbar vorherigen Befehl übergeben (und gespeichert) werden. Pipelinebefehle können beim Verarbeiten des nächsten Elements, das durch die Pipeline übergeben wird, auf den letzten Wert zugreifen. Dadurch kann ein Befehl seine Ausgabe auf einen vorherigen Befehl (oder selbst) zurückfeed .

Hinweis

Erweiterte Funktionen können bis zu drei Skriptblöcke aufweisen: begin, process, und end. Wenn Sie den PipelineVariable-Parameter mit erweiterten Funktionen verwenden, werden nur Werte aus dem ersten definierten Skriptblock der Variablen 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, identisch mit variablen Namen.

Achtung

Die PipelineVariable wird auf die Pipeline, in der sie aufgerufen wird, erweitert. Variablen außerhalb der Pipeline, die denselben Namen verwenden, werden entfernt, bevor die Pipeline ausgeführt wird. Die PipelineVariable ist außerhalb des Bereichs, wenn die Pipeline beendet wird. Wenn mehrere Befehle in der Pipeline dieselbe PipelineVariable angeben, gibt es nur eine freigegebene Variable. Diese Variable wird mit der zuletzt weitergeleiteten Ausgabe des Befehls aktualisiert, die die Variable angibt.

Einige Blockieren von Befehlen sammeln alle Pipelineelemente, bevor sie eine Ausgabe erstellen, z. B Sort-Object . oder Select-Object -Last. Alle pipelineVariable , die einem Befehl zugewiesen sind, bevor ein solcher Blockierungsbefehl immer das letzte weitergeleitete Element aus dem vorherigen Befehl enthält, wenn er in einem Befehl nach dem Blockierungsbefehl verwendet wird.

Im Folgenden sehen 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, 1 bis 5, wird an den ersten Foreach-Object Befehl weitergeleitet, deren Ergebnisse in einer Variablen mit $tempdem Namen gespeichert werden.

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

# Create a variable named $temp
$temp=8
Get-Variable temp
# Note that the variable just created is not 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

Get-Variable: Cannot find a variable with the name '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" lautet, werden ausführliche Nachrichten standardmäßig nicht angezeigt.

-Verbose:$true hat denselben Effekt wie -Verbose

-Verbose:$false unterdrückt die Anzeige ausführlicher Nachrichten. Verwenden Sie diesen Parameter, wenn der Wert $VerbosePreference von " SilentlyContinue " (Standardeinstellung) nicht angegeben 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 Parameter "WarningAction " überschreibt den Wert der $WarningPreference Variablen für den aktuellen Befehl. Da der Standardwert der $WarningPreference Variablen "Weiter" lautet, werden Warnungen angezeigt und die Ausführung wird fortgesetzt, es sei denn, Sie verwenden den WarningAction-Parameter .

-WarningAction:Break gibt den Debugger ein, wenn eine Warnung auftritt.

-WarningAction:Continue zeigt die Warnmeldungen an und führt den Befehl weiter aus. Continue ist die Standardoption.

-WarningAction:Inquire zeigt die Warnmeldung an und fordert Sie zur Bestätigung auf, bevor Sie die Ausführung fortsetzen. Dieser Wert wird selten verwendet.

-WarningAction:SilentlyContinue unterdrückt die Warnmeldung und führt den Befehl weiter aus.

-WarningAction:Stop zeigt die Warnmeldung an und beendet die Ausführung des Befehls.

Hinweis

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

-WarningVariable

Speichert Warnungen über den 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.

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

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

Get-Process -Id 6 -WarningVariable a

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

Get-Process -Id 2 -WarningVariable +a

Der folgende Befehl zeigt den Inhalt von $a:

$a

Sie können diesen Parameter verwenden, um eine Variable zu erstellen, die nur Warnungen aus bestimmten Befehlen enthält. Sie können 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 Warnungen, die vom Befehl generiert werden, einschließlich Warnungen von Aufrufen von geschachtelten Funktionen oder Skripts.

Beschreibungen des Risikomanagementparameters

-WhatIf

Zeigt eine Meldung an, die den Effekt 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

-WhatIf:$true hat dieselbe Wirkung wie -WhatIf.

-WhatIf:$false unterdrückt das automatische WhatIf-Verhalten, das zum Ergebnis führt, 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 sie ausführen würden, 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

-Confirm:$true hat dieselbe Wirkung wie -Confirm.

-Confirm:$false unterdrückt die automatische Bestätigung, die auftritt, wenn der Wert $ConfirmPreference kleiner oder gleich dem geschätzten Risiko des Cmdlets ist.

Der folgende Befehl verwendet beispielsweise den Confirm Parameter mit einem Remove-Item Befehl. Vor dem Entfernen des Elements listet PowerShell die Vorgänge auf, die sie ausführen würden, und die Elemente, die betroffen wären, und fordert die Genehmigung an.

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 von nachfolgenden 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 anschließende Aktionen Confirm
Abfragen für diesen Befehl.
Suspend (S): Anhalten des Befehls und Erstellen einer temporären Sitzung.
Help (?) Zeigen Sie Hilfe für diese Optionen an.

Die Option " Anhalten " platziert den Befehl im Haltemodus 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 weist zwei zusätzliche Carets (>>) auf, um anzugeben, dass es sich um einen untergeordneten Vorgang des ursprünglichen übergeordneten Befehls befindet. 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 zu beenden, während der Benutzer die Hilfe für einen Befehlsparameter überprüft. Nach dem Abrufen der erforderlichen Informationen geben die Benutzer "exit" ein, um die geschachtelte Eingabeaufforderung zu beenden und dann die Antwort "Ja" (y) für die Confirm Abfrage auszuwählen.

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

Keywords

about_Common_Parameters

Siehe auch