THEMA

about_CommonParameters
KURZBESCHREIBUNG
Beschreibt die Parameter, die mit jedem Cmdlet verwendet werden
knnen.
DETAILBESCHREIBUNG
Die allgemeinen Parameter bilden einen Satz von Cmdlet-Parametern,
den Sie mit jedem Cmdlet verwenden knnen. Diese werden von
Windows PowerShell, nicht vom Cmdlet-Entwickler, implementiert,
und sie sind fr jedes Cmdlet automatisch verfgbar.
Die allgemeinen Parameter knnen Sie mit jedem Cmdlet verwenden,
doch haben diese nicht in jedem Fall Auswirkungen auf alle
Cmdlets. Wenn z. B. von einem Cmdlet keine ausfhrliche Ausgabe
generiert wird, hat der allgemeine Verbose-Parameter keine
Auswirkungen.
Mehrere allgemeine Parameter berschreiben Systemstandards oder
Einstellungen, die Sie mit den Windows PowerShell-Einstellungs-
variablen festgelegt haben. Im Gegensatz zu den Einstellungsvariablen
wirken sich die allgemeinen Parameter auf nur die Befehle aus, in
denen sie verwendet werden.


Zustzlich zu den allgemeinen Parametern bieten viele Cmdlets den
WhatIf-Risikominderungsparameter und den -Risikominderungsparameter.
Solche Parameter werden meist von Cmdlets geboten, die Risiken
fr das System fr oder Benutzerdaten darstellen.
Die gngigsten Parameter sind folgende:
-Verbose
-Debug
-WarningAction
-WarningVariable
-ErrorAction
-ErrorVariable
-OutVariable
-OutBuffer

Folgende Risikominderungsparameter sind verfgbar:
-WhatIf
-Confirm
Weitere Informationen zu Einstellungsvariablen finden Sie, indem
Sie Folgendes eingeben:

help about_preference_variables
Beschreibungen allgemeiner Parameter
-Verbose[:{$true | $false}]
Zeigt ausfhrliche Informationen zu dem Vorgang an, der mit
dem Befehl ausgefhrt wird. Diese Informationen hneln den
Informationen in einem Ablaufverfolgungs- oder Transaktions-
protokoll. Dieser Parameter kann nur verwendet werden, wenn vom
Befehl eine ausfhrliche Meldung generiert wird.
Beispielsweise kann dieser Parameter verwendet werden, wenn
ein Befehl das Cmdlet "Write-Verbose" enthlt.

Der Verbose-Parameter berschreibt den Wert der Variablen
"$VerbosePreference" fr den aktuellen Befehl. Da der Standardwert
der Variablen "$VerbosePreference" "SilentlyContinue" lautet, werden
ausfhrliche Meldungen standardmig nicht angezeigt.
Gltige Werte:
$true (-Verbose:$true) hat die gleichen Auswirkungen wie
-Verbose.
$false (-Verbose:$false) unterdrckt die Anzeige
ausfhrlicher Meldungen. Verwenden Sie diesen Parameter,
wenn der Wert von $VerbosePreference nicht
"SilentlyContinue" (Standard) ist.
-Debug[:{$true | $false}]
Zeigt Details auf Programmierebene zu dem Vorgang an, der vom
Befehl ausgefhrt wird. Dieser Parameter kann nur verwendet
werden, wenn vom Befehl eine Debugmeldung generiert wird.
Beispielsweise kann dieser Parameter verwendet werden, wenn
ein Befehl das Cmdlet "Write-Debug" enthlt.

Der Debug-Parameter berschreibt den Wert der Variablen
"$DebugPreference" fr den aktuellen Befehl. Da der
Standardwert der Variablen "$DebugPreference" "SilentlyContinue"
lautet, werden Debugmeldungen standardmig nicht angezeigt.

Gltige Werte:
$true (-Debug:$true). Hat die gleichen Auswirkungen wie
-Debug.
$false (-Debug:$false). Unterdrckt die Anzeige von
Debugmeldungen, wenn der Wert vom $DebugPreference nicht
"SilentlyContinue" (Standard) ist.
-WarningAction[:{SilentlyContinue | Continue | Inquire | Stop}]
Bestimmt, wie das Cmdlet auf eine Warnung im Befehl reagiert.
Der Standardwert ist "Continue". Dieser Parameter kann nur
verwendet werden, wenn vom Befehl eine Warnmeldung generiert
wird. Beispielsweise kann dieser Parameter verwendet werden,
wenn ein Befehl das Cmdlet "Write-Warning" enthlt.
Der WarningAction-Parameter berschreibt den Wert der Variablen
"$WarningPreference" fr den aktuellen Befehl. Da der Standardwert
der Variablen "$WarningPreference" "Continue" ist, werden Warnungen
angezeigt, und die Ausfhrung wird fortgesetzt, sofern Sie nicht den
WarningAction-Parameter verwenden.
Gltige Werte:
SilentlyContinue. Unterdrckt die Warnmeldung und setzt
die Ausfhrung des Befehls fort.
Continue. Zeigt die Warnmeldung an und setzt die
Ausfhrung des Befehls fort. Der Standardwert ist "Continue".

Inquire. Zeigt die Warnmeldung an und fordert Sie vor dem
Fortsetzen der Ausfhrung zum Besttigen auf. Dieser Wert
wird selten verwendet.
Stop. Zeigt die Warnmeldung an und beendet die Ausfhrung
des Befehls.
-WarningVariable [+]<Variablenname>
Speichert Warnungen zum Befehl in der angegebenen Variable.
Wenn Sie die Warnungen an den Variableninhalt anfgen
mchten, anstatt bereits dort gespeicherte Warnungen zu
ersetzen, geben Sie vor dem Variablennamen ein Pluszeichen
(+) ein.
Beispielsweise wird mit dem folgenden Befehl die Variable
"$a" erstellt, und smtliche Warnungen werden darin gespeichert:
get-process -id 6 -WarningVariable a
Mit dem folgenden Befehl werden alle Warnungen der Variablen
"$a" hinzugefgt:
get-process -id 2 -WarningVariable +a
Mit dem folgenden Befehl wird der Inhalt von $a angezeigt:
$a
Mit diesem Parameter knnen Sie eine Variable erstellen, die nur
Warnungen aus bestimmten Befehlen enthlt. Fr Verweise auf bestimmte
in der Variablen gespeicherte Warnungen knnen Sie die Arraynotation
verwenden, z. B. "$a[0]" oder "$warning[1,2]".
-ErrorAction[:{SilentlyContinue | Continue | Inquire | Stop)]
Bestimmt, wie das Cmdlet auf einen Fehler ohne Abbruch im
Befehl reagiert. Dieser Parameter kann nur verwendet werden,
wenn vom Befehl eine Debugmeldung generiert wird.
Beispielsweise kann dieser Parameter verwendet werden, wenn
ein Befehl das Cmdlet "Write-Error" enthlt.
Der ErrorAction-Parameter berschreibt den Wert der Variablen
"$ErrorActionPreference" fr den aktuellen Befehl. Da der
Standardwert der Variablen "$ErrorActionPreference" "Continue" ist,
werden Fehlermeldungen angezeigt, und die Ausfhrung wird
fortgesetzt, sofern Sie nicht den ErrorAction-Parameter verwenden.
Der ErrorAction-Parameter hat keine Auswirkungen auf Fehler
mit Abbruch (z. B. fehlende Daten, ungltige Parameter oder
ungengende Berechtigungen), die den erfolgreichen Abschluss
eines Befehls verhindern.
Gltige Werte:
SilentlyContinue. Unterdrckt die Fehlermeldung und setzt
die Ausfhrung des Befehls fort.
Continue. Zeigt die Fehlermeldung an und setzt die
Ausfhrung des Befehls fort. Der Standardwert ist "Continue".

Inquire. Zeigt die Fehlermeldung an und fordert Sie vor dem
Fortsetzen der Ausfhrung zum Besttigen auf. Dieser Wert
wird selten verwendet.
Stop. Zeigt die Fehlermeldung an und beendet die
Ausfhrung des Befehls.

-ErrorVariable [+]<Variablenname>
Speichert Fehlermeldungen zum Befehl in der angegebenen
Variable und in der automatischen Variablen "$Error". Geben
Sie den folgenden Befehl ein, um weitere Informationen zu
erhalten:
get-help about_automatic_variables
Standardmig berschreiben neue Fehlermeldungen andere
Fehlermeldungen, die bereits in der Variable gespeichert
sind. Wenn Sie die Fehlermeldung an den Variableninhalt
anfgen mchten, geben Sie vor dem Variablennamen ein
Pluszeichen (+) ein.
Beispielsweise wird mit dem folgenden Befehl die Variable
"$a" erstellt, und smtliche Fehler werden darin gespeichert:
get-process -id 6 -ErrorVariable a
Mit dem folgenden Befehl werden smtliche Fehlermeldungen der
Variablen "$a" hinzugefgt:
get-process -id 2 -ErrorVariable +a
Mit dem folgenden Befehl wird der Inhalt von $a angezeigt:
$a
Mit diesem Parameter knnen Sie eine Variable erstellen, die nur
Fehlermeldungen aus bestimmten Befehlen enthlt. Die automatische
Variable "$Error" enthlt Fehlermeldungen aus allen Befehlen in der
Sitzung.
Fr Verweise auf bestimmte in den Variablen gespeicherte
Fehler knnen Sie die Arraynotation verwenden, z. B. "$a[0]" oder
"$error[1,2]".
-OutVariable [+]<Variablenname>
Speichert Ausgabeobjekte des Befehls in der angegebenen
Variablen und zeigt diese in der Befehlszeile an.
Wenn Sie die Ausgabe der Variablen hinzufgen mchten,
anstatt bereits dort gespeicherte Ausgaben zu ersetzen, geben
Sie vor dem Variablennamen ein Pluszeichen (+) ein.
Beispielsweise wird mit dem folgenden Befehl die Variable "$out"
erstellt, und das Prozessobjekt wird darin gespeichert:
get-process powershell -OutVariable out
Mit dem folgenden Befehl wird das Prozessobjekt der Variablen
"$out" hinzugefgt:
get-process iexplore -OutVariable +out
Mit dem folgenden Befehl wird der Inhalt der Variablen "$out"
angezeigt:
$out
-OutBuffer <Int32>
Bestimmt die Anzahl der Objekte, die in einem Puffer
akkumuliert werden, bevor Objekte ber die Pipeline bergeben
werden. Wenn Sie diesen Parameter weglassen, werden Objekte
gesendet, sobald sie generiert wurden.
Dieser Ressourcenverwaltungsparameter ist fr fortgeschrittene
Benutzer vorgesehen.
Wenn Sie diesen Parameter verwenden, ruft Windows PowerShell
das nchste Cmdlet in der Pipeline erst auf, wenn die Anzahl
der generierten Objekte gleich OutBuffer+1 ist. Danach werden
smtliche Objekte gesendet, sobald sie generiert wurden.

Beschreibungen von Risikoverwaltungsparametern
-WhatIf[:{$true | $false}]
Zeigt eine Meldung an, in der die Auswirkungen des Befehls
beschrieben werden, statt den Befehl auszufhren.
Der WhatIf-Parameter berschreibt den Wert der Variablen
"$WhatIfPreference" fr den aktuellen Befehl. Da der
Standardwert der Variablen "$WhatIfPreference" 0
(deaktiviert) ist, wird das WhatIf-Verhalten nicht ohne den
WhatIf-Parameter ausgefhrt. Geben Sie den folgenden Befehl
ein, um weitere Informationen zu erhalten:
get-help about_preference_variables
Gltige Werte:
$true (-WhatIf:$true). Hat die gleichen Auswirkungen wie
-WhatIf.
$false (-WhatIf:$false). Unterdrckt das automatische
Verhalten von WhatIf, das ausgefhrt wird, wenn der Wert
der Variablen "$WhatIfPreference" 1 ist.
Beispielsweise verwendet der folgende Befehl den
WhatIf-Parameter im Befehl "Remove-Item":
PS> remove-item date.csv -whatif
Statt das Element zu entfernen, fhrt Windows PowerShell die
potenziell auszufhrenden Vorgnge sowie die dann betroffenen
Elemente auf. Dieser Befehl erzeugt die folgende Ausgabe:
WhatIf: Ausfhren des Vorgangs "Datei entfernen" fr das
Ziel "C:\ps-test\date.csv".

-Confirm[:{$true | $false}]
Fordert Sie vor der Ausfhrung des Befehls zum Besttigen auf.
Der Confirm-Parameter berschreibt den Wert der Variablen
"$ConfirmPreference" fr den aktuellen Befehl. Der
Standardwert lautet "High". Geben Sie den folgenden Befehl
ein, um weitere Informationen zu erhalten:
get-help about_preference_variables
Gltige Werte:
$true (-WhatIf:$true). Hat die gleichen Auswirkungen wie
-Confirm.
$false(-Confirm:$false). Unterdrckt die automatische
Besttigung, die erfolgt, wenn der Wert der Variablen
"$ConfirmPreference" kleiner oder gleich dem geschtzten
Risiko des Cmdlet ist.
Beispielsweise verwendet der folgende Befehl den
Confirm-Parameter mit dem Befehl "Remove-Item". Vor dem
Entfernen des Elements fhrt Windows PowerShell die potenziell
auszufhrenden Vorgnge sowie die dann betroffenen Elemente
auf und fordert Sie zum Besttigen auf.
PS C:\ps-test> remove-item tmp*.txt -confirm
Dieser Befehl erzeugt die folgende Ausgabe:
Besttigung
Mchten Sie diese Aktion wirklich ausfhren?
Ausfhren des Vorgangs "Datei entfernen" fr das Ziel "C:\ps-test\tmp1.t
xt
[Y] Ja [A] Ja, alle [N] Nein [L] Nein, keine [S] Anhalten
[?] Hilfe (Standard ist "Y"):
SIEHE AUCH
about_Preference_Variables
Write-Debug
Write-Warning
Write-Error
Write-Verbose