Find-PSResource

Referência

Módulo:: Microsoft.PowerShell.PSResourceGet

Pesquisa pacotes de um repositório (local ou remoto), com base em um nome ou outras propriedades de pacote.

Sintaxe

Find-PSResource
    [[-Name] <String[]>]
    [-Type <ResourceType>]
    [-Version <String>]
    [-Prerelease]
    [-Tag <String[]>]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-IncludeDependencies]
    [<CommonParameters>]

Find-PSResource
    [-Prerelease]
    -CommandName <String[]>
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Find-PSResource
    [-Prerelease]
    -DscResourceName <String[]>
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

Description

O Find-PSResource cmdlet pesquisa um pacote de um repositório (local ou remoto) com base em um nome ou outras propriedades de pacote.

Exemplos

Exemplo 1

Este exemplo pesquisa Galeria do PowerShell para o pacote do PowerShellGet. O cmdlet retorna a versão não pré-lançamento mais alta.

Find-PSResource -Name PowerShellGet -Repository PSGallery

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

Exemplo 2

Este exemplo pesquisa Galeria do PowerShell para o pacote do PowerShellGet, incluindo versões de pré-lançamento.

Find-PSResource -Name PowerShellGet -Repository PSGallery -Prerelease

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

Exemplo 3

Este exemplo pesquisa Galeria do PowerShell para o pacote Microsoft.PowerShell.SecretManagement. O cmdlet retorna todas as versões que atendem ao intervalo de versão especificado.

$parameters = @{
    Name = 'Microsoft.PowerShell.SecretManagement'
    Version = '(0.9.0.0, 1.2.0.0]'
    Repository = 'PSGallery'
    Prerelease = $true
}
Find-PSResource @parameters

Name                                  Version Prerelease Repository Description
----                                  ------- ---------- ---------- -----------
Microsoft.PowerShell.SecretManagement 1.1.2              PSGallery  …
Microsoft.PowerShell.SecretManagement 1.1.1              PSGallery  …
Microsoft.PowerShell.SecretManagement 1.1.0   preview2   PSGallery  …
Microsoft.PowerShell.SecretManagement 1.1.0   preview    PSGallery  …
Microsoft.PowerShell.SecretManagement 1.1.0              PSGallery  …
Microsoft.PowerShell.SecretManagement 1.0.1              PSGallery  …
Microsoft.PowerShell.SecretManagement 1.0.0              PSGallery  …
Microsoft.PowerShell.SecretManagement 0.9.1              PSGallery  …

Exemplo 4

Este exemplo pesquisa todos os recursos de módulo que contêm o CommandName de Get-TargetResource. O cmdlet retorna todos os recursos do módulo que incluem o comando .

Find-PSResource -CommandName Get-TargetResource -Repository PSGallery

Name                 Package Name               Version
----                 ------------               -------
{Get-TargetResource} cRegFile                   1.2
{Get-TargetResource} cVNIC                      1.0.0.0
{Get-TargetResource} cWindowsErrorReporting     1.1
{Get-TargetResource} OctopusDSC                 4.0.1131
{Get-TargetResource} supVsts                    1.1.17.0
{Get-TargetResource} SystemLocaleDsc            1.2.0.0
{Get-TargetResource} WindowsDefender            1.0.0.4
{Get-TargetResource} xInternetExplorerHomePage  1.0.0
{Get-TargetResource} xPowerShellExecutionPolicy 3.1.0.0

Exemplo 5

Este exemplo pesquisa todos os recursos de módulo que contêm o recurso SystemLocaleDSC .

Find-PSResource -DscResourceName SystemLocale -Repository PSGallery

Name           Package Name          Version
----           ------------          -------
{SystemLocale} ComputerManagementDsc 9.0.0
{SystemLocale} SystemLocaleDsc       1.2.0.0

Exemplo 6

Este exemplo pesquisa todos os PSResourceRepositories registrados em busca de recursos com nomes começando com Computer.

Find-PSResource -Name Computer*

Name                                              Version Prerelease Repository Description
----                                              ------- ---------- ---------- -----------
ComputerManagementDsc                             9.0.0              PSGallery  DSC resources for configuration of a Wi…
ComputerManagement                                1.1.2.3            PSGallery  A PowerShell module for working with th…
ComputerCleanup                                   1.2.0              PSGallery  Module for freeing up disk space / remo…
Computer_UnjoinDomainAndJoinWorkgroup_Config      1.0.0              PSGallery  This example switches the computer 'Ser…
Computer_SetComputerDescriptionInWorkgroup_Config 1.0.0              PSGallery  This example will set the computer desc…
Computer_RenameComputerInWorkgroup_Config         1.0.0              PSGallery  This example will set the machine name …
Computer_RenameComputerInDomain_Config            1.0.0              PSGallery  This example will change the machines n…
Computer_RenameComputerAndSetWorkgroup_Config     1.0.0              PSGallery  This configuration will set the compute…
Computer_JoinDomainSpecifyingDC_Config            1.0.0              PSGallery  This configuration sets the machine nam…
Computer_JoinDomain_Config                        1.0.0              PSGallery  This configuration sets the machine nam…

Exemplo 7

Este exemplo mostra como localizar módulos por uma marca. O CrescendoBuilt valor é uma marca que é adicionada automaticamente aos módulos criados usando o módulo Microsoft.PowerShell.Crescendo .

Find-PSResource -Tag CrescendoBuilt

Name            Version Prerelease Repository Description
----            ------- ---------- ---------- -----------
AptPackage      0.0.2              PSGallery  PowerShell Crescendo-generated Module to query APT-Package Information
Cobalt          0.4.0              PSGallery  A PowerShell Crescendo wrapper for WinGet
Croze           0.0.5              PSGallery  A PowerShell Crescendo wrapper for Homebrew
Foil            0.3.0              PSGallery  A PowerShell Crescendo wrapper for Chocolatey
Image2Text      1.0.2              PSGallery  PowerShell Images into ASCII art
pastel          1.0.1              PSGallery  PowerShell commands for pastel
PSDupes         0.0.1              PSGallery  A crescendo module to locate duplicate files. Very fast and easy to use, …
psFilesCli      0.0.3              PSGallery  A PowerShell wrapper for files-cli.exe
PSLogParser     0.0.2              PSGallery  Crescendo Powershell module for Log Parser 2.2
Quser.Crescendo 0.1.3              PSGallery  This module displays session information of users logged onto a local or …
RoboCopy        1.0.1              PSGallery  PowerShell cmdlet for the official RoboCopy.exe
SpeedTest-CLI   1.0.1              PSGallery  PowerShell cmdlets for Internet Speed Test
SpeedTestCLI    1.0.0              PSGallery  PowerShell cmdlets speedtest-cli
SysInternals    1.1.0              PSGallery  PowerShell cmdlets for SysInternal tools
Takeown         1.0.2              PSGallery  Crescendo Powershell wrapper of takeown.exe
TShark          1.0.2              PSGallery  PowerShell cmdlet for tshark.exe
VssAdmin        0.8.0              PSGallery  This is a Crescendo module to wrap the Windows `vssadmin.exe` command-lin…

Parâmetros

-CommandName

O nome do comando a ser pesquisado.

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

-Credential

Credenciais opcionais a serem usadas ao acessar um repositório.

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

-DscResourceName

O nome do recurso DSC a ser pesquisado.

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

-IncludeDependencies

Quando especificado, a pesquisa retorna todos os recursos correspondentes de suas dependências. As dependências são duplicadas.

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

-Name

Nome de um recurso a ser encontrado. 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

-Prerelease

Quando especificado, inclui versões de pré-lançamento nos resultados da pesquisa retornados.

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

-Repository

Especifica um ou mais nomes de repositório a serem pesquisados. Se não for especificado, a pesquisa incluirá todos os repositórios registrados, em ordem de prioridade (primeiro mais alto), até que um repositório seja encontrado que contenha o pacote. Os repositórios são classificados por prioridade e, em seguida, por nome. Os valores de Prioridade Mais Baixa têm uma precedência mais alta.

Ao pesquisar recursos em vários repositórios, os cmdlets PSResourceGet pesquisam os repositórios usando essa ordem de classificação. Find-PSResource retorna todos os pacotes correspondentes da lista classificada de repositórios.

O parâmetro dá suporte ao * caractere curinga. Se você especificar vários repositórios, todos os nomes deverão incluir ou omitir o caractere curinga. Você não pode especificar uma combinação de nomes com e sem curingas.

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

-Tag

Filtra os resultados da pesquisa de recursos que incluem as marcas especificadas. Se várias marcas forem especificadas, o cmdlet retornará apenas recursos que incluem todas as marcas fornecidas.

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

-Type

Especifica um ou mais tipos de recursos a serem encontrados. Os tipos de recursos com suporte são:

None
Module
Script

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
Valores aceitos:	None, Module, Script
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.

Há suporte para curingas, mas o NuGet aceita apenas o caractere *curinga . Para obter mais informações sobre intervalos de versões do NuGet, consulte Controle de versão do pacote.

O PowerShellGet dá suporte a todas, exceto à 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.

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

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Observações

O módulo define fdres como um alias para Find-PSResource.

Compartilhar via