Compartilhar via


Get-InstalledPSResource

Retorna módulos e scripts instalados no computador por meio do PowerShellGet.

Sintaxe

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

Description

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

Exemplos

Exemplo 1

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

Get-InstalledPSResource

Exemplo 2

Este exemplo retorna todas as versões do módulo Az instaladas usando o PowerShellGet.

Get-InstalledPSResource Az

Exemplo 3

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

Get-InstalledPSResource Az -Path .

Exemplo 4

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

Get-InstalledPSResource Az -Version 9.4.0

Exemplo 5

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

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

Exemplo 6

Este exemplo retorna uma versão prévia específica do módulo PowerShellGet se ele 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 o PowerShellGet versão 3.0.14-beta14 foi instalado no sistema. Este exemplo mostra que você deve fornecer a versão completa, incluindo o rótulo De pré-lançamento para identificar o módulo instalado por Versão.

Get-InstalledPSResource PowerShellGet -Version 3.0.19

Não há nenhuma saída desse comando.

Exemplo 7

Neste exemplo, você verá que há quatro versões do PSReadLine instaladas no sistema. O segundo comando pesquisa um intervalo de versão 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 é menor que uma versão estável, portanto 2.2.0-beta4 , é menor que a 2.2.0 versão no intervalo de versão especificado.

Parâmetros

-Name

Nome de um recurso a ser localizado. Há suporte para curingas, mas o NuGet aceita apenas o * caractere. O NuGet não dá suporte a pesquisas curinga de repositórios locais (baseados em arquivo).

Tipo:String[]
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:True

-Path

Especifica o caminho no qual pesquisar.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Scope

Especifica o escopo do recurso.

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Valores aceitos:CurrentUser, AllUsers
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Version

Especifica a versão do recurso a ser retornado. O valor pode ser uma versão exata ou um intervalo de versão usando a sintaxe de controle de versão do NuGet.

Para obter mais informações sobre intervalos de versão do NuGet, consulte Controle de versão do pacote.

O PowerShellGet dá suporte a todas as versões inclusivas mínimas listadas na documentação do intervalo de versões do NuGet. Usar 1.0.0.0 como a versão não gera versões 1.0.0.0 e superiores (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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:True

Entradas

String[]

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Observações

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