Partilhar via

Get-InstalledPSResource

Módulo:
Microsoft.PowerShell.PSResourceGet Module

Retorna módulos e scripts instalados na máquina por meio do PowerShellGet.

Sintaxe

Default (Predefinição) 

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

Description

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

Exemplos

Exemplo 1

Este exemplo retorna todas as versões de módulos e scripts instalados na máquina.

Get-InstalledPSResource

Exemplo 2

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

Get-InstalledPSResource Az

Exemplo 3

Este exemplo retorna todas as versões do módulo Az instalado 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ões especificado.

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

Exemplo 6

Este exemplo retorna uma versão de 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 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á saída desse comando.

Exemplo 7

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

Parâmetros

-Name

Nome de um recurso a ser encontrado. Os curingas são suportados, mas o NuGet só aceita o caractere *. O NuGet não suporta pesquisas curinga de repositórios locais (baseados em arquivos).

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Path

Especifica o caminho para pesquisar.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Scope

Especifica o escopo do recurso.

Propriedades dos parâmetros

Tipo:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Default value:None
Valores aceites:CurrentUser, AllUsers
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Version

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

Para obter mais informações sobre intervalos de versões do NuGet, consulte Versionamento de pacotes.

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:True
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Notas

O módulo define os seguintes pseudónimos para Get-InstalledPSResource:

  • Get-PSResource
  • gres