Get-Verb

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Obtiene verbos aprobados de PowerShell.

Syntax

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

Description

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

Se recomienda que los nombres de cmdlet y función de PowerShell tengan el Verb-Noun formato 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 Import-Module comando muestra un mensaje de advertencia.

Nota:

Es posible que la lista de verbos que Get-Verb devuelve 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

Get-Verb

Ejemplo 2: Obtener una lista de verbos aprobados que comienzan por "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

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

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

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.

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

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

Type:String[]
Position:0
Default value:All verbs
Required:False
Accept pipeline input:True
Accept wildcard characters: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 que sea más fácil buscar y comparar los verbos, no para restringir su uso. Puede utilizar 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 reservados.