Localizar cmdlets no PowerShell

  • 8 minutos

O PowerShell tem uma ajuda integrada extensa que normalmente inclui exemplos. Essa ajuda interna facilita o aprendizado de como usar um cmdlet. À medida que você começa a trabalhar com o PowerShell, encontrar o cmdlet de que você precisa pode ser um desafio. Por exemplo, qual cmdlet você usaria para definir um endereço IP em um adaptador de rede ou para desabilitar uma conta de usuário no Ative Directory?

Você pode começar usando o que sabe sobre a estrutura dos nomes de cmdlets, juntamente com o comando Get-Command ou o comando Get-Help . Get-Command recupera informações sobre um comando ou vários comandos, como o nome, categoria, versão e até mesmo o módulo que o contém. Get-Help recupera conteúdo de ajuda sobre o comando.

Como o comando Get-Help , Get-Command aceita caracteres curinga, o que significa que você pode executar o comando Get-Command *event* e recuperar uma lista de comandos que contêm o evento de texto no nome. Get-Command também tem vários parâmetros que você pode usar para filtrar ainda mais os resultados retornados. Por exemplo, pode usar os -Noun parâmetros e -Verb para filtrar as partes substantivo e verbo do nome, respetivamente.

Ambos os parâmetros aceitam curingas, embora na maioria dos casos você não precise usar curingas com verbos. Você pode até combinar os parâmetros para refinar ainda mais os resultados retornados. Executa o comando Get-Command -Noun event*-Verb Get para obter uma lista de comandos que têm substantivos a começar por event e que usam o verbo Get.

Quando você tentar identificar nomes de comando, tente usar apenas a parte nominal e considere apenas um substantivo singular de uma única palavra. Por exemplo, evento e log podem ser bons palpites quando você está tentando encontrar um comando que funciona com logs de eventos do Windows.

Usando módulos para descobrir cmdlets

Quando você usa o comando Get-Module , ele exibe uma lista parcial de cmdlets que o módulo referenciado contém. No entanto, é possível usar o módulo de forma diferente para localizar os seus cmdlets.

Por exemplo, se descobriu o módulo NetAdapter, esperaria que ele contivesse cmdlets que possa usar para gerir adaptadores de rede. Podes encontrar todos os comandos aplicáveis nesse módulo ao executar o comando Get-Command -Module NetAdapter . O -Module parâmetro restringe os resultados apenas aos comandos no módulo designado.

Usando Get-Help para descobrir cmdlets

Você pode realizar pesquisas semelhantes usando Get-Help, incluindo o uso de curingas. Uma vantagem de usar Get-Help em vez de Get-Command é que Get-Help executa uma pesquisa de texto completo usando sua cadeia de caracteres de consulta se não conseguir encontrar um nome de comando que corresponda. Se executares o comando Get-Command *bip* , não obténs resultados. Se executares o comando Get-Help *bip* , ele devolve vários resultados.

Você também pode consultar a seção Links relacionados de um cmdlet que você sabe que está relacionado ao que você está procurando. Esta secção do tópico de ajuda inclui cmdlets relacionados.

Localizando cmdlets na Internet

Você não está limitado a procurar cmdlets que o seu computador já tenha instalado. Você pode pesquisar na internet para encontrar uma ampla variedade de módulos e cmdlets da Microsoft e de outras fontes. Se você simplesmente pesquisar usando os termos PowerShell e a tecnologia com a qual está trabalhando, encontrará muitos links para artigos em sites da Microsoft e de outros sites. Praticamente todas as equipes da Microsoft criam cmdlets para uso no gerenciamento de seus produtos, e você pode instalá-los como parte de suas ferramentas de gerenciamento.

A Galeria do PowerShell é um repositório central para conteúdos relacionados com PowerShell, incluindo scripts e módulos. O Galeria do PowerShell utiliza o módulo PowerShell, PowerShellGet. Este módulo faz parte do Windows PowerShell 5.0 e mais recente.

PowerShellGet contém cmdlets para localizar e instalar módulos, scripts e comandos da galeria online. Por exemplo, o cmdlet Find-Command procura comandos, funções e aliases. Funciona de forma semelhante ao cmdlet Get-Command , incluindo suporte para wildcards.

Você pode passar os resultados do cmdlet Find-Command para o cmdlet Install-Module , que o módulo PowerShellGet também contém. Install-Module instalará o módulo que contém o cmdlet descoberto.

Note

Se estiveres a usar PowerShell 7.4 ou posterior, o módulo Microsoft.PowerShell.PSResourceGet está incluído como sucessor do PowerShellGet. Fornece cmdlets atualizados: Find-PSResource substitui Find-Command/Find-Module, e Install-PSResource substitui Install-Module. Ambos os módulos estão disponíveis lado a lado no PowerShell 7.4+, pelo que os scripts existentes que usam cmdlets PowerShellGet continuam a funcionar.

Leitura adicional: Para obter mais informações sobre a Galeria do PowerShell, consulte Galeria do PowerShell.