Leer en inglés

Compartir a través de

Get-Verb

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Obtiene verbos aprobados de PowerShell.

Sintaxis

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

Description

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

Se recomienda que los nombres de cmdlet y función de PowerShell 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 siguen ejecutando 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.

Ejemplos

Ejemplo 1: Obtener una lista de todos los verbos

PowerShell 
Get-Verb

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

PowerShell 
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

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

PowerShell 
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

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

PowerShell 
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

-Group

Obtiene solo los grupos especificados. Escriba el nombre de un grupo. No se permiten caracteres comodín.

Este parámetro se introdujo en PowerShell 6.0.

Tipo:String[]
Valores aceptados:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Posición:1
Valor predeterminado:All groups
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-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:0
Valor predeterminado:All verbs
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

VerbInfo

Notas

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