Partilhar via

Comandos de Verbos Aprovados do PowerShell

O PowerShell usa um par verbo-substantivo para os nomes dos cmdlets e para suas classes .NET derivadas. A parte verbal do nome identifica a ação que o cmdlet executa. A parte nominal do nome identifica a entidade na qual a ação é executada. Por exemplo, o cmdlet Get-Command recupera todos os comandos registrados no PowerShell.

Observação

O PowerShell usa o termo verbo para descrever uma palavra que implica uma ação, mesmo que essa palavra não seja um verbo padrão no idioma inglês. Por exemplo, o termo New é um nome de verbo válido do PowerShell porque implica uma ação, mesmo que não seja um verbo no idioma inglês.

Cada verbo aprovado tem um prefixo de alias correspondente definido. Usamos esse prefixo de alias em aliases para comandos que usam esse verbo. Por exemplo, o prefixo de alias para Import é ip e, consequentemente, o alias para Import-Module é ipmo. Trata-se de uma recomendação, mas não de uma regra; em particular, ele não precisa ser respeitado para aliases de comando imitando comandos bem conhecidos de outros ambientes.

Recomendações de nomenclatura de verbos

As recomendações a seguir ajudam você a escolher um verbo apropriado para seu cmdlet, para garantir a consistência entre os cmdlets criados, os cmdlets fornecidos pelo PowerShell e os cmdlets criados por outras pessoas.

  • Usar um dos nomes de verbos predefinidos fornecidos pelo PowerShell
  • Use o verbo para descrever o escopo geral da ação e use parâmetros para refinar ainda mais a ação do cmdlet.
  • Não use sinônimo de verbo aprovado. Por exemplo, use sempre Remove, nunca use Delete ou Eliminate.
  • Use apenas a forma de cada verbo listado neste tópico. Por exemplo, use Get, mas não use Getting ou Gets.
  • Não use os seguintes verbos reservados ou pseudónimos. A linguagem PowerShell e alguns poucos cmdlets usam esses verbos em circunstâncias excecionais.
    • ForEach (foreach)
    • Ping (pi)
    • Sort (sr)
    • Tee (te)
    • Where (wh)

Você pode obter uma lista completa de verbos usando o cmdlet Get-Verb.

Verbos semelhantes para diferentes ações

Os seguintes verbos semelhantes representam ações diferentes.

New vs. Add

Use o verbo New para criar um novo recurso. Use o Add para adicionar algo a um contêiner ou recurso existente. Por exemplo, Add-Content adiciona saída a um arquivo existente.

New vs. Set

Use o verbo New para criar um novo recurso. Use o verbo Set para modificar um recurso existente, opcionalmente criando-o se ele não existir, como o Set-Variable cmdlet.

Use o verbo Find para procurar um objeto. Use o verbo Search para criar uma referência a um recurso em um contêiner.

Get vs. Read

Use o verbo Get para obter informações sobre um recurso (como um arquivo) ou para obter um objeto com o qual você pode acessar o recurso no futuro. Use o verbo Read para abrir um recurso e extrair informações contidas nele.

Invoke vs. Start

Use o verbo Invoke para executar operações síncronas, como executar um comando e esperar que ele termine. Use o verbo Start para iniciar operações assíncronas, como iniciar um processo autônomo.

Ping vs. Test

Use o verbo Test.

Verbos comuns

O PowerShell usa a classe de enumeração System.Management.Automation.VerbsCommon para definir ações genéricas que podem ser aplicadas a praticamente qualquer cmdlet. A tabela a seguir lista a maioria dos verbos definidos.

Verbo (alias) Ação Sinónimos a evitar
Add (a) Adiciona um recurso a um contêiner ou anexa um item a outro item. Por exemplo, o cmdlet Add-Content adiciona conteúdo a um arquivo. Este verbo é emparelhado com Remove. Acrescentar, Anexar, Concatenar, Inserir
Clear (cl) Remove todos os recursos de um contêiner, mas não exclui o contêiner. Por exemplo, o Clear-Content cmdlet remove o conteúdo de um arquivo, mas não o exclui. Liberar, Apagar, Liberar, Desmarcar, Desmarcar, Anular
Close (cs) Altera o estado de um recurso para torná-lo inacessível, indisponível ou inutilizável. Este verbo é emparelhado com Open.
Copy (cp) Copia um recurso para outro nome ou para outro contêiner. Por exemplo, o cmdlet Copy-Item copia um item (como um arquivo) de um local no armazenamento de dados para outro local. Duplicar, clonar, replicar, sincronizar
Enter (et) Especifica uma ação que permite que o usuário se mova para um recurso. Por exemplo, o cmdlet Enter-PSSession coloca o usuário em uma sessão interativa. Este verbo é emparelhado com Exit. Empurrar, para dentro
Exit (ex) Define o ambiente ou contexto atual para o contexto usado mais recentemente. Por exemplo, o cmdlet Exit-PSSession coloca o usuário na sessão que foi usada para iniciar a sessão interativa. Este verbo é emparelhado com Enter. Pop, Fora
Find (fd) Procura um objeto em um contêiner desconhecido, implícito, opcional ou especificado. Pesquisa
Format (f) Organiza objetos em um formulário ou layout especificado
Get (g) Especifica uma ação que recupera um recurso. Este verbo é emparelhado com Set. Ler, Abrir, Gato, Tipo, Dir, Obter, Despejar, Adquirir, Examinar, Localizar, Pesquisar
Hide (h) Torna um recurso indetetável. Por exemplo, um cmdlet cujo nome inclui o verbo Ocultar pode ocultar um serviço de um usuário. Este verbo é emparelhado com Show. Bloquear
Join (j) Combina recursos em um único recurso. Por exemplo, o cmdlet Join-Path combina um caminho com um de seus caminhos filho para criar um único caminho. Este verbo é emparelhado com Split. Combinar, Unir, Conectar, Associar
Lock (lk) Protege um recurso. Este verbo é emparelhado com Unlock. Restringir, Proteger
Move (m) Move um recurso de um local para outro. Por exemplo, o cmdlet Move-Item move um item de um local no armazenamento de dados para outro local. Transferir, Nomear, Migrar
New (n) Cria um recurso. (O verbo Set também pode ser usado ao criar um recurso que inclua dados, como o cmdlet Set-Variable.) Criar, Gerar, Construir, Criar, Alocar
Open (op) Altera o estado de um recurso para torná-lo acessível, disponível ou utilizável. Este verbo é emparelhado com Close.
Optimize (om) Aumenta a eficácia de um recurso.
Pop (pop) Remove um item da parte superior de uma pilha. Por exemplo, o cmdlet Pop-Location altera o local atual para o local que foi enviado mais recentemente para a pilha.
Push (pu) Adiciona um item à parte superior de uma pilha. Por exemplo, o cmdlet Push-Location envia o local atual para a pilha.
Redo (re) Redefine um recurso para o estado que foi desfeito.
Remove (r) Exclui um recurso de um contêiner. Por exemplo, o cmdlet Remove-Variable exclui uma variável e seu valor. Este verbo é emparelhado com Add. Limpar, cortar, eliminar, descartar, apagar
Rename (rn) Altera o nome de um recurso. Por exemplo, o cmdlet Rename-Item, que é usado para acessar dados armazenados, altera o nome de um item no armazenamento de dados. Alteração
Reset (rs) Define um recurso de volta ao seu estado original.
Resize(rz) Altera o tamanho de um recurso.
Search (sr) Cria uma referência a um recurso em um contêiner. Localizar, Localizar
Select (sc) Localiza um recurso em um contêiner. Por exemplo, o cmdlet Select-String localiza texto em cadeias de caracteres e arquivos. Localizar, Localizar
Set (s) Substitui dados em um recurso existente ou cria um recurso que contém alguns dados. Por exemplo, o cmdlet Set-Date altera a hora do sistema no computador local. (O verbo New também pode ser usado para criar um recurso.) Este verbo é emparelhado com Get. Escrever, Repor, Atribuir, Configurar, Atualizar
Show (sh) Torna um recurso visível para o usuário. Este verbo é emparelhado com Hide. Exibir, Produzir
Skip (sk) Ignora um ou mais recursos ou pontos em uma sequência. Desviar, Saltar
Split (sl) Separa partes de um recurso. Por exemplo, o cmdlet Split-Path retorna diferentes partes de um caminho. Este verbo é emparelhado com Join. Separar
Step (st) Move para o próximo ponto ou recurso em uma sequência.
Switch (sw) Especifica uma ação que alterna entre dois recursos, como alterar entre dois locais, responsabilidades ou estados.
Undo (un) Define um recurso para seu estado anterior.
Unlock (uk) Libera um recurso que estava bloqueado. Este verbo é emparelhado com Lock. Liberação, Sem restrições, Sem segurança
Watch (wc) Inspeciona ou monitora continuamente um recurso em busca de alterações.

Verbos de Comunicação

O PowerShell usa a classe System.Management.Automation.VerbsCommunications para definir ações que se aplicam às comunicações. A tabela a seguir lista a maioria dos verbos definidos.

Verbo (alias) Ação Sinónimos a evitar
Connect (cc) Cria um link entre uma origem e um destino. Este verbo é emparelhado com Disconnect. Aderir, Telnet, Login
Disconnect (dc) Quebra o vínculo entre uma origem e um destino. Este verbo é emparelhado com Connect. Pausa, Logoff
Read (rd) Adquire informações de uma fonte. Este verbo é emparelhado com Write. Adquirir, Solicitar, Obter
Receive (rc) Aceita informações enviadas de uma fonte. Este verbo é emparelhado com Send. Ler, Aceitar, Espreitar
Send (sd) Entrega informações a um destino. Este verbo é emparelhado com Receive. Colocar, Transmitir, Correio, Fax
Write (wr) Adiciona informações a um destino. Este verbo é emparelhado com Read. Colocar, Imprimir

Verbos de dados

O PowerShell usa a classe System.Management.Automation.VerbsData para definir ações que se aplicam ao tratamento de dados. A tabela a seguir lista a maioria dos verbos definidos.

Nome do verbo (alias) Ação Sinónimos a evitar
Backup (ba) Armazena dados replicando-os. Guardar, gravar, replicar, sincronizar
Checkpoint (ch) Cria um instantâneo do estado atual dos dados ou de sua configuração. Comparação
Compare (cr) Avalia os dados de um recurso em relação aos dados de outro recurso. Comparação
Compress (cm) Compacta os dados de um recurso. Emparelha com Expand. Compacto
Convert (cv) Altera os dados de uma representação para outra quando o cmdlet oferece suporte à conversão bidirecional ou quando o cmdlet oferece suporte à conversão entre vários tipos de dados. Alterar, redimensionar, reamostrar
ConvertFrom (cf) Converte um tipo primário de entrada (o substantivo do cmdlet indica a entrada) em um ou mais tipos de saída suportados. Exportação, Saída, Saída
ConvertTo (ct) Converte de um ou mais tipos de entrada para um tipo de saída primária (o substantivo do cmdlet indica o tipo de saída). Importação, Entrada, Em
Dismount (dm) Desanexa uma entidade nomeada de um local. Este verbo é emparelhado com Mount. Desmontar, Desvincular
Edit (ed) Modifica dados existentes adicionando ou removendo conteúdo. Alterar, Atualizar, Modificar
Expand (en) Restaura os dados de um recurso que foi compactado para seu estado original. Este verbo é emparelhado com Compress. Explodir, Descomprimir
Export (ep) Encapsula a entrada primária em um armazenamento de dados persistente, como um arquivo, ou em um formato de intercâmbio. Este verbo é emparelhado com Import. Extração, Backup
Group (gp) Organiza ou associa um ou mais recursos
Import (ip) Cria um recurso a partir de dados armazenados em um armazenamento de dados persistente (como um arquivo) ou em um formato de intercâmbio. Por exemplo, o Import-Csv cmdlet importa dados de um arquivo de valor (CSV) separado por vírgulas para objetos que podem ser usados por outros cmdlets. Este verbo é emparelhado com Export. BulkLoad, Carga
Initialize (in) Prepara um recurso para uso e o define como um estado padrão. Apagar, Iniciar, Renovar, Reconstruir, Reinicializar, Configurar
Limit (l) Aplica restrições a um recurso. Quota
Merge (mg) Cria um único recurso a partir de vários recursos. Combinar, Juntar-se
Mount (mt) Anexa uma entidade nomeada a um local. Este verbo é emparelhado com Dismount. Conectar
Out (o) Envia dados para fora do ambiente. Por exemplo, o cmdlet Out-Printer envia dados para uma impressora.
Publish (pb) Disponibiliza um recurso para outras pessoas. Este verbo é emparelhado com Unpublish. Implantar, Liberar, Instalar
Restore (rr) Define um recurso para um estado predefinido, como um estado definido por Checkpoint. Por exemplo, o cmdlet Restore-Computer inicia uma restauração do sistema no computador local. Reparar, Devolver, Desfazer, Corrigir
Save (sv) Preserva os dados para evitar perdas.
Sync (sy) Garante que dois ou mais recursos estão no mesmo estado. Replicar, Coagir, Combinar
Unpublish (ub) Torna um recurso indisponível para outras pessoas. Este verbo é emparelhado com Publish. Desinstalar, reverter, ocultar
Update (ud) Traz um recurso up-todata para manter seu estado, precisão, conformidade ou conformidade. Por exemplo, o cmdlet Update-FormatData atualiza e adiciona arquivos de formatação ao console atual do PowerShell. Atualizar, renovar, recalcular, reindexar

Verbos de diagnóstico

O PowerShell usa a classe System.Management.Automation.VerbsDiagnostic para definir ações que se aplicam ao diagnóstico. A tabela a seguir lista a maioria dos verbos definidos.

Verbo (alias) Ação Sinónimos a evitar
Debug (db) Examina um recurso para diagnosticar problemas operacionais. Diagnosticar
Measure (ms) Identifica recursos que são consumidos por uma operação especificada ou recupera estatísticas sobre um recurso. Calcular, Determinar, Analisar
Ping (pi) Preterido - Use o verbo Testar em vez disso.
Repair (rp) Restaura um recurso para uma condição utilizável Corrigir, Restaurar
Resolve (rv) Mapeia uma representação abreviada de um recurso para uma representação mais completa. Expandir, Determinar
Test (t) Verifica a operação ou a consistência de um recurso. Diagnosticar, Analisar, Salvar, Verificar
Trace (tr) Rastreia as atividades de um recurso. Rastrear, Seguir, Inspecionar, Escavar

Verbos do ciclo de vida

O PowerShell usa a classe System.Management.Automation.VerbsLifecycle para definir ações que se aplicam ao ciclo de vida de um recurso. A tabela a seguir lista a maioria dos verbos definidos.

Verbo (alias) Ação Sinónimos a evitar
Approve (ap) Confirma ou concorda com o status de um recurso ou processo.
Assert (as) Afirma o estado de um recurso. Certificar
Build (bd) Cria um artefato (geralmente um binário ou documento) a partir de algum conjunto de arquivos de entrada (geralmente código-fonte ou documentos declarativos). Este verbo foi adicionado no PowerShell 6.
Complete (cp) Conclui uma operação.
Confirm (cn) Reconhece, verifica ou valida o estado de um recurso ou processo. Reconhecer, Concordar, Certificar, Validar, Verificar
Deny (dn) Recusa, objeta, bloqueia ou se opõe ao estado de um recurso ou processo. Bloquear, Objetar, Recusar, Rejeitar
Deploy (dp) Envia um aplicativo, site ou solução para um destino remoto de tal forma que um consumidor dessa solução possa acessá-lo após a conclusão da implantação. Este verbo foi adicionado no PowerShell 6.
Disable (d) Configura um recurso para um estado indisponível ou inativo. Por exemplo, o cmdlet Disable-PSBreakpoint torna um ponto de interrupção inativo. Este verbo é emparelhado com Enable. Parar, Esconder
Enable (e) Configura um recurso para um estado disponível ou ativo. Por exemplo, o cmdlet Enable-PSBreakpoint torna ativo um ponto de interrupção. Este verbo é emparelhado com Disable. Iniciar, Começar
Install (is) Coloca um recurso em um local e, opcionalmente, o inicializa. Este verbo é emparelhado com Uninstall. Configuração
Invoke (i) Executa uma ação, como executar um comando ou um método. Executar, Iniciar
Register (rg) Cria uma entrada para um recurso em um repositório, como um banco de dados. Este verbo é emparelhado com Unregister.
Request (rq) Solicita um recurso ou pede permissões.
Restart (rt) Interrompe uma operação e, em seguida, inicia-a novamente. Por exemplo, o cmdlet Restart-Service para e, em seguida, inicia um serviço. Reciclar
Resume (ru) Inicia uma operação que foi suspensa. Por exemplo, o cmdlet Resume-Service inicia um serviço que foi suspenso. Este verbo é emparelhado com Suspend.
Start (sa) Inicia uma operação. Por exemplo, o cmdlet Start-Service inicia um serviço. Este verbo é emparelhado com Stop. Iniciar, Iniciar, Inicializar
Stop (sp) Descontinua uma atividade. Este verbo é emparelhado com Start. Terminar, Matar, Terminar, Cancelar
Submit (sb) Apresenta um recurso para aprovação. Publicar
Suspend (ss) Pausa uma atividade. Por exemplo, o cmdlet Suspend-Service pausa um serviço. Este verbo é emparelhado com Resume. Pausa
Uninstall (us) Remove um recurso de um local indicado. Este verbo é emparelhado com Install.
Unregister (ur) Remove a entrada de um recurso de um repositório. Este verbo é emparelhado com Register. Remover
Wait (w) Pausa uma operação até que ocorra um evento especificado. Por exemplo, o cmdlet Wait-Job pausa as operações até que um ou mais dos trabalhos em segundo plano sejam concluídos. Dormir, Pausa

Verbos de Segurança

O PowerShell usa a classe System.Management.Automation.VerbsSecurity para definir ações que se aplicam à segurança. A tabela a seguir lista a maioria dos verbos definidos.

Verbo (alias) Ação Sinónimos a evitar
Block (bl) Restringe o acesso a um recurso. Este verbo é emparelhado com Unblock. Prevenir, Limitar, Negar
Grant (gr) Permite o acesso a um recurso. Este verbo é emparelhado com Revoke. Permitir, Ativar
Protect (pt) Protege um recurso contra ataques ou perdas. Este verbo é emparelhado com Unprotect. Encriptar, Salvaguardar, Selar
Revoke (rk) Especifica uma ação que não permite acesso a um recurso. Este verbo é emparelhado com Grant. Remover, Desativar
Unblock (ul) Remove restrições a um recurso. Este verbo é emparelhado com Block. Limpar, Permitir
Unprotect (up) Remove as proteções de um recurso que foram adicionadas para evitar ataques ou perdas. Este verbo é emparelhado com Protect. Desencriptar, Deslacrar

Outros verbos

O PowerShell usa a classe System.Management.Automation.VerbsOther para definir nomes de verbos canônicos que não se encaixam em uma categoria específica de nome de verbo, como os verbos comuns, comunicações, dados, ciclo de vida ou nomes verbais de segurança.

Verbo (alias) Ação Sinónimos a evitar
Use (u) Usa ou inclui um recurso para fazer algo.

Ver também

  • Last updated on