Get-Verb

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee worden goedgekeurde PowerShell-werkwoorden ophaalt.

Syntax

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

Description

De Get-Verb functie haalt werkwoorden op die zijn goedgekeurd voor gebruik in PowerShell-opdrachten.

Het is raadzaam dat PowerShell-cmdlets en functienamen de Verb-Noun indeling hebben en een goedgekeurd werkwoord bevatten. Deze procedure maakt opdrachtnamen consistenter, voorspelbaarder en gemakkelijker te gebruiken.

Opdrachten die niet-goedgekeurde werkwoorden gebruiken, worden nog steeds uitgevoerd in PowerShell. Wanneer u echter een module importeert die een opdracht met een niet-goedgekeurde term in de naam bevat, wordt met de Import-Module opdracht een waarschuwingsbericht weergegeven.

Notitie

De lijst met werkwoorden die Get-Verb wordt geretourneerd, is mogelijk niet voltooid. Zie Goedgekeurde werkwoorden voor een bijgewerkte lijst met goedgekeurde PowerShell-werkwoorden met beschrijvingen.

Voorbeelden

Voorbeeld 1: Een lijst met alle werkwoorden ophalen

Get-Verb

Voorbeeld 2: Een lijst met goedgekeurde werkwoorden ophalen die beginnen met '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

Voorbeeld 3: alle goedgekeurde werkwoorden ophalen in de beveiligingsgroep

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

Voorbeeld 4: vindt alle opdrachten in een module met niet-goedgekeurde werkwoorden

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

Parameters

-Group

Hiermee haalt u alleen de opgegeven groepen op. Voer de naam van een groep in. Jokertekens zijn niet toegestaan.

Deze parameter is geïntroduceerd in 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

Hiermee haalt u alleen de opgegeven werkwoorden op. Voer de naam van een werkwoord of een naampatroon in. Jokertekens zijn toegestaan.

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

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

VerbInfo

Notities

PowerShell-woorden worden toegewezen aan een groep op basis van hun meest voorkomende gebruik. De groepen zijn ontworpen om de werkwoorden gemakkelijk te vinden en te vergelijken, niet om hun gebruik te beperken. U kunt elk goedgekeurd werkwoord gebruiken voor elk type opdracht.

Elk PowerShell-werkwoord wordt toegewezen aan een van de volgende groepen.

  • Algemeen: Algemene acties definiëren die kunnen worden toegepast op bijna elke cmdlet, zoals Toevoegen.
  • Communicatie: Definieer acties die van toepassing zijn op communicatie, zoals Verbinding maken.
  • Gegevens: Definieer acties die van toepassing zijn op gegevensverwerking, zoals Back-up.
  • Diagnostische gegevens: Definieer acties die van toepassing zijn op diagnostische gegevens, zoals Foutopsporing.
  • Levenscyclus: Definieer acties die van toepassing zijn op de levenscyclus van een cmdlet, zoals Voltooid.
  • Beveiliging: Definieer acties die van toepassing zijn op beveiliging, zoals Intrekken.
  • Overige: Andere typen acties definiëren.

Sommige cmdlets die zijn geïnstalleerd met PowerShell, zoals Tee-Object en Where-Object, gebruiken niet-goedgekeurde werkwoorden. Deze cmdlets zijn historische uitzonderingen en hun werkwoorden worden geclassificeerd als gereserveerd.