Partager via

Get-Verb

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

Obtient les verbes PowerShell approuvés.

Syntaxe

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

Description

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

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

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

Note

La liste de verbes retournée Get-Verb peut ne pas être terminée. Pour obtenir une liste mise à jour des verbes PowerShell approuvés avec des descriptions, consultez verbes approuvés dans Microsoft Docs.

Exemples

Exemple 1 - Obtenir une liste de tous les verbes

Get-Verb

Exemple 2 - Obtenir une liste de verbes approuvés commençant 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[]
Position:0
Valeur par défaut:All verbs
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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[]
Valeurs acceptées:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Position:1
Valeur par défaut:All groups
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

Entrées

None

Sorties

VerbInfo

Notes

Les verbes PowerShell sont affecté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, et non pour 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.

  • Common : Définir des actions génériques qui peuvent s’appliquer à presque toutes les applets de commande, telles que Add.
  • Communications : Définissez des actions qui s’appliquent aux communications, telles que Connect.
  • Données : définissez des actions qui s’appliquent à la gestion des données, telles que la sauvegarde.
  • Diagnostic : définissez des actions qui s’appliquent aux diagnostics, telles que le débogage.
  • Cycle de vie : Définissez des actions qui s’appliquent au cycle de vie d’une applet de commande, par exemple Complete.
  • Sécurité : Définissez des actions qui s’appliquent à la sécurité, telles que Revoke.
  • Autre : Définir 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.