Get-Verb

Referência

Módulo:: Microsoft.PowerShell.Utility

Obtém verbos aprovados do PowerShell.

Syntax

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

Description

A Get-Verb função obtém verbos aprovados para uso em comandos do PowerShell.

É recomendável que os nomes de cmdlet e função do PowerShell tenham o Verb-Noun formato e incluam um verbo aprovado. Essa prática torna os nomes de comando mais consistentes, previsíveis e mais fáceis de usar.

Os comandos que usam verbos não aprovados ainda são executados no PowerShell. No entanto, quando você importa um módulo que inclui um comando com um verbo não aprovado em seu nome, o Import-Module comando exibe uma mensagem de aviso.

Observação

A lista de verbos que Get-Verb retorna pode não estar concluída. Para obter uma lista atualizada de verbos aprovados do PowerShell com descrições, consulte Verbos Aprovados no Microsoft Docs.

Exemplos

Exemplo 1 – Obter uma lista de todos os verbos

Get-Verb

Exemplo 2 – Obter uma lista de verbos aprovados que começam com "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

Exemplo 3 – Obter todos os verbos aprovados no grupo segurança

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

Exemplo 4 – Localiza todos os comandos em um módulo que têm verbos não aprovados

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

Obtém apenas os grupos especificados. Insira o nome de um grupo. Curingas não são permitidos.

Esse parâmetro foi introduzido no PowerShell 6.0.

Type:	String[]
Position:	0
Default value:	All verbs
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Verb

Obtém somente os verbos especificados. Digite o nome de um verbo ou um padrão de nome. Caracteres curinga são permitidos.

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:	True

Entradas

None

Saídas

VerbInfo

Observações

Os verbos do PowerShell são atribuídos a um grupo com base em seu uso mais comum. Os grupos são projetados para facilitar a localização e a comparação com o uso dos verbos, não para impedir seu uso. Você pode usar qualquer verbo aprovado para qualquer tipo de comando.

Cada verbo do PowerShell é atribuído a um dos grupos a seguir.

Comum: defina ações genéricas que podem ser aplicadas a quase qualquer cmdlet, como Adicionar.
Comunicações: defina ações que se aplicam às comunicações, como o Connect.
Dados: defina ações que se aplicam ao tratamento de dados, como Backup.
Diagnóstico: defina ações que se aplicam ao diagnóstico, como Depurar.
Ciclo de vida: defina ações que se aplicam ao ciclo de vida de um cmdlet, como Complete.
Segurança: defina ações que se aplicam à segurança, como Revogar.
Outros: definir outros tipos de ações.

Alguns dos cmdlets instalados com o PowerShell, como Tee-Object e Where-Object, usam verbos não aprovados. Esses cmdlets são exceções históricas e seus verbos são classificados como reservados.

Import-Module