Delen via

Get-Verb

Module:
Microsoft.PowerShell.Utility Module

Hiermee worden goedgekeurde PowerShell-werkwoorden ophaalt.

Syntaxis

Default (Standaard) 

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 opdracht Import-Module een waarschuwingsbericht weergegeven.

Opmerking

De werkwoordenlijst die Get-Verb retourneert, is mogelijk niet voltooid. Zie Goedgekeurde werkwoordenvoor 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       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 uit de Security-groep ophalen

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. Wildcards zijn niet toegestaan.

Deze parameter is geïntroduceerd in PowerShell 6.0.

Parametereigenschappen

Type:

String[]

Default value:All groups
Geaccepteerde waarden:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:1
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Verb

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

Parametereigenschappen

Type:

String[]

Default value:All verbs
Ondersteunt jokertekens:True
DontShow:False

Parametersets

(All)
Position:0
Verplicht:False
Waarde uit pijplijn:True
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

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 de werkwoorden ervan worden geclassificeerd als gereserveerde.