Get-InstalledPSResource

  • Referência
Módulo:
Microsoft.PowerShell.PSResourceGet

Devolve módulos e scripts instalados no computador através do PowerShellGet.

Sintaxe

Get-InstalledPSResource
   [[-Name] <String[]>]
   [-Version <String>]
   [-Path <String>]
   [-Scope <ScopeType>]
   [<CommonParameters>]

Description

Este cmdlet procura os caminhos de instalação do módulo e do script e devolve objetos PSResourceInfo que descrevem cada item de recurso encontrado. Isto é equivalente à saída combinada dos Get-InstalledModule cmdlets e Get-InstalledScript do PowerShellGet v2.

Exemplos

Exemplo 1

Este exemplo devolve todas as versões dos módulos e scripts instalados no computador.

Get-InstalledPSResource

Exemplo 2

Este exemplo devolve todas as versões do módulo Az instalado com o PowerShellGet.

Get-InstalledPSResource Az

Exemplo 3

Este exemplo devolve todas as versões do módulo Az instaladas no diretório atual.

Get-InstalledPSResource Az -Path .

Exemplo 4

Este exemplo devolve uma versão específica do módulo Az se estiver instalado no sistema.

Get-InstalledPSResource Az -Version 9.4.0

Exemplo 5

Este exemplo devolve todas as versões instaladas do módulo Az dentro do intervalo de versões especificado.

Get-InstalledPSResource Az -Version "(1.0.0, 3.0.0)"

Exemplo 6

Este exemplo devolve uma versão de pré-visualização específica do módulo PowerShellGet se estiver instalado no sistema.

Get-InstalledPSResource PowerShellGet -Version 3.0.19-beta19

Name          Version Prerelease Repository Description
----          ------- ---------- ---------- -----------
PowerShellGet 3.0.19  beta19     PSGallery  PowerShell module with commands for discovering, installing, updating and p…

Exemplo 6

O exemplo anterior mostrou que a versão 3.0.14-beta14 do PowerShellGet foi instalada no sistema. Este exemplo mostra que tem de fornecer a versão completa, incluindo a etiqueta Pré-lançamento para identificar o módulo instalado por Versão.

Get-InstalledPSResource PowerShellGet -Version 3.0.19

Não existe nenhuma saída deste comando.

Exemplo 7

Neste exemplo, verá que existem quatro versões do PSReadLine instaladas no sistema. O segundo comando procura um intervalo de versões entre 2.2.0 e 2.3.0.

Get-InstalledPSResource PSReadLine

Name       Version Prerelease Repository Description
----       ------- ---------- ---------- -----------
PSReadLine 2.3.0   beta0      PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.6              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.5              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.2              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.0   beta4      PSGallery  Great command line editing in the PowerShell console host

Get-InstalledPSResource PSReadLine -Version '[2.2.0, 2.3.0]'

Name       Version Prerelease Repository Description
----       ------- ---------- ---------- -----------
PSReadLine 2.3.0   beta0      PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.6              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.5              PSGallery  Great command line editing in the PowerShell console host
PSReadLine 2.2.2              PSGallery  Great command line editing in the PowerShell console host

De acordo com as regras de versão do NuGet, uma versão de pré-lançamento é inferior a uma versão estável, pelo 2.2.0-beta4 que é menor do que a 2.2.0 versão no intervalo de versões especificado.

Parâmetros

-Name

Nome de um recurso a localizar. Os carateres universais são suportados, mas o NuGet só aceita o * caráter. O NuGet não suporta pesquisas de carateres universais de repositórios locais (baseados em ficheiros).

Tipo:String[]
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-Path

Especifica o caminho para procurar.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Scope

Especifica o âmbito do recurso.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valores aceites:CurrentUser, AllUsers
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Version

Especifica a versão do recurso a ser devolvido. O valor pode ser uma versão exata ou um intervalo de versões com a sintaxe de controlo de versões do NuGet.

Para obter mais informações sobre os intervalos de versões do NuGet, veja Controlo de versões do pacote.

O PowerShellGet suporta todas, exceto a versão inclusiva mínima listada na documentação do intervalo de versões do NuGet. Utilizar 1.0.0.0 como versão não produz as versões 1.0.0.0 e superiores (intervalo inclusivo mínimo). Em vez disso, considera-se que o valor é a versão necessária. Para procurar um intervalo inclusivo mínimo, utilize [1.0.0.0, ] como intervalo de versões.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

Entradas

String[]

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Notas

O módulo define Get-PSResource como um alias para Get-InstalledPSResource.