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. Anhängen, Anhängen, Verketten, Einfügen
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. Leeren, Löschen, Loslassen, Markierung aufheben, Aufheben, Annullieren
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. Duplizieren, Klonen, Replizieren, Synchronisieren
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, In
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. Aus- und Abdoppeln
Find (fd) Sucht nach einem Objekt in einem Container, der unbekannt, impliziert, optional oder angegeben ist. Suche
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. Lesen, Öffnen, Katze, Typ, Verzeichnis, Erhalten, Dump, Erwerben, Untersuchen, Suchen, Suchen
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. Kombinieren, Zusammenführen, Verbinden, Zuordnen
Lock (lk) Sichert eine Ressource. Dieses Verb ist mit Unlockgekoppelt. Einschränken, Sichern
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. Übertragen, Name, Migrieren
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.) Erstellen, Generieren, Erstellen, Erstellen, Zuordnen
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. Löschen, Ausschneiden, Verwerfen, Verwerfen, Löschen
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. Veränderung
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. Suchen, Suchen
Select (sc) Sucht eine Ressource in einem Container. Beispielsweise findet das Cmdlet Select-String Text in Zeichenfolgen und Dateien. Suchen, Suchen
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. Schreiben, Zurücksetzen, Zuweisen, Konfigurieren, Aktualisieren
Show (sh) Macht eine Ressource für den Benutzer sichtbar. Dieses Verb ist mit Hidegekoppelt. Anzeigen, Produzieren
Skip (sk) Umgeht eine oder mehrere Ressourcen oder Punkte in einer Sequenz. Umgehen, Springen
Split (sl) Trennt Teile einer Ressource. Beispielsweise gibt das Cmdlet Split-Path verschiedene Teile eines Pfads zurück. Dieses Verb ist mit Joingekoppelt. Trennen
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. Freigeben, Einschränken, Unsicher
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. Beitreten, Telnet, Anmeldung
Disconnect (dc) Hebt die Verknüpfung zwischen einer Quelle und einem Ziel auf. Dieses Verb ist mit Connectgekoppelt. Unterbrechung, Abmeldung
Read (rd) Erwirbt Informationen aus einer Quelle. Dieses Verb ist mit Writegekoppelt. Abrufen, Eingabeaufforderung, Abrufen
Receive (rc) Akzeptiert Informationen, die von einer Quelle gesendet werden. Dieses Verb ist mit Sendgekoppelt. Lesen, Annehmen, Vorschau
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. Setzen, Drucken

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. Speichern, Brennen, Replizieren, Synchronisieren
Checkpoint (ch) Erstellt eine Momentaufnahme des aktuellen Zustands der Daten oder seiner Konfiguration. Unterschiede
Compare (cr) Wertet die Daten aus einer Ressource anhand der Daten aus einer anderen Ressource aus. Unterschiede
Compress (cm) Komprimiert die Daten einer Ressource. Paare mit Expand. Kompakt
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. Ändern, Ändern der Größe, Neusampel
ConvertFrom (cf) Konvertiert einen primären Eingabetyp (das Cmdlet-Nomen gibt die Eingabe an) in einen oder mehrere unterstützte Ausgabetypen. Exportieren, Ausgabe, Auschecken
ConvertTo (ct) Konvertiert von einem oder mehreren Eingabetypen in einen primären Ausgabetyp (das Cmdlet-Substantiv gibt den Ausgabetyp an). Importieren, Eingeben, In
Dismount (dm) Trennt eine benannte Entität von einem Speicherort. Dieses Verb ist mit Mountgekoppelt. Aufheben der Bereitstellung, Aufheben der Verknüpfung
Edit (ed) Ändert vorhandene Daten durch Hinzufügen oder Entfernen von Inhalten. Ändern, Aktualisieren, Ändern
Expand (en) Stellt die Daten einer Ressource wieder her, die in den ursprünglichen Zustand komprimiert wurde. Dieses Verb ist mit Compressgekoppelt. Explodieren, Unkomprimieren
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. Extrahieren, Sichern
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, Laden
Initialize (in) Bereitet eine Ressource für die Verwendung vor und legt sie auf einen Standardzustand fest. Erase, Init, Renew, Rebuild, Reitialize, Setup
Limit (l) Wendet Einschränkungen auf eine Ressource an. Kontingent
Merge (mg) Erstellt eine einzelne Ressource aus mehreren Ressourcen. Kombinieren, Verknüpfen
Mount (mt) Fügt eine benannte Entität an einen Speicherort an. Dieses Verb ist mit Dismountgekoppelt. Verbinden
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. Bereitstellen, Freigeben, Installieren
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. Reparieren, Zurückgeben, Rückgängigmachen, Korrigieren
Save (sv) Behält Daten bei, um Verlust zu vermeiden.
Sync (sy) Stellt sicher, dass sich zwei oder mehr Ressourcen im selben Zustand befinden. Replizieren, Koerzen, Abgleichen
Unpublish (ub) Macht eine Ressource für andere nicht verfügbar. Dieses Verb ist mit Publishgekoppelt. Deinstallieren, Wiederherstellen, Ausblenden
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. Aktualisieren, Erneuern, Neu berechnen, Neuindizierung

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. Diagnostizieren
Measure (ms) Identifiziert Ressourcen, die von einem angegebenen Vorgang verbraucht werden, oder ruft Statistiken zu einer Ressource ab. Berechnen, Ermitteln, Analysieren
Ping (pi) Veraltet – Verwenden Sie stattdessen das Verb "Test".
Repair (rp) Stellt eine Ressource in einer verwendbaren Bedingung wieder her Fix, Wiederherstellen
Resolve (rv) Ordnet eine Kurzdarstellung einer Ressource einer umfassenderen Darstellung zu. Erweitern, Bestimmen
Test (t) Überprüft den Vorgang oder die Konsistenz einer Ressource. Diagnose, Analyse, Restwert, Überprüfen
Trace (tr) Verfolgt die Aktivitäten einer Ressource. Nachverfolgen, Folgen, Prüfen, Graben

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. Bescheinigen
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. Bestätigen, Bestätigen, Bestätigen, Zertifizieren, Überprüfen
Deny (dn) Lehnt den Zustand einer Ressource oder eines Prozesses ab oder lehnt sie ab. Block, Objekt, Ablehnen, Ablehnen
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. Anhalten, Ausblenden
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, Anfang
Install (is) Platziert eine Ressource an einem Speicherort und initialisiert sie optional. Dieses Verb ist mit Uninstallgekoppelt. Konfiguration
Invoke (i) Führt eine Aktion aus, z. B. ausführen eines Befehls oder einer Methode. Ausführen, 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. Recyceln
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. Starten, Initiieren, Starten
Stop (sp) Beendet eine Aktivität. Dieses Verb ist mit Startgekoppelt. Beenden, Beenden, Beenden
Submit (sb) Stellt eine Ressource zur Genehmigung dar. Bereitstellen
Suspend (ss) Hält eine Aktivität an. Beispielsweise hält das cmdlet Suspend-Service einen Dienst an. Dieses Verb ist mit Resumegekoppelt. Anhalten
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. Entfernen
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. Ruhezustand, Anhalten

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. Verhindern, Einschränken, Verweigern
Grant (gr) Ermöglicht den Zugriff auf eine Ressource. Dieses Verb ist mit Revokegekoppelt. Zulassen, Aktivieren
Protect (pt) Schützt eine Ressource vor Angriffen oder Verlusten. Dieses Verb ist mit Unprotectgekoppelt. Verschlüsseln, Schützen, Siegel
Revoke (rk) Gibt eine Aktion an, die den Zugriff auf eine Ressource nicht zulässt. Dieses Verb ist mit Grantgekoppelt. Entfernen, Deaktivieren
Unblock (ul) Entfernt Einschränkungen für eine Ressource. Dieses Verb ist mit Blockgekoppelt. Löschen, Zulassen
Unprotect (up) Entfernt Sicherheitsvorkehrungen von einer Ressource, die hinzugefügt wurde, um angriffe oder verluste zu verhindern. Dieses Verb ist mit Protectgekoppelt. Entschlüsselung, Nichteal

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