PowerShell
Gemeinsame Parameter
Suche…
Bemerkungen
Gemeinsame Parameter können mit jedem Cmdlet verwendet werden (dh, sobald Sie Ihre Funktion als Cmdlet markieren [siehe CmdletBinding() ], erhalten Sie alle diese Parameter kostenlos).
Hier ist die Liste aller gängigen Parameter (Alias steht nach dem entsprechenden Parameter in Klammern):
-Debug (db)
-ErrorAction (ea)
-ErrorVariable (ev)
-InformationAction (ia) # introduced in v5
-InformationVariable (iv) # introduced in v5
-OutVariable (ov)
-OutBuffer (ob)
-PipelineVariable (pv)
-Verbose (vb)
-WarningAction (wa)
-WarningVariable (wv)
-WhatIf (wi)
-Confirm (cf)
ErrorAction-Parameter
Mögliche Werte sind Continue | Ignore | Inquire | SilentlyContinue | Stop | Suspend
Der Wert dieses Parameters bestimmt, wie das Cmdlet nicht beendende Fehler behandelt (z. B. von Write-Error generierte Informationen; weitere Informationen zur Fehlerbehandlung finden Sie unter [ Noch nicht erstellter Abschnitt]).
Der Standardwert (wenn dieser Parameter nicht angegeben wird) ist Continue .
-ErrorAction Weiter
Diese Option erzeugt eine Fehlermeldung und setzt die Ausführung fort.
PS C:\> Write-Error "test" -ErrorAction Continue ; Write-Host "Second command"
-ErrorAction Ignorieren
Diese Option erzeugt keine Fehlermeldung und setzt die Ausführung fort. Es werden auch keine Fehler zu der automatischen Variable $Error hinzugefügt.
Diese Option wurde in Version 3 eingeführt.
PS C:\> Write-Error "test" -ErrorAction Ignore ; Write-Host "Second command"
-ErrorAction-Anfrage
Diese Option erzeugt eine Fehlermeldung und fordert den Benutzer auf, eine auszuführende Aktion auszuwählen.
PS C:\> Write-Error "test" -ErrorAction Inquire ; Write-Host "Second command"
-ErrorAction SilentlyContinue
Diese Option erzeugt keine Fehlermeldung und setzt die Ausführung fort. Alle Fehler werden der automatischen Variable $Error hinzugefügt.
PS C:\> Write-Error "test" -ErrorAction SilentlyContinue ; Write-Host "Second command"
-ErrorAction Stop
Diese Option erzeugt eine Fehlermeldung und setzt die Ausführung nicht fort.
PS C:\> Write-Error "test" -ErrorAction Stop ; Write-Host "Second command"
-ErrorAction Suspend
Nur in PowerShell-Workflows verfügbar. Wenn der Befehl verwendet wird und ein Fehler auftritt, wird der Workflow angehalten. Dies ermöglicht die Untersuchung eines solchen Fehlers und gibt die Möglichkeit, den Workflow wieder aufzunehmen. Weitere Informationen zum Workflow-System finden Sie unter [Thema wurde noch nicht erstellt].