Como corrigir "o termo não é reconhecido como o nome de um cmdlet" no Windows PowerShell

PowerShell é um utilitário de linha de comando para uso no Windows que permite a execução de alguns aplicativos e scripts poderosos. Embora a GUI seja fácil de usar e faça o trabalho, um script rápido pode fazer muito mais em um tempo muito menor. Se você está executando rotinas em dezenas ou centenas de computadores, os scripts são um verdadeiro salva-vidas.

Como corrigir "o termo não é reconhecido como o nome de um cmdlet" no Windows PowerShell

Um ‘cmdlet’ é um script ou processo executado dentro do PowerShell, geralmente denotado por uma palavra, um hífen e outra palavra - por exemplo, Add-Computer ou Start-service. Assim como tudo nas linhas de comando do Powershell, obter a sintaxe exata é essencial.

Uma coisa que todos os produtos da Microsoft têm em comum são as notórias mensagens de erro quando algo dá errado. Em vez de falar em inglês simples para que todos possam entender, os programas da Microsoft fornecem alguns jargões indecifráveis ​​de que você precisa para usar o Google para compreender qualquer coisa. A mensagem de erro, “o termo não é reconhecido como o nome de um cmdlet,” no PowerShell, é uma dessas mensagens.

Como resolver o termo não é reconhecido no PowerShell

Se você já conhece o PowerShell, identifica facilmente o erro que gera a mensagem, “o termo não é reconhecido como o nome de um cmdlet”. Se você é novo no PowerShell, pode parecer algo sem sentido por um tempo.

Muitas coisas podem dar errado com um comando do PowerShell, mas três problemas específicos são os mais comuns: problemas de ortografia, caminho ou módulo. Quando você vir o erro “o termo não é reconhecido como o nome de um cmdlet”, provavelmente será um desses três problemas. Vamos dividi-los.

1. Verifique se há erros de ortografia no PowerShell

Se você soletrar algo errado, o PowerShell não será capaz de entender suas instruções e executá-las. Geralmente, esse cenário é o mais difícil de solucionar. Até mesmo obter um espaço errado pode atrapalhar o PowerShell. Quando essa situação ocorrer, é melhor destacar o texto de entrada para se destacar um pouco mais e depois percorrê-lo letra por letra.

Se houver muito texto ou a opção de realce não funcionar para você, copie o código para o Notepad ++ ou outro editor de texto simples e verifique a partir daí. Digite novamente as instruções / código se não houver erros e tente novamente. Não use o Word ou um editor de rich text enquanto bagunça a formatação. Use um editor de texto simples, como Notepad ou Notepad ++ (recomendado).

2. Verifique o caminho errado no PowerShell

Se você digitar o caminho errado, o PowerShell não conseguirá encontrar seu script ou módulo. Por exemplo, ao apontar o PowerShell para uma pasta específica e inserir a letra da unidade errada ou um compartilhamento que não está acessível, o PowerShell não será capaz de fazer seu trabalho.

Este cenário geralmente ocorre ao tentar executar um cmdlet em um computador remoto. Se esse computador estiver bloqueado ou não permitir a execução remota de scripts ou alterações específicas, ocorrerá um erro. Na maioria das situações, você pode fazer cmdlets remotamente, mas algumas organizações só permitem scripts de alto nível. Tudo o que altera a segurança, as políticas ou as configurações básicas é bloqueado. Nesse caso, você precisará executar o script localmente.

Você pode usar “resolve-path” ou verificar o caminho manualmente para ver se o seu comando é o problema.

3. Verifique se há módulos ausentes no PowerShell

Se o módulo estiver ausente ou danificado, o PowerShell não será capaz de executá-lo. Por padrão, você deve instalar os módulos na ordem exata para usá-los. Se esse módulo estiver ausente, corrompido ou movido, ele gerará o erro “o termo não é reconhecido como o nome de um cmdlet”.

Você pode usar “get-module” no PowerShell para ver se o módulo está presente e correto. Ele mostrará quais módulos estão carregados e você pode adicioná-los ou repará-los, dependendo de suas necessidades.

Para encerrar, não há nada de errado em um novato usar o PowerShell, contanto que você seja cuidadoso. Se você estiver usando em um computador doméstico, o pior que pode acontecer é que você precise restaurar ou reconstruir o sistema. Se você estiver trabalhando em computadores da empresa, talvez precise ser mais cuidadoso.

Se você é novo no uso do Powershell, não se deixe intimidar por ele. Crie um ponto de restauração do sistema antes de começar e experimente. A pior coisa que você pode fazer é arruinar a instalação do Windows, mas isso pode ser facilmente remediado para um usuário doméstico que tomou precauções primeiro!