Freigeben über


Get-Verb

Ruft genehmigte PowerShell-Verben ab.

Syntax

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

Beschreibung

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

Es wird empfohlen, dass PowerShell-Cmdlet- und Funktionsnamen das Verb-Noun Format aufweisen und ein genehmigtes Verb enthalten. In dieser Übung werden Befehlsnamen konsistenter, vorhersehbarer und einfacher zu verwenden.

Befehle, die nicht genehmigte Verben verwenden, werden weiterhin 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       AliasPrefix Group     Description
----       ----------- -----     -----------
Undo       un          Common    Sets a resource to its previous state
Unlock     uk          Common    Releases a resource that was locked
Unpublish  ub          Data      Makes a resource unavailable to others
Uninstall  us          Lifecycle Removes a resource from an indicated location
Unregister ur          Lifecycle Removes the entry for a resource from a repository
Unblock    ul          Security  Removes restrictions to a resource
Unprotect  up          Security  Removes safeguards from a resource that were added to prevent it from attack or loss

Beispiel 3 : Abrufen aller genehmigten Verben in der Sicherheitsgruppe

Get-Verb -Group Security

Verb      AliasPrefix Group    Description
----      ----------- -----    -----------
Block     bl          Security Restricts access to a resource
Grant     gr          Security Allows access to a resource
Protect   pt          Security Safeguards a resource from attack or loss
Revoke    rk          Security Specifies an action that does not allow access to a resource
Unblock   ul          Security Removes restrictions to a resource
Unprotect up          Security Removes safeguards from a resource that were added to prevent it from attack or loss

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

-Group

Ruft nur die angegebenen Gruppen ab. Geben Sie den Namen einer Gruppe ein. Wildcards sind nicht zulässig.

Dieser Parameter wurde in PowerShell 6.0 eingeführt.

Typ:String[]
Zulässige Werte:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Position:1
Standardwert:All groups
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Verb

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

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

Eingaben

None

Sie können keine Objekte an dieses Cmdlet weiterleiten.

Ausgaben

VerbInfo

Hinweise

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.