Get-Verb

  • Referens
Modul:
Microsoft.PowerShell.Utility

Hämtar godkända PowerShell-verb.

Syntax

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

Description

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

Vi rekommenderar att PowerShell-cmdleten och funktionsnamnen Verb-Noun har formatet 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 fortfarande 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 visas Import-Module ett varningsmeddelande.

Kommentar

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       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

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

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

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

-Group

Hämtar endast de angivna grupperna. Ange namnet på en grupp. Jokertecken tillåts inte.

Den här parametern introducerades i PowerShell 6.0.

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:False

-Verb

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

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

Indata

None

Du kan inte skicka objekt till den här cmdleten.

Utdata

VerbInfo

Kommentarer

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 och Where-Object, använder verb som Tee-Object inte godkänts. Dessa cmdletar är historiska undantag och deras verb klassificeras som reserverade.