Compartir a través de

Get-Verb

  • Referencia
Módulo:
Microsoft.PowerShell.Core

Obtiene verbos aprobados de PowerShell.

Sintaxis

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

Description

La función Get-Verb obtiene verbos aprobados para su uso en comandos de PowerShell.

PowerShell recomienda que los nombres de cmdlet y función tengan el formato Verb-Noun e incluyan un verbo aprobado. Esta práctica hace que los nombres de comandos sean más coherentes, predecibles y fáciles de usar.

Los comandos que usan verbos no aprobados se ejecutan en PowerShell. Sin embargo, al importar un módulo que incluye un comando con un verbo no aprobado en su nombre, el comando Import-Module muestra un mensaje de advertencia.

Nota

Es posible que la lista de verbos que Get-Verb devuelva no esté completa. Para obtener una lista actualizada de verbos de PowerShell aprobados con descripciones, consulte verbos aprobados en Microsoft Docs.

Ejemplos

Ejemplo 1: Obtener una lista de todos los verbos

Get-Verb

Ejemplo 2: Obtener una lista de verbos aprobados que comienzan por "un"

Get-Verb un*

Verb                 Group
----                 -----
Undo                 Common
Unlock               Common
Unpublish            Data
Uninstall            Lifecycle
Unregister           Lifecycle
Unblock              Security
Unprotect            Security

Ejemplo 3: Obtención de todos los verbos aprobados en el grupo seguridad

Get-Verb | Where-Object Group -EQ Security

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

Ejemplo 4: busca todos los comandos de un módulo que tienen verbos no aprobados

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

Parámetros

-verb

Obtiene solo los verbos especificados. Escriba el nombre de un verbo o un patrón de nombre. Se permiten caracteres comodín.

Tipo:String[]
Posición:1
Valor predeterminado:All verbs
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

Entradas

None

Salidas

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Notas

Get-Verb devuelve una versión modificada de un objeto Microsoft.PowerShell.Commands.MemberDefinition. El objeto no tiene las propiedades estándar de un objeto MemberDefinition. En su lugar, tiene propiedades Verb y Group. La propiedad Verb contiene una cadena con el nombre del verbo. La propiedad Group contiene una cadena con el grupo de verbos.

Los verbos de PowerShell se asignan a un grupo en función de su uso más común. Los grupos están diseñados para facilitar la búsqueda y comparación de los verbos, no para restringir su uso. Puede usar cualquier verbo aprobado para cualquier tipo de comando.

Cada verbo de PowerShell se asigna a uno de los siguientes grupos.

  • Común: defina acciones genéricas que se pueden aplicar a casi cualquier cmdlet, como Agregar.
  • Comunicaciones: defina las acciones que se aplican a las comunicaciones, como Conectar.
  • Datos: defina las acciones que se aplican al control de datos, como Copia de seguridad.
  • Diagnóstico: defina las acciones que se aplican a los diagnósticos, como Depurar.
  • Ciclo de vida: defina las acciones que se aplican al ciclo de vida de un cmdlet, como Complete.
  • Seguridad: defina las acciones que se aplican a la seguridad, como Revoke.
  • Otro: defina otros tipos de acciones.

Algunos de los cmdlets que se instalan con PowerShell, como Tee-Object y Where-Object, usan verbos no aprobados. Estos cmdlets son excepciones históricas y sus verbos se clasifican como reservado.