Find-PSResource

Sucht anhand eines Namens oder anderer Paketeigenschaften nach Paketen aus einem Repository (lokal oder remote).

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

Beschreibung

Das Find-PSResource Cmdlet sucht anhand eines Namens oder anderer Paketeigenschaften nach einem Paket aus einem Repository (lokal oder remote).

Beispiele

Beispiel 1

In diesem Beispiel wird PowerShell-Katalog nach dem PowerShellGet-Paket gesucht. Das Cmdlet gibt die höchste Version zurück, die keine Vorabversion ist.

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…

Beispiel 2

In diesem Beispiel wird PowerShell-Katalog nach dem PowerShellGet-Paket gesucht, einschließlich Vorabversionen.

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…

Beispiel 3

In diesem Beispiel wird PowerShell-Katalog nach dem Microsoft.PowerShell.SecretManagement-Paket durchsucht. Das Cmdlet gibt alle Versionen zurück, die den angegebenen Versionsbereich erfüllen.

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

Beispiel 4

In diesem Beispiel wird nach allen Modulressourcen gesucht, die den CommandName von Get-TargetResourceenthalten. Das Cmdlet gibt alle Modulressourcen zurück, die den Befehl enthalten.

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

Beispiel 5

In diesem Beispiel wird nach allen Modulressourcen gesucht, die die DSC-Ressource SystemLocaleenthalten.

Find-PSResource -DscResourceName SystemLocale -Repository PSGallery

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

Beispiel 6

In diesem Beispiel werden alle registrierten PSResourceRepositories nach Ressourcen mit Namen gesucht, die mit Computerbeginnen.

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…

Beispiel 7

In diesem Beispiel wird gezeigt, wie Module nach einem Tag gesucht werden. Der CrescendoBuilt Wert ist ein Tag, das automatisch zu Modulen hinzugefügt wird, die mit dem Modul Microsoft.PowerShell.Crescendo erstellt wurden.

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…

Parameter

-CommandName

Der Name des befehls, nach dem gesucht werden soll.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Credential

Optionale Anmeldeinformationen, die beim Zugriff auf ein Repository verwendet werden sollen.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DscResourceName

Der Name der DSC-Ressource, nach der gesucht werden soll.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-IncludeDependencies

Wenn dies angegeben ist, gibt die Suche alle übereinstimmenden Ressourcen und deren Abhängigkeiten zurück. Abhängigkeiten werden dedupliziert.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Name einer ressource, die gesucht werden soll. Wildcards werden unterstützt, nuGet akzeptiert jedoch nur das * Zeichen. NuGet unterstützt keine Wildcardsuchen lokaler (dateibasierter) Repositorys.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-Prerelease

Wenn angegeben, schließt Vorabversionen in zurückgegebene Suchergebnisse ein.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Repository

Gibt einen oder mehrere zu durchsuchende Repositorynamen an. Wenn nicht angegeben, umfasst die Suche alle registrierten Repositorys in der Prioritätsreihenfolge (höchste Erste), bis ein Repository gefunden wird, das das Paket enthält. Repositorys werden nach Priorität und dann nach Name sortiert. Niedrigere Prioritätswerte haben eine höhere Priorität.

Bei der Suche nach Ressourcen in mehreren Repositorys durchsuchen die PSResourceGet-Cmdlets die Repositorys mithilfe dieser Sortierreihenfolge. Find-PSResource gibt alle übereinstimmenden Pakete aus der sortierten Liste der Repositorys zurück.

Der Parameter unterstützt das * Wildcardzeichen. Wenn Sie mehrere Repositorys angeben, müssen alle Namen das Wildcardzeichen enthalten oder weglassen. Sie können keine Kombination aus Namen mit und ohne Wildcards angeben.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-Tag

Filtert Suchergebnisse nach Ressourcen, die die angegebenen Tags enthalten. Wenn mehrere Tags angegeben sind, gibt das Cmdlet nur Ressourcen zurück, die alle bereitgestellten Tags enthalten.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Type

Gibt einen oder mehrere zu suchende Ressourcentypen an. Unterstützte Ressourcentypen sind:

  • None
  • Module
  • Script
Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ResourceType
Zulässige Werte:None, Module, Script
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Version

Gibt die Version der zurückzugebenden Ressource an. Der Wert kann eine genaue Version oder ein Versionsbereich mit der NuGet-Versionsverwaltungssyntax sein.

Wildcards werden unterstützt, nuGet akzeptiert jedoch nur Das Wildcardzeichen *. Weitere Informationen zu NuGet-Versionsbereichen finden Sie unter Paketversionsverwaltung.

PowerShellGet unterstützt alle Versionen bis auf die mindeste inklusive Version , die in der Dokumentation zum NuGet-Versionsbereich aufgeführt ist. Die Verwendung 1.0.0.0 als Version ergibt keine Versionen 1.0.0.0 und höher (minimaler inklusiver Bereich). Stattdessen wird der Wert als die erforderliche Version betrachtet. Um nach einem minimalen inklusiven Bereich zu suchen, verwenden Sie [1.0.0.0, ] als Versionsbereich.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:True

Eingaben

String[]

Ausgaben

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSCommandResourceInfo

Hinweise

Das Modul definiert fdres als Alias für Find-PSResource.