Partilhar via

Get-Verb

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

Obtém verbos do PowerShell aprovados.

Sintaxe

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

Description

A Get-Verb função obtém verbos que são 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.

Nota

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 apenas os verbos especificados. Digite o nome de um verbo ou um padrão de nome. Curingas são permitidos.

Tipo:String[]
Position:1
Default value:All verbs
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

Entradas

None

Saídas

Selected.Microsoft.PowerShell.Commands.MemberDefinition

Notas

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, tem 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 verbo group.

Os verbos do PowerShell são atribuídos a um grupo com base em seu uso mais comum. Os grupos são projetados para tornar os verbos fáceis de encontrar e comparar, não para restringir seu uso. Você pode usar qualquer verbo aprovado para qualquer tipo de comando.

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

  • Comum: defina ações genéricas que podem ser aplicadas a praticamente qualquer cmdlet, como Add.
  • Comunicações: defina ações que se aplicam a comunicações, como Conectar.
  • Dados: defina ações que se apliquem ao tratamento de dados, como Backup.
  • Diagnóstico: defina ações que se aplicam a diagnósticos, 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 apliquem à 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.