Partager via

Get-Verb

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

Obtient les verbes PowerShell approuvés.

Syntaxe

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

Description

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

PowerShell recommande les noms d’applets de commande et de fonction au format Verb-Noun et d’inclure 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 s’exécutent 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.

Remarque

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

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                 Group
----                 -----
Undo                 Common
Unlock               Common
Unpublish            Data
Uninstall            Lifecycle
Unregister           Lifecycle
Unblock              Security
Unprotect            Security

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

Get-Verb | Where-Object Group -EQ Security

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

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

-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:1
Valeur par défaut:All verbs
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

Entrées

None

Sorties

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Notes

Get-Verb retourne une version modifiée d’un objet Microsoft.PowerShell.Commands.MemberDefinition . L’objet ne possède pas les propriétés standard d’un objet MemberDefinition . Au lieu de cela, il possède des propriétés Verbe et Groupe . La propriété Verb contient une chaîne portant le nom du verbe. La propriété Group contient une chaîne avec le groupe de verbes.

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

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