Allgemeine Parameternamen

Artikel
09/27/2021

Die in diesem Thema beschriebenen Parameter werden als allgemeine Parameter bezeichnet. Sie werden Cmdlets von der Windows PowerShell Runtime hinzugefügt und können nicht vom Cmdlet deklariert werden.

Hinweis

Diese Parameter werden auch Anbieter-Cmdlets und Funktionen hinzugefügt, die mit dem -Attribut ergänzt CmdletBinding werden.

Allgemeine allgemeine Parameter

Die folgenden Parameter werden allen Cmdlets hinzugefügt und können bei jeder Ausführung des Cmdlets aufgerufen werden. Diese Parameter werden von der System.Management.Automation.Internal.Commonparameters-Klasse definiert.

Bestätigen (Alias: cf)

Datentyp: SwitchParameter

Dieser Parameter gibt an, ob das Cmdlet eine Eingabeaufforderung anzeigt, die den Benutzer fragt, ob er sicher ist, dass er fortfahren möchte.

Debuggen (Alias: db)

Datentyp: SwitchParameter

Dieser Parameter gibt an, ob Debugmeldungen auf Programmiererebene an der Befehlszeile angezeigt werden können. Diese Meldungen dienen zur Problembehandlung des Vorgangs des Cmdlets und werden durch Aufrufe der System.Management.Automation.Cmdlet.WriteDebug-Methode generiert. Debugmeldungen müssen nicht lokalisiert werden.

ErrorAction (Alias: ea)

Datentyp: Enumeration

Dieser Parameter gibt an, welche Aktion erfolgen soll, wenn ein Fehler auftritt. Die möglichen Werte für diesen Parameter werden von der System.Management.Automation.Actionpreference-Enumeration definiert.

ErrorVariable (Alias: ev)

Datentyp: Zeichenfolge

Dieser Parameter gibt die Variable an, in der Objekte gespeichert werden, wenn ein Fehler auftritt. Verwenden Sie zum Anfügen an diese Variable +varname, anstatt die Variable zu löschen und zu festlegen.

OutBuffer (Alias: ob)

Datentyp: Int32

Dieser Parameter definiert die Anzahl der Objekte, die im Ausgabepuffer gespeichert werden sollen, bevor Objekte an die Pipeline übergeben werden. Standardmäßig werden Objekte sofort an die Pipeline übergeben.

OutVariable (Alias: ov)

Datentyp: Zeichenfolge

Dieser Parameter gibt die Variable an, in der alle vom Cmdlet generierten Ausgabeobjekte gespeichert werden. Verwenden Sie zum Anfügen an diese Variable +varname, anstatt die Variable zu löschen und zu festlegen.

PipelineVariable (Alias: pv)

Datentyp: Zeichenfolge

Dieser Parameter speichert den Wert des aktuellen Pipelineelements als Variable für jeden benannten Befehl, während es durch die Pipeline fließt.

Ausführlich (Alias: vb)

Datentyp: SwitchParameter

Dieser Parameter gibt an, ob das Cmdlet erläuternde Meldungen schreibt, die in der Befehlszeile angezeigt werden können. Diese Nachrichten sollen dem Benutzer zusätzliche Hilfe bieten und werden durch Aufrufe der System.Management.Automation.Cmdlet.WriteVerbose-Methode generiert.

WarningAction (Alias: wa)

Datentyp: Enumeration

Dieser Parameter gibt an, welche Aktion ausgeführt werden soll, wenn das Cmdlet eine Warnmeldung schreibt. Die möglichen Werte für diesen Parameter werden von der System.Management.Automation.Actionpreference-Enumeration definiert.

WarningVariable (Alias: wv)

Datentyp: Zeichenfolge

Dieser Parameter gibt die Variable an, in der Warnmeldungen gespeichert werden können. Verwenden Sie zum Anfügen an diese Variable +varname, anstatt die Variable zu löschen und zu festlegen.

Risk-Mitigation Parameter

Die folgenden Parameter werden Cmdlets hinzugefügt, die eine Bestätigung anfordern, bevor sie ihre Aktion ausführen. Weitere Informationen zu Bestätigungsanforderungen finden Sie unter Anfordern der Bestätigung. Diese Parameter werden von der System.Management.Automation.Internal.Shouldprocessparameters-Klasse definiert.

WhatIf (Alias: wi)

Datentyp: SwitchParameter

Dieser Parameter gibt an, ob das Cmdlet eine Meldung schreibt, die die Auswirkungen der Ausführung des Cmdlets beschreibt, ohne tatsächlich eine Aktion auszuführen.

Transaktionsparameter

Der folgende Parameter wird Cmdlets hinzugefügt, die Transaktionen unterstützen. Diese Parameter werden von der System.Management.Automation.Internal.Transactionparameters-Klasse definiert. Die Transaktionsunterstützung wurde in PowerShell 3.0 eingeführt und in PowerShell 6.0 eingestellt.