Freigeben über

Genehmigte Verben für PowerShell-Befehle

PowerShell verwendet ein Verb-Nomen-Paar für die Namen von Cmdlets und für die abgeleiteten .NET-Klassen. Der Verbteil des Namens identifiziert die Aktion, die das Cmdlet ausführt. Der Substantivteil des Namens identifiziert die Entität, für die die Aktion ausgeführt wird. Beispielsweise ruft das Cmdlet Get-Command alle Befehle ab, die in PowerShell registriert sind.

Hinweis

PowerShell verwendet das Begriffsverb , um ein Wort zu beschreiben, das eine Aktion impliziert, auch wenn es sich bei diesem Wort nicht um ein Standardverb in der englischen Sprache handelt. Beispielsweise ist der Begriff New ein gültiger PowerShell-Verbname, da er eine Aktion impliziert, obwohl er kein Verb in der englischen Sprache ist.

Jedes genehmigte Verb hat ein entsprechendes Aliaspräfix definiert. Wir verwenden dieses Aliaspräfix in Aliasen für Befehle mit diesem Verb. Beispielsweise ist das Aliaspräfix für Importip und entsprechend ist der Alias für Import-Moduleipmo. Dies ist eine Empfehlung, aber keine Regel; Insbesondere müssen Befehlsaliasen nicht berücksichtigt werden, um bekannte Befehle aus anderen Umgebungen nachzuahmen.

Empfehlungen zur Verbbenennung

Die folgenden Empfehlungen helfen Ihnen bei der Auswahl eines geeigneten Verbs für Ihr Cmdlet, um die Konsistenz zwischen den von Ihnen erstellten Cmdlets, den cmdlets, die von PowerShell bereitgestellt werden, und den Cmdlets sicherzustellen, die von anderen Entworfen wurden.

  • Verwenden eines der vordefinierten Verbnamen, die von PowerShell bereitgestellt werden
  • Verwenden Sie das Verb, um den allgemeinen Bereich der Aktion zu beschreiben, und verwenden Sie Parameter, um die Aktion des Cmdlets weiter zu verfeinern.
  • Verwenden Sie kein Synonym eines genehmigten Verbs. Verwenden Sie z. B. immer Remove, verwenden Sie niemals Delete oder Eliminate.
  • Verwenden Sie nur die Form der einzelnen Verben, die in diesem Thema aufgeführt sind. Verwenden Sie Getbeispielsweise , aber nicht verwenden Getting oder Gets.
  • Verwenden Sie nicht die folgenden reservierten Verben oder Aliase. Die PowerShell-Sprache und einige wenige Cmdlets verwenden diese Verben unter außergewöhnlichen Umständen.
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

Möglicherweise erhalten Sie eine vollständige Liste der Verben mithilfe des Cmdlets Get-Verb.

Ähnliche Verben für verschiedene Aktionen

Die folgenden ähnlichen Verben stellen unterschiedliche Aktionen dar.

New Vs. Add

Verwenden Sie das verb New, um eine neue Ressource zu erstellen. Verwenden Sie die Add, um einem vorhandenen Container oder einer vorhandenen Ressource etwas hinzuzufügen. Beispielsweise fügt Add-Content einer vorhandenen Datei Ausgabe hinzu.

New Vs. Set

Verwenden Sie das verb New, um eine neue Ressource zu erstellen. Verwenden Sie das Set Verb, um eine vorhandene Ressource zu ändern, wenn sie nicht vorhanden ist, z. B. das Set-Variable Cmdlet.

Verwenden Sie das verb Find, um nach einem Objekt zu suchen. Verwenden Sie das verb Search, um einen Verweis auf eine Ressource in einem Container zu erstellen.

Get Vs. Read

Verwenden Sie das verb Get, um Informationen über eine Ressource (z. B. eine Datei) zu erhalten oder um ein Objekt abzurufen, mit dem Sie zukünftig auf die Ressource zugreifen können. Verwenden Sie das verb Read, um eine Ressource zu öffnen und Darin enthaltene Informationen zu extrahieren.

Invoke Vs. Start

Verwenden Sie das verb Invoke, um synchrone Vorgänge auszuführen, z. B. Ausführen eines Befehls und Warten auf das Beenden. Verwenden Sie das verb Start, um asynchrone Vorgänge zu starten, z. B. das Starten eines autonomen Prozesses.

Ping Vs. Test

Verwenden Sie das verb Test.

Allgemeine Verben

PowerShell verwendet die System.Management.Automation.VerbsCommon Enumerationsklasse, um generische Aktionen zu definieren, die auf fast jedes Cmdlet angewendet werden können. In der folgenden Tabelle sind die meisten definierten Verben aufgeführt.

Verb (Alias) Maßnahme Zu vermeidende Synonyme
Add (a) Fügt einem Container eine Ressource hinzu oder fügt ein Element an ein anderes Element an. Beispielsweise fügt das Cmdlet Add-Content einer Datei Inhalt hinzu. Dieses Verb ist mit Removegekoppelt. Append Attach Concatenate Insert
Clear (cl) Entfernt alle Ressourcen aus einem Container, löscht den Container jedoch nicht. Beispielsweise entfernt das Clear-Content Cmdlet den Inhalt einer Datei, löscht die Datei jedoch nicht. Flush, , EraseRelease, Unmark, , UnsetNullify
Close (cs) Ändert den Status einer Ressource, um ihn nicht zugänglich, nicht verfügbar oder nicht verwendbar zu machen. Dieses Verb wird mit Open.
Copy (cp) Kopiert eine Ressource in einen anderen Namen oder in einen anderen Container. Beispielsweise kopiert das cmdlet Copy-Item ein Element (z. B. eine Datei) von einem Speicherort im Datenspeicher an einen anderen Speicherort. Duplicate Clone Replicate Sync
Enter (et) Gibt eine Aktion an, mit der der Benutzer zu einer Ressource wechseln kann. Beispielsweise platziert das cmdlet Enter-PSSession den Benutzer in einer interaktiven Sitzung. Dieses Verb ist mit Exitgekoppelt. Push, Into
Exit (ex) Legt die aktuelle Umgebung oder den aktuellen Kontext auf den zuletzt verwendeten Kontext fest. Beispielsweise platziert das cmdlet Exit-PSSession den Benutzer in der Sitzung, die zum Starten der interaktiven Sitzung verwendet wurde. Dieses Verb ist mit Entergekoppelt. Pop, Out
Find (fd) Sucht nach einem Objekt in einem Container, der unbekannt, impliziert, optional oder angegeben ist. Search
Format (f) Ordnet Objekte in einem angegebenen Formular oder Layout an
Get (g) Gibt eine Aktion an, die eine Ressource abruft. Dieses Verb ist mit Setgekoppelt. Read, Open, CatObtainDirType, Dump, , Acquire, , , FindExamineSearch
Hide (h) Macht eine Ressource nicht erkennbar. Beispielsweise kann ein Cmdlet, dessen Name das Verb "Ausblenden" enthält, einen Dienst eines Benutzers verbergen. Dieses Verb ist mit Showgekoppelt. Block
Join (j) Kombiniert Ressourcen in einer Ressource. Beispielsweise kombiniert das cmdlet Join-Path einen Pfad mit einem seiner untergeordneten Pfade, um einen einzelnen Pfad zu erstellen. Dieses Verb ist mit Splitgekoppelt. Combine Unite Connect Associate
Lock (lk) Sichert eine Ressource. Dieses Verb ist mit Unlockgekoppelt. Restrict, Secure
Move (m) Verschiebt eine Ressource von einem Speicherort an einen anderen. Beispielsweise verschiebt das Cmdlet Move-Item ein Element von einem Speicherort im Datenspeicher an einen anderen Speicherort. Transfer, NameMigrate
New (n) Erstellt eine Ressource. (Das verb Set kann auch beim Erstellen einer Ressource verwendet werden, die Daten enthält, z. B. das Cmdlet Set-Variable.) Create, , GenerateBuild, , MakeAllocate
Open (op) Ändert den Status einer Ressource, um sie barrierefrei, verfügbar oder verwendbar zu machen. Dieses Verb ist mit Closegekoppelt.
Optimize (om) Erhöht die Effektivität einer Ressource.
Pop (pop) Entfernt ein Element vom oberen Rand eines Stapels. Beispielsweise ändert das cmdlet Pop-Location den aktuellen Speicherort an den Speicherort, der zuletzt auf den Stapel verschoben wurde.
Push (pu) Fügt am Anfang eines Stapels ein Element hinzu. Beispielsweise verschiebt das Cmdlet Push-Location die aktuelle Position auf den Stapel.
Redo (re) Setzt eine Ressource auf den Zustand zurück, der rückgängig gemacht wurde.
Remove (r) Löscht eine Ressource aus einem Container. Beispielsweise löscht das cmdlet Remove-Variable eine Variable und dessen Wert. Dieses Verb ist mit Addgekoppelt. Clear, , CutDispose, , DiscardErase
Rename (rn) Ändert den Namen einer Ressource. Beispielsweise ändert das Cmdlet Rename-Item, das für den Zugriff auf gespeicherte Daten verwendet wird, den Namen eines Elements im Datenspeicher. Change
Reset (rs) Legt eine Ressource auf den ursprünglichen Zustand zurück.
Resize (rz) Ändert die Größe einer Ressource.
Search (sr) Erstellt einen Verweis auf eine Ressource in einem Container. Find, Locate
Select (sc) Sucht eine Ressource in einem Container. Beispielsweise findet das Cmdlet Select-String Text in Zeichenfolgen und Dateien. Find, Locate
Set (s) Ersetzt Daten in einer vorhandenen Ressource oder erstellt eine Ressource, die einige Daten enthält. Beispielsweise ändert das cmdlet Set-Date die Systemzeit auf dem lokalen Computer. (Das New Verb kann auch zum Erstellen einer Ressource verwendet werden.) Dieses Verb ist mit Getgekoppelt. Write, , ResetAssign, , ConfigureUpdate
Show (sh) Macht eine Ressource für den Benutzer sichtbar. Dieses Verb ist mit Hidegekoppelt. Display, Produce
Skip (sk) Umgeht eine oder mehrere Ressourcen oder Punkte in einer Sequenz. Bypass, Jump
Split (sl) Trennt Teile einer Ressource. Beispielsweise gibt das Cmdlet Split-Path verschiedene Teile eines Pfads zurück. Dieses Verb ist mit Joingekoppelt. Separate
Step (st) Wechselt zum nächsten Punkt oder zur nächsten Ressource in einer Sequenz.
Switch (sw) Gibt eine Aktion an, die zwischen zwei Ressourcen wechselt, z. B. zwischen zwei Standorten, Zuständigkeiten oder Zuständen.
Undo (un) Legt eine Ressource auf den vorherigen Zustand fest.
Unlock (uk) Gibt eine Ressource frei, die gesperrt wurde. Dieses Verb ist mit Lockgekoppelt. Release, UnrestrictUnsecure
Watch (wc) Überprüft oder überwacht kontinuierlich eine Ressource auf Änderungen.

Kommunikationsverben

PowerShell verwendet die System.Management.Automation.VerbsCommunications Klasse, um Aktionen zu definieren, die für die Kommunikation gelten. In der folgenden Tabelle sind die meisten definierten Verben aufgeführt.

Verb (Alias) Maßnahme Zu vermeidende Synonyme
Connect (cc) Erstellt eine Verknüpfung zwischen einer Quelle und einem Ziel. Dieses Verb ist mit Disconnectgekoppelt. Join, TelnetLogin
Disconnect (dc) Hebt die Verknüpfung zwischen einer Quelle und einem Ziel auf. Dieses Verb ist mit Connectgekoppelt. Break, Logoff
Read (rd) Erwirbt Informationen aus einer Quelle. Dieses Verb ist mit Writegekoppelt. Acquire, PromptGet
Receive (rc) Akzeptiert Informationen, die von einer Quelle gesendet werden. Dieses Verb ist mit Sendgekoppelt. Read, AcceptPeek
Send (sd) Liefert Informationen an ein Ziel. Dieses Verb ist mit Receivegekoppelt. Put Broadcast Mail Fax
Write (wr) Fügt einem Ziel Informationen hinzu. Dieses Verb ist mit Readgekoppelt. Put, Print

Datenverben

PowerShell verwendet die System.Management.Automation.VerbsData Klasse, um Aktionen zu definieren, die für die Datenverarbeitung gelten. In der folgenden Tabelle sind die meisten definierten Verben aufgeführt.

Verbname (Alias) Maßnahme Zu vermeidende Synonyme
Backup (ba) Speichert Daten, indem sie repliziert werden. Save Burn Replicate Sync
Checkpoint (ch) Erstellt eine Momentaufnahme des aktuellen Zustands der Daten oder seiner Konfiguration. Diff
Compare (cr) Wertet die Daten aus einer Ressource anhand der Daten aus einer anderen Ressource aus. Diff
Compress (cm) Komprimiert die Daten einer Ressource. Paare mit Expand. Compact
Convert (cv) Ändert die Daten von einer Darstellung in eine andere, wenn das Cmdlet bidirektionale Konvertierung unterstützt oder wenn das Cmdlet die Konvertierung zwischen mehreren Datentypen unterstützt. Change, ResizeResample
ConvertFrom (cf) Konvertiert einen primären Eingabetyp (das Cmdlet-Nomen gibt die Eingabe an) in einen oder mehrere unterstützte Ausgabetypen. Export, OutputOut
ConvertTo (ct) Konvertiert von einem oder mehreren Eingabetypen in einen primären Ausgabetyp (das Cmdlet-Substantiv gibt den Ausgabetyp an). Import, InputIn
Dismount (dm) Trennt eine benannte Entität von einem Speicherort. Dieses Verb ist mit Mountgekoppelt. Unmount, Unlink
Edit (ed) Ändert vorhandene Daten durch Hinzufügen oder Entfernen von Inhalten. Change, UpdateModify
Expand (en) Stellt die Daten einer Ressource wieder her, die in den ursprünglichen Zustand komprimiert wurde. Dieses Verb ist mit Compressgekoppelt. Explode, Uncompress
Export (ep) Kapselt die primäre Eingabe in einen beständigen Datenspeicher, z. B. eine Datei, oder in ein Austauschformat. Dieses Verb ist mit Importgekoppelt. Extract, Backup
Group (gp) Ordnet eine oder mehrere Ressourcen an oder ordnet sie zu
Import (ip) Erstellt eine Ressource aus Daten, die in einem beständigen Datenspeicher (z. B. einer Datei) oder in einem Austauschformat gespeichert sind. Beispielsweise importiert das Import-Csv Cmdlet Daten aus einer durch Kommas getrennten Wertdatei (CSV) in Objekte, die von anderen Cmdlets verwendet werden können. Dieses Verb ist mit Exportgekoppelt. BulkLoad, Load
Initialize (in) Bereitet eine Ressource für die Verwendung vor und legt sie auf einen Standardzustand fest. Erase, , InitRenew, Rebuild, , ReinitializeSetup
Limit (l) Wendet Einschränkungen auf eine Ressource an. Quota
Merge (mg) Erstellt eine einzelne Ressource aus mehreren Ressourcen. Combine, Join
Mount (mt) Fügt eine benannte Entität an einen Speicherort an. Dieses Verb ist mit Dismountgekoppelt. Connect
Out (o) Sendet Daten aus der Umgebung. Beispielsweise sendet das Cmdlet Out-Printer Daten an einen Drucker.
Publish (pb) Stellt eine Ressource anderen zur Verfügung. Dieses Verb ist mit Unpublishgekoppelt. Deploy, ReleaseInstall
Restore (rr) Legt eine Ressource auf einen vordefinierten Zustand fest, z. B. einen durch Checkpointfestgelegten Zustand. Beispielsweise startet das Cmdlet Restore-Computer eine Systemwiederherstellung auf dem lokalen Computer. Repair Return Undo Fix
Save (sv) Behält Daten bei, um Verlust zu vermeiden.
Sync (sy) Stellt sicher, dass sich zwei oder mehr Ressourcen im selben Zustand befinden. Replicate, CoerceMatch
Unpublish (ub) Macht eine Ressource für andere nicht verfügbar. Dieses Verb ist mit Publishgekoppelt. Uninstall, RevertHide
Update (ud) Stellt eine Ressource up-to-Datum bereit, um ihren Zustand, seine Genauigkeit, Konformität oder Compliance beizubehalten. Beispielsweise wird das cmdlet Update-FormatData aktualisiert und der aktuellen PowerShell-Konsole Formatierungsdateien hinzugefügt. Refresh Renew Recalculate Re-index

Diagnoseverben

PowerShell verwendet die System.Management.Automation.VerbsDiagnostic Klasse, um Aktionen zu definieren, die für die Diagnose gelten. In der folgenden Tabelle sind die meisten definierten Verben aufgeführt.

Verb (Alias) Maßnahme Zu vermeidende Synonyme
Debug (db) Untersucht eine Ressource, um betriebstechnische Probleme zu diagnostizieren. Diagnose
Measure (ms) Identifiziert Ressourcen, die von einem angegebenen Vorgang verbraucht werden, oder ruft Statistiken zu einer Ressource ab. Calculate, DetermineAnalyze
Ping (pi) Veraltet – Verwenden Sie stattdessen das Verb "Test".
Repair (rp) Stellt eine Ressource in einer verwendbaren Bedingung wieder her Fix, Restore
Resolve (rv) Ordnet eine Kurzdarstellung einer Ressource einer umfassenderen Darstellung zu. Expand, Determine
Test (t) Überprüft den Vorgang oder die Konsistenz einer Ressource. Diagnose Analyze Salvage Verify
Trace (tr) Verfolgt die Aktivitäten einer Ressource. Track Follow Inspect Dig

Lebenszyklusverben

PowerShell verwendet die System.Management.Automation.VerbsLifecycle Klasse, um Aktionen zu definieren, die für den Lebenszyklus einer Ressource gelten. In der folgenden Tabelle sind die meisten definierten Verben aufgeführt.

Verb (Alias) Maßnahme Zu vermeidende Synonyme
Approve (ap) Bestätigt oder stimmt dem Status einer Ressource oder eines Prozesses zu.
Assert (as) Bestätigt den Status einer Ressource. Certify
Build (bd) Erstellt ein Artefakt (in der Regel eine Binärdatei oder ein Dokument) aus einer Reihe von Eingabedateien (normalerweise Quellcode oder deklarative Dokumente).) Dieses Verb wurde in PowerShell 6 hinzugefügt.
Complete (cp) Schließt einen Vorgang ab.
Confirm (cn) Bestätigt, überprüft oder überprüft den Status einer Ressource oder eines Prozesses. Acknowledge, , AgreeCertify, , ValidateVerify
Deny (dn) Lehnt den Zustand einer Ressource oder eines Prozesses ab oder lehnt sie ab. Block Object Refuse Reject
Deploy (dp) Sendet eine Anwendung, Website oder Lösung so an ein Remoteziel[s] so, dass ein Verbraucher dieser Lösung nach Abschluss der Bereitstellung darauf zugreifen kann. Dieses Verb wurde in PowerShell 6 hinzugefügt.
Disable (d) Konfiguriert eine Ressource auf einen nicht verfügbaren oder inaktiven Zustand. Beispielsweise wird mit dem Cmdlet Disable-PSBreakpoint ein Haltepunkt inaktiv. Dieses Verb ist mit Enablegekoppelt. Halt, Hide
Enable (e) Konfiguriert eine Ressource auf einen verfügbaren oder aktiven Zustand. Beispielsweise wird mit dem Cmdlet Enable-PSBreakpoint ein Haltepunkt aktiviert. Dieses Verb ist mit Disablegekoppelt. Start, Begin
Install (is) Platziert eine Ressource an einem Speicherort und initialisiert sie optional. Dieses Verb ist mit Uninstallgekoppelt. Setup
Invoke (i) Führt eine Aktion aus, z. B. ausführen eines Befehls oder einer Methode. Run, Start
Register (rg) Erstellt einen Eintrag für eine Ressource in einem Repository, z. B. einer Datenbank. Dieses Verb ist mit Unregistergekoppelt.
Request (rq) Fragt nach einer Ressource oder fragt nach Berechtigungen.
Restart (rt) Beendet einen Vorgang und startet ihn dann erneut. Beispielsweise stoppt das Restart-Service Cmdlet und startet dann einen Dienst. Recycle
Resume (ru) Startet einen Vorgang, der angehalten wurde. Beispielsweise startet das Cmdlet Resume-Service einen Dienst, der angehalten wurde. Dieses Verb ist mit Suspendgekoppelt.
Start (sa) Initiiert einen Vorgang. Beispielsweise startet das cmdlet Start-Service einen Dienst. Dieses Verb ist mit Stopgekoppelt. Launch, InitiateBoot
Stop (sp) Beendet eine Aktivität. Dieses Verb ist mit Startgekoppelt. End Kill Terminate Cancel
Submit (sb) Stellt eine Ressource zur Genehmigung dar. Post
Suspend (ss) Hält eine Aktivität an. Beispielsweise hält das cmdlet Suspend-Service einen Dienst an. Dieses Verb ist mit Resumegekoppelt. Pause
Uninstall (us) Entfernt eine Ressource von einem angegebenen Speicherort. Dieses Verb ist mit Installgekoppelt.
Unregister (ur) Entfernt den Eintrag für eine Ressource aus einem Repository. Dieses Verb ist mit Registergekoppelt. Remove
Wait (w) Hält einen Vorgang an, bis ein angegebenes Ereignis auftritt. Beispielsweise hält das cmdlet Wait-Job Vorgänge an, bis mindestens eine der Hintergrundaufträge abgeschlossen ist. Sleep, Pause

Sicherheitsverben

PowerShell verwendet die System.Management.Automation.VerbsSecurity Klasse, um Aktionen zu definieren, die für die Sicherheit gelten. In der folgenden Tabelle sind die meisten definierten Verben aufgeführt.

Verb (Alias) Maßnahme Zu vermeidende Synonyme
Block (bl) Beschränkt den Zugriff auf eine Ressource. Dieses Verb ist mit Unblockgekoppelt. Prevent, LimitDeny
Grant (gr) Ermöglicht den Zugriff auf eine Ressource. Dieses Verb ist mit Revokegekoppelt. Allow, Enable
Protect (pt) Schützt eine Ressource vor Angriffen oder Verlusten. Dieses Verb ist mit Unprotectgekoppelt. Encrypt, SafeguardSeal
Revoke (rk) Gibt eine Aktion an, die den Zugriff auf eine Ressource nicht zulässt. Dieses Verb ist mit Grantgekoppelt. Remove, Disable
Unblock (ul) Entfernt Einschränkungen für eine Ressource. Dieses Verb ist mit Blockgekoppelt. Clear, Allow
Unprotect (up) Entfernt Sicherheitsvorkehrungen von einer Ressource, die hinzugefügt wurde, um angriffe oder verluste zu verhindern. Dieses Verb ist mit Protectgekoppelt. Decrypt, Unseal

Andere Verben

PowerShell verwendet die System.Management.Automation.VerbsOther-Klasse , um kanonische Verbnamen zu definieren, die nicht in eine bestimmte Verbnamenkategorie passen, z. B. allgemeine Verben, Kommunikationen, Daten, Lebenszyklus oder Verbnamen der Sicherheit.

Verb (Alias) Maßnahme Zu vermeidende Synonyme
Use (u) Verwendet oder enthält eine Ressource, um etwas zu tun.

Siehe auch

  • Last updated on