Partager via

Get-Verb

  • Référence
Module:
Microsoft.PowerShell.Utility

Obtient des verbes PowerShell approuvés.

Syntax

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

Description

La Get-Verb fonction obtient des verbes approuvés pour une utilisation dans les commandes PowerShell.

Il est recommandé que l’applet de commande PowerShell et les noms de fonction aient le Verb-Noun format et incluent un verbe approuvé. Cette pratique rend les noms de commande plus cohérents, prévisibles et plus faciles à utiliser.

Les commandes qui utilisent des verbes non approuvés s’exécutent toujours dans PowerShell. Toutefois, lorsque vous importez un module qui inclut une commande avec un verbe non approuvé dans son nom, la Import-Module commande affiche un message d’avertissement.

Notes

La liste de verbes qui Get-Verb retourne peut ne pas être complète. Pour obtenir la liste mise à jour des verbes PowerShell approuvés avec des descriptions, consultez Verbes approuvés.

Exemples

Exemple 1 - Obtenir la liste de tous les verbes

Get-Verb

Exemple 2 - Obtenir la liste des verbes approuvés qui commencent par « 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

Exemple 3 - Obtenir tous les verbes approuvés dans le groupe de sécurité

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

Exemple 4 - Recherche toutes les commandes d’un module qui ont des verbes non approuvés

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

Paramètres

-Group

Obtient uniquement les groupes spécifiés. Entrez le nom d’un groupe. Les caractères génériques ne sont pas autorisés.

Ce paramètre a été introduit dans 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

Obtient uniquement les verbes spécifiés. Entrez le nom d'un verbe ou d'un modèle de nom. Les caractères génériques sont autorisés.

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

Entrées

None

Vous ne pouvez pas diriger d’objets vers cette applet de commande.

Sorties

VerbInfo

Notes

Les verbes PowerShell sont attribués à un groupe en fonction de leur utilisation la plus courante. Les groupes sont conçus pour faciliter la recherche et la comparaison des verbes, sans limiter leur utilisation. Vous pouvez utiliser n'importe quel verbe approuvé pour n'importe quel type de commande.

Chaque verbe PowerShell est affecté à l’un des groupes suivants.

  • Courant : définissez des actions génériques qui peuvent s’appliquer à presque n’importe quelle applet de commande, comme Ajouter.
  • Communications : définissez les actions qui s’appliquent aux communications, telles que Connect.
  • Données : définissez des actions qui s’appliquent à la gestion des données, comme la sauvegarde.
  • Diagnostic : définissez des actions qui s’appliquent à diagnostics, telles que Déboguer.
  • Cycle de vie : définissez des actions qui s’appliquent au cycle de vie d’une applet de commande, comme Terminer.
  • Sécurité : définissez des actions qui s’appliquent à la sécurité, telles que Révoquer.
  • Autres : définissez d’autres types d’actions.

Certaines des applets de commande installées avec PowerShell, telles que Tee-Object et Where-Object, utilisent des verbes non approuvés. Ces applets de commande sont des exceptions historiques et leurs verbes sont classés comme réservés.