Get-Verb
Obtém verbos aprovados do PowerShell.
Sintaxe
Default (Default)
Get-Verb
[[-Verb] <String[]>]
[[-Group] <String[]>]
[<CommonParameters>]
Description
A função Get-Verb 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 Verb-Noun 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 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 comando Import-Module 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.
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.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | All groups |
| Valores aceitos: | Common, Communications, Data, Diagnostic, Lifecycle, Other, Security |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Verb
Obtém apenas os verbos especificados. Insira o nome de um verbo ou um padrão de nome. Curingas são permitidos.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | All verbs |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Não é possível transferir 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 dos verbos, 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 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 à comunicação, como Conectar.
- Dados: defina ações que se aplicam ao tratamento de dados, como Backup.
- Diagnóstico: defina ações que se apliquem 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 apliquem à segurança, como Revogar.
- Outro: 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 considerados exceções históricas e seus verbos são classificados como reservados.