about_PSResourceGet

Artigo
12/04/2024

Descrição curta

Descreve como usar a versão 1.1.0-rc2 do módulo Microsoft.PowerShell.PSResourceGet.

Descrição longa

Microsoft.PowerShell.PSResourceGet é uma versão atualizada do módulo PowerShellGet completamente escrito em C#.

Esta versão do PowerShellGet se concentra em algumas áreas principais:

Simplificar a base de código facilitando o aprimoramento e a correção de bugs
Remova a dependência do módulo PackageManagement e use a biblioteca de do NuGet diretamente
Resolver problemas de usabilidade de longa data que estariam interrompendo alterações da v2
Manter a compatibilidade para scripts existentes gravados esperando v2 por meio de um módulo de compatibilidade separado
Melhorar o desempenho da pesquisa e da instalação

Alterações de design

As versões anteriores do PowerShellGet tinham comandos separados para trabalhar com módulos e scripts. Em Microsoft.PowerShell.PSResourceGet, todos os pacotes na Galeria do PowerShell são definidos como objetos PSResource.

A tabela a seguir mostra os cmdlets disponíveis no PowerShellGet v3 e seus equivalentes v2.

Microsoft.PowerShell.PSResourceGet	PowerShellGet v2
`Compress-PSResource`	n/a
`Find-PSResource`	`Find-Command`
`Find-PSResource`	`Find-DscResource`
`Find-PSResource`	`Find-Module`
`Find-PSResource`	`Find-Script`
n/a	`Find-RoleCapability`
`Get-InstalledPSResource`	`Get-InstalledModule`
`Get-InstalledPSResource`	`Get-InstalledScript`
`Get-PSResourceRepository`	`Get-PSRepository`
`Get-PSScriptFileInfo`	n/a
`Import-PSGetRepository`	n/a
`Install-PSResource`	`Install-Module`
`Install-PSResource`	`Install-Script`
`New-PSScriptFileInfo`	`New-ScriptFileInfo`
`Publish-PSResource`	`Publish-Module`
`Publish-PSResource`	`Publish-Script`
`Register-PSResourceRepository`	`Register-PSRepository`
`Save-PSResource`	`Save-Module`
`Save-PSResource`	`Save-Script`
`Set-PSResourceRepository`	`Set-PSRepository`
`Test-PSScriptFileInfo`	`Test-ScriptFileInfo`
`Uninstall-PSResource`	`Uninstall-Module`
`Uninstall-PSResource`	`Uninstall-Script`
`Unregister-PSResourceRepository`	`Unregister-PSRepository`
`Update-PSModuleManifest`	`Update-ModuleManifest`
`Update-PSResource`	`Update-Module`
`Update-PSResource`	`Update-Script`
`Update-PSScriptFileInfo`	`Update-ScriptFileInfo`

Pesquisando por intervalos de versão do NuGet

Vários cmdlets Microsoft.PowerShell.PSResourceGet fornecem um parâmetro de versão que permite especificar um intervalo de versões a serem pesquisadas. O parâmetro Version usa a sintaxe de controle de versão do NuGet. Para obter mais informações sobre intervalos de versões do NuGet, consulte de controle de versão do pacote.

O PowerShellGet dá suporte a todas as versão inclusiva mínima listada na documentação do intervalo de versões do NuGet. Usar 1.0.0.0 como a versão não produz as versões 1.0.0.0 e superior (intervalo inclusivo mínimo). Em vez disso, o valor é considerado a versão necessária. Para pesquisar um intervalo inclusivo mínimo, use [1.0.0.0, ] como o intervalo de versão.

Pesquisando por recursos necessários

O cmdlet Install-PSResource tem RequiredResource e parâmetros de RequiredResourceFile que são usados para localizar objetos PSResource que correspondem a critérios específicos. Você pode especificar os critérios de pesquisa usando um hashtable ou um objeto JSON. Para o parâmetro RequiredResourceFile, o hashtable é armazenado em um arquivo .psd1 e o objeto JSON é armazenado em um arquivo .json.

O hashtable pode conter atributos para vários módulos. O exemplo a seguir mostra a estrutura da especificação do módulo:

@{
    <modulename> = @{
        version = '<version-spcification>'
        repository = '<reponame>'
        prerelease = '<boolean>'
    }
}

Este exemplo contém especificações para três módulos. Como você pode, os atributos do módulo são opcionais.

 @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
    }

    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = $true
    }

    TestModule99 = @{}
}

O exemplo a seguir mostra a mesma especificação no formato JSON.

{
  "TestModule": {
    "version": "[0.0.1,1.3.0)",
    "repository": "PSGallery"
  },
  "TestModulePrerelease": {
    "version": "[0.0.0,0.0.5]",
    "repository": "PSGallery",
    "prerelease": "true"
  },
  "TestModule99": {}
}

Consulte também

Install-PSResource
Find-PSResource
get-installedPSResource
Install-PSResource
Save-PSResource
Uninstall-PSResource
Update-PSResource

Compartilhar via