Dela via

Get-Verb

  • Referens
Modul:
Microsoft.PowerShell.Core

Hämtar godkända PowerShell-verb.

Syntax

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

Description

Funktionen Get-Verb hämtar verb som är godkända för användning i PowerShell-kommandon.

PowerShell rekommenderar att cmdlet- och funktionsnamn har Verb-Noun format och innehåller ett godkänt verb. Den här metoden gör kommandonamnen mer konsekventa, förutsägbara och enklare att använda.

Kommandon som använder icke godkända verb körs i PowerShell. Men när du importerar en modul som innehåller ett kommando med ett verb som inte har godkänts i dess namn, visar kommandot Import-Module ett varningsmeddelande.

Not

Verblistan som Get-Verb returnerar kanske inte är fullständig. En uppdaterad lista över godkända PowerShell-verb med beskrivningar finns i godkända verb i Microsoft Docs.

Exempel

Exempel 1 – Hämta en lista över alla verb

Get-Verb

Exempel 2 – Hämta en lista över godkända verb som börjar med "un"

Get-Verb un*

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

Exempel 3 – Hämta alla godkända verb i säkerhetsgruppen

Get-Verb | Where-Object Group -EQ Security

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

Exempel 4 – Hittar alla kommandon i en modul som har icke godkända verb

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

Parametrar

-verb

Hämtar endast de angivna verben. Ange namnet på ett verb eller ett namnmönster. Jokertecken tillåts.

Typ:String[]
Position:1
Standardvärde:All verbs
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:True

Indata

None

Utdata

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Kommentarer

Get-Verb returnerar en modifierad version av ett Microsoft.PowerShell.Commands.MemberDefinition-objekt. Objektet har inte standardegenskaperna för ett MemberDefinition-objekt. I stället har den verb- och gruppegenskaper. Verbegenskapen innehåller en sträng med verbnamnet. Egenskapen Grupp innehåller en sträng med verbgruppen.

PowerShell-verb tilldelas till en grupp baserat på deras vanligaste användning. Grupperna är utformade för att göra verben enkla att hitta och jämföra, inte för att begränsa användningen. Du kan använda alla godkända verb för alla typer av kommandon.

Varje PowerShell-verb tilldelas till någon av följande grupper.

  • Vanligt: Definiera allmänna åtgärder som kan tillämpas på nästan alla cmdletar, till exempel Lägg till.
  • Kommunikation: Definiera åtgärder som gäller för kommunikation, till exempel Anslut.
  • Data: Definiera åtgärder som gäller för datahantering, till exempel säkerhetskopiering.
  • Diagnostik: Definiera åtgärder som gäller för diagnostik, till exempel Felsökning.
  • Livscykel: Definiera åtgärder som gäller för livscykeln för en cmdlet, till exempel Slutför.
  • Säkerhet: Definiera åtgärder som gäller för säkerhet, till exempel Återkalla.
  • Övrigt: Definiera andra typer av åtgärder.

Några av de cmdletar som är installerade med PowerShell, till exempel Tee-Object och Where-Object, använder icke godkända verb. Dessa cmdletar är historiska undantag och deras verb klassificeras som reserverade.