Get-Verb

Hämtar godkända PowerShell-verb.

Syntax

Default (Standard)

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

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.

Anmärkning

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.

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.

Parameteregenskaper

Typ:

String[]

Standardvärde:All verbs
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

(All)
Position:1
Obligatorisk:False
Värde från pipeline:True
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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 egenskaperna Verb och Group. Egenskapen Verb innehåller en sträng med verbnamnet. Egenskapen Group 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 installerats 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.