Get-Verb
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 comando 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 aprobados de PowerShell 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 admiten 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
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 Connect.
- Datos: defina las acciones que se aplican al control de datos, como Backup.
- 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 Revocar.
- 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.