Share via


Find-PSResource

Cerca pacchetti da un repository (locale o remoto), in base a un nome o ad altre proprietà del pacchetto.

Sintassi

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>]

Descrizione

Il Find-PSResource cmdlet cerca un pacchetto da un repository (locale o remoto) in base a un nome o ad altre proprietà del pacchetto.

Esempio

Esempio 1

Questo esempio cerca PowerShell Gallery per il pacchetto PowerShellGet. Il cmdlet restituisce la versione non preliminare più elevata.

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…

Esempio 2

Questo esempio cerca PowerShell Gallery per il pacchetto PowerShellGet, incluse le versioni precedenti.

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…

Esempio 3

Questo esempio cerca PowerShell Gallery per il pacchetto Microsoft.PowerShell.SecretManagement. Il cmdlet restituisce tutte le versioni che soddisfano l'intervallo di versioni specificato.

$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  …

Esempio 4

Questo esempio cerca tutte le risorse del modulo contenenti commandName di Get-TargetResource. Il cmdlet restituisce tutte le risorse del modulo che includono il 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

Esempio 5

Questo esempio cerca tutte le risorse del modulo contenenti la risorsa SystemLocaleDSC .

Find-PSResource -DscResourceName SystemLocale -Repository PSGallery

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

Esempio 6

Questo esempio cerca tutti i psResourceRepositories registrati per le risorse con nomi che iniziano con 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…

Esempio 7

In questo esempio viene illustrato come trovare i moduli in base a un tag. Il CrescendoBuilt valore è un tag aggiunto automaticamente ai moduli creati usando il modulo 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…

Parametri

-CommandName

Nome del comando da cercare.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Credenziali facoltative da usare per l'accesso a un repository.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DscResourceName

Nome della risorsa DSC da cercare.

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IncludeDependencies

Se specificato, la ricerca restituisce tutte le risorse corrispondenti le relative dipendenze. Le dipendenze vengono deduplicate.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Nome di una risorsa da trovare. I caratteri jolly sono supportati, ma NuGet accetta solo il * carattere. NuGet non supporta le ricerche con caratteri jolly dei repository locali (basati su file).

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Prerelease

Se specificato, include versioni non definitive nei risultati della ricerca restituiti.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

Specifica uno o più nomi di repository da cercare. Se non specificato, la ricerca include tutti i repository registrati, nell'ordine di priorità (primo), fino a quando non viene trovato un repository che contiene il pacchetto. I repository vengono ordinati in base alla priorità e quindi in base al nome. I valori priorità inferiore hanno una precedenza superiore.

Quando si cercano risorse in più repository, i cmdlet PSResourceGet ricercano i repository usando questo ordine di ordinamento. Find-PSResource restituisce tutti i pacchetti corrispondenti dall'elenco ordinato di repository.

Il parametro supporta il * carattere jolly. Se si specificano più repository, tutti i nomi devono includere o omettere il carattere jolly. Non è possibile specificare una combinazione di nomi con e senza caratteri jolly.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Tag

Filtra i risultati della ricerca per le risorse che includono i tag specificati. Se vengono specificati più tag, il cmdlet restituisce solo le risorse che includono tutti i tag specificati.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Type

Specifica uno o più tipi di risorse da trovare. I tipi di risorse supportati sono:

  • None
  • Module
  • Script
Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
Accepted values:None, Module, Script
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

Specifica la versione della risorsa da restituire. Il valore può essere una versione esatta o un intervallo di versioni usando la sintassi del controllo delle versioni NuGet.

I caratteri jolly sono supportati ma NuGet accetta solo caratteri *jolly. Per altre informazioni sugli intervalli di versioni NuGet, vedere Controllo delle versioni del pacchetto.

PowerShellGet supporta tutto ma la versione minima inclusiva elencata nella documentazione dell'intervallo di versioni NuGet. L'uso 1.0.0.0 come versione non restituisce versioni 1.0.0.0 e successive (intervallo minimo inclusivo). Il valore viene invece considerato come la versione richiesta. Per cercare un intervallo inclusivo minimo, usare [1.0.0.0, ] come intervallo di versioni.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Input

String[]

Output

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Note

Il modulo definisce fdres come alias per Find-PSResource.