Compartilhar via

Get-Verb

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

Obtém verbos aprovados do PowerShell.

Sintaxe

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 formato e incluam um verbo Verb-Noun 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 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 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       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. Digite o nome de um grupo. Curingas não são permitidos.

Esse parâmetro foi introduzido no PowerShell 6.0.

Tipo:String[]
Valores aceitos:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Cargo:1
Valor padrão:All groups
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-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:0
Valor padrão:All verbs
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

Entradas

None

Você não pode canalizar objetos para esse cmdlet.

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 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.