Freigeben über

Get-Verb

  • Referenz
Modul:
Microsoft.PowerShell.Core

Ruft genehmigte PowerShell-Verben ab.

Syntax

Get-Verb
   [[-verb] <String[]>]
   [<CommonParameters>]

Beschreibung

Die Get-Verb Funktion ruft Verben ab, die für die Verwendung in PowerShell-Befehlen genehmigt sind.

PowerShell empfiehlt Cmdlets und Funktionsnamen mit dem Verb-Nomen-Format und schließen ein genehmigtes Verb ein. In dieser Übung werden Befehlsnamen konsistenter, vorhersehbarer und einfacher zu verwenden.

Befehle, die nicht genehmigte Verben verwenden, werden in PowerShell ausgeführt. Wenn Sie jedoch ein Modul importieren, das einen Befehl mit einem nicht genehmigten Verb in seinem Namen enthält, zeigt der Import-Module Befehl eine Warnmeldung an.

Hinweis

Die zurückgegebene Verbliste Get-Verb ist möglicherweise nicht abgeschlossen. Eine aktualisierte Liste genehmigter PowerShell-Verben mit Beschreibungen finden Sie unter Genehmigte Verben.

Beispiele

Beispiel 1 : Abrufen einer Liste aller Verben

Get-Verb

Beispiel 2 : Abrufen einer Liste genehmigter Verben, die mit "un" beginnen

Get-Verb un*

Verb                 Group
----                 -----
Undo                 Common
Unlock               Common
Unpublish            Data
Uninstall            Lifecycle
Unregister           Lifecycle
Unblock              Security
Unprotect            Security

Beispiel 3 : Abrufen aller genehmigten Verben in der Sicherheitsgruppe

Get-Verb | Where-Object Group -EQ Security

Verb      Group
----      -----
Block     Security
Grant     Security
Protect   Security
Revoke    Security
Unblock   Security
Unprotect Security

Beispiel 4 : Sucht alle Befehle in einem Modul mit nicht genehmigten Verben

Get-Command -Module Microsoft.PowerShell.Utility | Where-Object Verb -NotIn (Get-Verb).Verb

CommandType     Name            Version    Source
-----------     ----            -------    ------
Cmdlet          Sort-Object     3.1.0.0    Microsoft.PowerShell.Utility
Cmdlet          Tee-Object      3.1.0.0    Microsoft.PowerShell.Utility

Parameter

-Verb

Ruft nur die angegebenen Verben ab. Geben Sie den Namen eines Verbs oder ein Namensmuster ein. Wildcards sind zulässig.

Typ:String[]
Position:1
Standardwert:All verbs
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

Eingaben

None

Ausgaben

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Hinweise

Get-Verb gibt eine geänderte Version eines Microsoft.PowerShell.Commands.MemberDefinition -Objekts zurück. Das Objekt verfügt nicht über die Standardeigenschaften eines MemberDefinition-Objekts . Stattdessen enthält sie Verb - und Gruppeneigenschaften . Die Verb-Eigenschaft enthält eine Zeichenfolge mit dem Verbnamen. Die Group-Eigenschaft enthält eine Zeichenfolge mit der Verbgruppe.

PowerShell-Verben werden einer Gruppe basierend auf ihrer am häufigsten verwendeten Verwendung zugewiesen. Die Gruppen sind so gestaltet, dass die Verben leicht zu finden und zu vergleichen sind, nicht um ihre Verwendung zu beschränken. Sie können alle genehmigten Verben für jeden Typ von Befehl verwenden.

Jedem PowerShell-Verb wird eine der folgenden Gruppen zugewiesen.

  • Allgemein: Definieren Sie generische Aktionen, die auf fast jedes Cmdlet angewendet werden können, z. B. "Hinzufügen".
  • Kommunikation: Definieren Sie Aktionen, die für Kommunikation gelten, z. B. "Verbinden".
  • Daten: Definieren Sie Aktionen, die für die Datenverarbeitung gelten, z. B. Sicherung.
  • Diagnose: Definieren Sie Aktionen, die für die Diagnose gelten, z. B. "Debuggen".
  • Lebenszyklus: Definieren Sie Aktionen, die für den Lebenszyklus eines Cmdlets gelten, z. B. "Abgeschlossen".
  • Sicherheit: Definieren Sie Aktionen, die für die Sicherheit gelten, z. B. "Widerrufen".
  • Andere: Definieren sie andere Arten von Aktionen.

Einige der mit PowerShell installierten Cmdlets, z Tee-Object . B. und Where-Object, verwenden nicht genehmigte Verben. Diese Cmdlets sind historische Ausnahmen, und ihre Verben werden als reserviert klassifiziert.