Find-PSResource

Módulo:: Microsoft.PowerShell.PSResourceGet Module

Procura pacotes a partir de um repositório (local ou remoto), com base num nome ou noutras propriedades do pacote.

Sintaxe

NameParameterSet (Predefinição)

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

CommandNameParameterSet

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

DscResourceNameParameterSet

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

Description

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

Exemplos

Exemplo 1

Este exemplo pesquisa na Galeria do PowerShell o pacote PowerShellGet. O cmdlet retorna a versão de 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 na Galeria do PowerShell o pacote 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 procura na Galeria do PowerShell o pacote de Microsoft.PowerShell.SecretManagement. O cmdlet retorna todas as versões que satisfazem o 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 procura todos os recursos do 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 procura todos os recursos do módulo que contêm o DSC Resource SystemLocale.

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 tag. O valor CrescendoBuilt é 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.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

CommandNameParameterSet

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

-Credential

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

Propriedades dos parâmetros

Tipo:	PSCredential
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

-DscResourceName

O nome do recurso DSC a ser pesquisado.

Propriedades dos parâmetros

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

Conjuntos de parâmetros

DscResourceNameParameterSet

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

-IncludeDependencies

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

NameParameterSet

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

-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

NameParameterSet

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

-Prerelease

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

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
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

-Repository

Especifica um ou mais nomes de repositório para pesquisar. Se não for especificado, a pesquisa inclui todos os repositórios registrados, em ordem de prioridade (mais alta primeiro), até que seja encontrado um repositório que contenha o pacote. Os repositórios são classificados por prioridade e, em seguida, por nome. Valores de de prioridade de mais baixos têm uma precedência maior.

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 suporta o caractere curinga *. Se você especificar vários repositórios, todos os nomes deverão incluir ou omitir o caractere curinga. Não é possível especificar uma combinação de nomes com e sem curingas.

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:	True
Valor dos restantes argumentos:	False

-Tag

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

Propriedades dos parâmetros

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

Conjuntos de parâmetros

NameParameterSet

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

-Type

Especifica um ou mais tipos de recursos para localizar. Os tipos de recursos suportados são:

None
Module
Script

Propriedades dos parâmetros

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
Default value:	None
Valores aceites:	None, Module, Script, Nupkg
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

NameParameterSet

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.

Os curingas são suportados, mas o NuGet só aceita caracteres curinga *. 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

NameParameterSet

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

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Notas

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

Feedback

Esta página foi útil?

Partilhar via

Find-PSResource

Sintaxe

NameParameterSet (Predefinição)

CommandNameParameterSet

DscResourceNameParameterSet

Description

Exemplos

Exemplo 1

Exemplo 2

Exemplo 3

Exemplo 4

Exemplo 5

Exemplo 6

Exemplo 7

Parâmetros

-CommandName

Propriedades dos parâmetros

Conjuntos de parâmetros

-Credential

Propriedades dos parâmetros

Conjuntos de parâmetros

-DscResourceName

Propriedades dos parâmetros

Conjuntos de parâmetros

-IncludeDependencies

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

Propriedades dos parâmetros

Conjuntos de parâmetros

-Prerelease

Propriedades dos parâmetros

Conjuntos de parâmetros

-Repository

Propriedades dos parâmetros

Conjuntos de parâmetros

-Tag

Propriedades dos parâmetros

Conjuntos de parâmetros

-Type

Propriedades dos parâmetros

Conjuntos de parâmetros

-Version

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

String

Saídas

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Notas

Feedback