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-Noun 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 befehl Import-Module eine Warnmeldung an.

Anmerkung

Die Verbliste, die Get-Verb zurückgibt, ist möglicherweise nicht abgeschlossen. Eine aktualisierte Liste genehmigter PowerShell-Verben mit Beschreibungen finden Sie unter genehmigten 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 eines Namensmusters 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 es Verb-- und Group--Eigenschaften. Die Verb--Eigenschaft enthält eine Zeichenfolge mit dem Verbnamen. Die eigenschaft Group 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 konzipiert, dass die Verben leicht zu finden und zu vergleichen sind und nicht ihre Verwendung einschränken. Sie können jedes genehmigte Verb für einen beliebigen Befehlstyp 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. B. Tee-Object und Where-Object, verwenden nicht genehmigte Verben. Diese Cmdlets sind historische Ausnahmen, und ihre Verben werden als reserviertenklassifiziert.

Import-Module