Get-Verb

Referenz

Modul:: Microsoft.PowerShell.Utility

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 haben und ein genehmigtes Verb enthalten. Diese Vorgehensweise macht Befehlsnamen konsistenter, vorhersagbarer 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 im Namen enthält, zeigt der Import-Module Befehl eine Warnmeldung an.

Hinweis

Die zurückgegebene Get-Verb Verbliste ist möglicherweise nicht vollständig. Eine aktualisierte Liste der genehmigten PowerShell-Verben mit Beschreibungen finden Sie unter Genehmigte Verben im Microsoft-Dokumentation.

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, die nicht genehmigte Verben aufweisen

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.

Type:	String[]
Position:	0
Default value:	All verbs
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Verb

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

Type:	String[]
Accepted values:	Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Position:	1
Default value:	All groups
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

Eingaben

None

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.

Jedes PowerShell-Verb wird einer der folgenden Gruppen zugewiesen.

Allgemein: Definieren Sie generische Aktionen, die für fast jedes Cmdlet gelten können, z. B. Hinzufügen.
Kommunikation: Definieren Sie Aktionen, die für die 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 Diagnose gelten, z. B. Debuggen.
Lebenszyklus: Definieren Sie Aktionen, die für den Lebenszyklus eines Cmdlets gelten, z. B. Abschließen.
Sicherheit: Definieren Sie Aktionen, die für die Sicherheit gelten, z. B. Revoke.
Sonstiges: Definieren Sie andere Arten von Aktionen.

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

Import-Module