Find-PSResource

Riferimento

Modulo:: Microsoft.PowerShell.PSResourceGet

Cerca i 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 cmdlet Find-PSResource 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 in PowerShell Gallery il pacchetto di PowerShellGet. Il cmdlet restituisce la versione non definitiva più recente.

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 in PowerShell Gallery il pacchetto di powerShellGet, incluse le versioni non definitive.

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 in PowerShell Gallery la pacchetto Microsoft.PowerShell.SecretManagement. Il cmdlet restituisce tutte le versioni che soddisfano l'intervallo di versione 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

In questo esempio vengono cercate tutte le risorse del modulo contenenti il 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 DSC SystemLocale.

Find-PSResource -DscResourceName SystemLocale -Repository PSGallery

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

Esempio 6

In questo esempio vengono eseguite ricerche in tutte le risorse registrate PSResourceRepositories 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 valore CrescendoBuilt è 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.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Credential

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

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DscResourceName

Nome della risorsa DSC da cercare.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IncludeDependencies

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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).

Tipo:	String[]
Posizione:	0
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	True

-Prerelease

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	False
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Repository

Specifica uno o più nomi di repository da cercare. Se non specificato, la ricerca include tutti i repository registrati, in ordine di priorità (il 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 Priority lower hanno una precedenza più alta.

Quando si cercano risorse in più repository, i cmdlet di PSResourceGet eseguono ricerche nei repository usando questo 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.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Type

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

None
Module
Script

Tipo:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
Valori accettati:	None, Module, Script, Nupkg
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Version

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

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

PowerShellGet supporta tutte le versioni incluse elencate nella documentazione dell'intervallo di versioni di NuGet. L'uso di 1.0.0.0 perché la versione non restituisce versioni 1.0.0.0 e successive (intervallo inclusivo minimo). Il valore viene invece considerato la versione richiesta. Per cercare un intervallo inclusivo minimo, usare [1.0.0.0, ] come intervallo di versioni.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	True

Input

String[]

Output

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Note

Il modulo definisce fdres come alias per Find-PSResource.

Condividi tramite