Get-Verb

  • Referência
Módulo:
Microsoft.PowerShell.Core

Obtém verbos aprovados do PowerShell.

Sintaxe

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

Description

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

O PowerShell recomenda que os nomes de cmdlet e função tenham o formato Verbo-Substantivo e incluam um verbo aprovado. Essa prática torna os nomes de comando mais consistentes, previsíveis e fáceis de usar.

Os comandos que usam verbos não aprovados 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 completa. Para obter uma lista atualizada de verbos aprovados do PowerShell com descrições, consulte Verbos aprovados.

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                 Group
----                 -----
Undo                 Common
Unlock               Common
Unpublish            Data
Uninstall            Lifecycle
Unregister           Lifecycle
Unblock              Security
Unprotect            Security

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

Get-Verb | Where-Object Group -EQ Security

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

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

-Verb

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

Tipo:String[]
Cargo:1
Valor padrão:All verbs
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

Entradas

None

Saídas

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Observações

Get-Verb retorna uma versão modificada de um objeto Microsoft.PowerShell.Commands.MemberDefinition . O objeto não tem as propriedades padrão de um objeto MemberDefinition . Em vez disso, ele tem as propriedades Verb e Group . A propriedade Verb contém uma cadeia de caracteres com o nome do verbo. A propriedade Group contém uma cadeia de caracteres com o grupo de verbos.

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 Concluído.
  • Segurança: defina ações que se aplicam à segurança, como Revogar.
  • Outros: Defina 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.