Find-PSResource
Recherche des packages à partir d’un dépôt (local ou distant), en fonction d’un nom ou d’autres propriétés de package.
Syntax
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
L’applet Find-PSResource de commande recherche un package à partir d’un référentiel (local ou distant) en fonction d’un nom ou d’autres propriétés de package.
Exemples
Exemple 1
Cet exemple recherche PowerShell Gallery le package PowerShellGet. L’applet de commande retourne la version non préliminaire la plus élevée.
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…Exemple 2
Cet exemple recherche PowerShell Gallery le package PowerShellGet, y compris les versions préliminaires.
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…Exemple 3
Cet exemple recherche PowerShell Gallery le package Microsoft.PowerShell.SecretManagement. L’applet de commande retourne toutes les versions qui répondent à la plage de versions spécifiée.
$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 …Exemple 4
Cet exemple recherche toutes les ressources de module contenant commandName de Get-TargetResource. L’applet de commande retourne toutes les ressources de module qui incluent la commande.
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.0Exemple 5
Cet exemple recherche toutes les ressources de module contenant la ressource SystemLocaleDSC .
Find-PSResource -DscResourceName SystemLocale -Repository PSGallery
Name Package Name Version
---- ------------ -------
{SystemLocale} ComputerManagementDsc 9.0.0
{SystemLocale} SystemLocaleDsc 1.2.0.0Exemple 6
Cet exemple recherche dans tous les PSResourceRepositories inscrits des ressources dont le nom commence par 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…Exemple 7
Cet exemple montre comment rechercher des modules par une balise. La CrescendoBuilt valeur est une balise qui est automatiquement ajoutée aux modules créés à l’aide du module 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…Paramètres
-CommandName
Nom de la commande à rechercher.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Informations d’identification facultatives à utiliser lors de l’accès à un dépôt.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DscResourceName
Nom de la ressource DSC à rechercher.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IncludeDependencies
Lorsqu’elle est spécifiée, la recherche retourne toutes les ressources correspondantes, leurs dépendances. Les dépendances sont dédupliquées.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Nom d’une ressource à rechercher. Les caractères génériques sont pris en charge, mais NuGet accepte uniquement le * caractère. NuGet ne prend pas en charge les recherches génériques dans les référentiels locaux (basés sur des fichiers).
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Prerelease
Lorsqu’elle est spécifiée, inclut les versions préliminaires dans les résultats de recherche retournés.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Repository
Spécifie un ou plusieurs noms de référentiels à rechercher. Si elle n’est pas spécifiée, la recherche inclut tous les dépôts inscrits, dans l’ordre de priorité (le plus élevé en premier), jusqu’à ce qu’un dépôt contenant le package soit trouvé. Les dépôts sont triés par priorité, puis par nom. Les valeurs de priorité inférieure ont une priorité plus élevée.
Lors de la recherche de ressources sur plusieurs référentiels, les applets de commande PSResourceGet recherchent les référentiels à l’aide de cet ordre de tri. Find-PSResource retourne tous les packages correspondants de la liste triée des dépôts.
Le paramètre prend en charge le * caractère générique. Si vous spécifiez plusieurs dépôts, tous les noms doivent inclure ou omettre le caractère générique. Vous ne pouvez pas spécifier un mélange de noms avec et sans caractères génériques.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | True |
-Tag
Filtre les résultats de recherche pour les ressources qui incluent les balises spécifiées. Si plusieurs balises sont spécifiées, l’applet de commande retourne uniquement les ressources qui incluent toutes les balises fournies.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Type
Spécifie un ou plusieurs types de ressources à rechercher. Les types de ressources pris en charge sont les suivants :
NoneModuleScript
| 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
Spécifie la version de la ressource à retourner. La valeur peut être une version exacte ou une plage de versions à l’aide de la syntaxe de contrôle de version NuGet.
Les caractères génériques sont pris en charge, mais NuGet accepte uniquement les caractères *génériques . Pour plus d’informations sur les plages de versions NuGet, consultez Gestion des versions de package.
PowerShellGet prend en charge tout sauf la version inclusive minimale répertoriée dans la documentation de la plage de versions NuGet. L’utilisation 1.0.0.0 en tant que version ne génère pas les versions 1.0.0.0 et ultérieures (plage inclusive minimale). Au lieu de cela, la valeur est considérée comme la version requise. Pour rechercher une plage inclusive minimale, utilisez [1.0.0.0, ] comme plage de versions.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
Entrées
String[]
Sorties
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo
Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo
Notes
Le module définit fdres comme alias pour Find-PSResource.
Commentaires
Bientôt disponible : Tout au long de l’année 2024, nous abandonnerons progressivement le mécanisme de retour d’information GitHub Issues pour le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez : https://aka.ms/ContentUserFeedback.
Soumettre et afficher des commentaires pour