Delen via

Get-Verb

  • Referentie
Module:
Microsoft.PowerShell.Core

Hiermee worden goedgekeurde PowerShell-werkwoorden ophaalt.

Syntaxis

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

Description

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

PowerShell raadt cmdlets en functienamen aan de Verb-Noun-indeling te hebben en een goedgekeurd werkwoord op te nemen. Deze procedure maakt opdrachtnamen consistenter, voorspelbaarder en gemakkelijker te gebruiken.

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

Notitie

De werkwoordenlijst die Get-Verb retourneert, is mogelijk niet voltooid. Zie Goedgekeurde werkwoorden in Microsoft Docs voor een bijgewerkte lijst met goedgekeurde PowerShell-woorden 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                 Group
----                 -----
Undo                 Common
Unlock               Common
Unpublish            Data
Uninstall            Lifecycle
Unregister           Lifecycle
Unblock              Security
Unprotect            Security

Voorbeeld 3: alle goedgekeurde werkwoorden ophalen in de beveiligingsgroep

Get-Verb | Where-Object Group -EQ Security

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

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

-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:1
Default value:All verbs
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

Invoerwaarden

None

Uitvoerwaarden

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Notities

Get-Verb retourneert een gewijzigde versie van een Microsoft.PowerShell.Commands.MemberDefinition-object. Het object heeft niet de standaardeigenschappen van een MemberDefinition-object. In plaats daarvan heeft het eigenschappen Werkwoord en Groep. De eigenschap Werkwoord bevat een tekenreeks met de werkwoordnaam. De eigenschap Groep bevat een tekenreeks met de werkwoordgroep.

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