Examinar o módulo do PowerShellGet no Windows PowerShell

  • 7 minutos

O módulo PowerShellGet inclui cmdlets que servem para acessar e publicar itens na Galeria do PowerShell. Este módulo foi introduzido no Windows Management Framework 5.1, que está incluído em Windows 10 e Windows Server 2016. Windows PowerShell 5.1 vem com o PowerShellGet versão 1.0.0.1, que deve ser atualizado antes que você possa usá-lo de forma confiável com o Galeria do PowerShell. A versão atual com suporte para Windows PowerShell 5.1 é PowerShellGet 2.2.5.

Note

O PowerShell 7.4 e posterior é fornecido com Microsoft. PowerShell.PSResourceGet — o sucessor de última geração do PowerShellGet. Ele fornece a mesma funcionalidade principal por meio de cmdlets atualizados, como Find-PSResource e Install-PSResource. O PSResourceGet também está disponível para Windows PowerShell 5.1 do Galeria do PowerShell.

Ao usar os cmdlets no módulo PowerShellGet pela primeira vez, será necessário instalar o provedor NuGet. O NuGet é um gerenciador de pacotes que pode obter e instalar pacotes no Windows. Os cmdlets do módulo PowerShellGet usam a funcionalidade do NuGet para interagir com a Galeria do PowerShell.

A tabela a seguir lista os dois cmdlets usados com mais frequência para encontrar conteúdo na Galeria do PowerShell.

Tabela 1: Cmdlets usados para localizar conteúdo na Galeria do PowerShell

Cmdlet Descrição
Find-Module Use este cmdlet para pesquisar módulos do Windows PowerShell na Galeria do PowerShell. No seu mais simples, ele pesquisa pelo nome do módulo, mas você também pode pesquisar por nome de comando, versão, DscResource e RoleCapability.
Find-Script Use este cmdlet para pesquisar scripts do Windows PowerShell na Galeria do PowerShell. No seu mais simples, ele pesquisa por nome de script, mas você também pode pesquisar por versão.

Leitura adicional: Você também pode pesquisar módulos e scripts na Galeria do PowerShell.

TLS 1.2

A Galeria do PowerShell exige o uso do TLS 1.2 para proteger a comunicação. O Windows 10 e o Windows Server 2016 não dão suporte ao uso do TLS 1.2 no Windows PowerShell por padrão. Para baixar Galeria do PowerShell conteúdo, você precisa habilitar o TLS 1.2.

Para habilitar o TLS 1.2 para o prompt atual do PowerShell, execute o seguinte comando:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Para habilitar o TLS 1.2 permanentemente, crie as seguintes chaves do Registro:

Set-ItemProperty -Path 'HKLM:\SOFTWARE\Wow6432Node\Microsoft\.NetFramework\v4.0.30319'-Name 'SchUseStrongCrypto' -Value '1' -Type DWord

Set-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\.NetFramework\v4.0.30319' -Name 'SchUseStrongCrypto' -Value '1' -Type DWord

Você pode implementar uma galeria particular do PowerShell para a sua organização criando o seu próprio feed do NuGet. Você pode criar um feed do NuGet com um compartilhamento de arquivos ou um aplicativo na Web. Para registrar o feed do NuGet, use o cmdlet Register-PSRepository e especifique o local de origem. Depois de registrar o repositório, os usuários podem pesquisá-lo, assim como o Galeria do PowerShell.

Leitura adicional: Para obter mais informações sobre como criar um feed do NuGet, consulte Hospedar seus próprios feeds do NuGet.