Partilhar via

Get-Verb

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

Obtém verbos do PowerShell aprovados.

Sintaxe

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

Description

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

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

Tipo:String[]
Valores aceites:Common, Communications, Data, Diagnostic, Lifecycle, Other, Security
Position:1
Default value:All groups
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-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:0
Default value:All verbs
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

Entradas

None

Não é possível canalizar objetos para este cmdlet.

Saídas

VerbInfo

Notas

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.