Find-Module

Referenz

Modul:: PowerShellGet

Sucht Module in einem Repository, die den angegebenen Kriterien entsprechen.

Syntax

Find-Module
    [[-Name] <string[]>]
    [-MinimumVersion <string>]
    [-MaximumVersion <string>]
    [-RequiredVersion <string>]
    [-AllVersions]
    [-IncludeDependencies]
    [-Filter <string>]
    [-Tag <string[]>]
    [-Includes <string[]>]
    [-DscResource <string[]>]
    [-RoleCapability <string[]>]
    [-Command <string[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-Repository <string[]>]
    [-Credential <pscredential>]
    [-AllowPrerelease]
    [<CommonParameters>]

Beschreibung

Das Find-Module Cmdlet findet Module in einem Repository, die den angegebenen Kriterien entsprechen. Find-Module gibt ein PSRepositoryItemInfo - Objekt für jedes gefundene Modul zurück. Die Objekte können an Cmdlets wie Install-Modulez. B. an Cmdlets gesendet werden.

Dies ist ein Proxy-Cmdlet für das Find-PSResource Cmdlet in microsoft.PowerShell.PSResourceGet. Weitere Informationen finden Sie unter Find-PSResource.

Beispiele

Beispiel 1: Suchen eines Moduls anhand des Namens

In diesem Beispiel wird ein Modul im Standard-Repository gefunden.

Find-Module -Name PowerShellGet

Version   Name              Repository           Description
-------   ----              ----------           -----------
2.1.0     PowerShellGet     PSGallery            PowerShell module with commands for discovering...

Das Find-Module Cmdlet verwendet den Parameter Name , um das PowerShellGet-Modul anzugeben.

Beispiel 2: Suchen von Modulen mit ähnlichen Namen

In diesem Beispiel wird das Sternchen (*) verwendet, um Module mit ähnlichen Namen zu finden.

Find-Module -Name PowerShell*

Version   Name                            Repository    Description
-------   ----                            ----------    -----------
0.4.0     powershell-yaml                 PSGallery     Powershell module for serializing and...
2.1.0     PowerShellGet                   PSGallery     PowerShell module with commands for...
1.9       Powershell.Helper.Extension     PSGallery     # Powershell.Helper.Extension...
3.1       PowerShellHumanizer             PSGallery     PowerShell Humanizer wraps Humanizer...
4.0       PowerShellISEModule             PSGallery     a module that adds capability to the ISE

Das Find-Module Cmdlet verwendet den Parameter Name mit dem Sternchen (*) platzhalter, um alle Module zu finden, die PowerShell enthalten.

Beispiel 3: Suchen eines Moduls nach Mindestversion

In diesem Beispiel wird nach der Mindestversion eines Moduls gesucht. Wenn das Repository eine neuere Version des Moduls enthält, wird die neuere Version zurückgegeben.

Find-Module -Name PowerShellGet -MinimumVersion 1.6.5

Version   Name             Repository     Description
-------   ----             ----------     -----------
2.1.0     PowerShellGet    PSGallery      PowerShell module with commands for discovering...

Das Find-Module Cmdlet verwendet den Parameter Name , um das PowerShellGet-Modul anzugeben. Die MinimumVersion gibt Version 1.6.5 an. Find-Module gibt PowerShellGet, Version 2.1.0 zurück, da sie die Mindestversion überschreitet und die neueste Version ist.

Beispiel 4: Suchen eines Moduls nach einer bestimmten Version

In diesem Beispiel wird gezeigt, wie Sie eine bestimmte Vorabversion eines Moduls installieren. Vorabversionen weisen ein Format von <version_number>-<prerelease_label>.

Find-Module PSReadLine -AllowPrerelease -RequiredVersion 2.2.4-beta1

Version        Name             Repository       Description
-------        ----             ----------       -----------
2.2.4-beta1    PSReadLine       PSGallery        Great command line editing in the PowerS…

Beispiel 5: Suchen eines Moduls in einem bestimmten Repository

In diesem Beispiel wird der Repository-Parameter verwendet, um ein Modul in einem bestimmten Repository zu finden.

Find-Module -Name PowerShellGet -Repository PSGallery

Version   Name             Repository     Description
-------   ----             ----------     -----------
2.1.0     PowerShellGet    PSGallery      PowerShell module with commands for discovering...

Das Find-Module Cmdlet verwendet den Parameter Name , um das PowerShellGet-Modul anzugeben. Der Repository-Parameter gibt an, das PSGallery-Repository zu durchsuchen.

Beispiel 6: Suchen eines Moduls in mehreren Repositorys

In diesem Beispiel wird das Register-PSRepository Repository angegeben. Find-Module verwendet das Repository, um nach einem Modul zu suchen.

Register-PSRepository -Name MySource -SourceLocation https://www.myget.org/F/powershellgetdemo/
Find-Module -Name Contoso* -Repository PSGallery, MySource

Repository    Version   Name             Description
----------    -------   ----             -----------
PSGallery     2.0.0.0   ContosoServer    Cmdlets and DSC resources for managing Contoso Server...
MySource      1.2.0.0   ContosoClient    Cmdlets and DSC resources for managing Contoso Client...

Das Register-PSRepository Cmdlet registriert ein neues Repository. Der Parameter Name weist den Namen MySource zu. Der SourceLocation-Parameter gibt die Adresse des Repositorys an.

Das Find-Module Cmdlet verwendet den Parameter Name mit dem Sternchen (*) zum Angeben des Contoso-Moduls . Der Repository-Parameter gibt an, zwei Repositorys zu durchsuchen, PSGallery und MySource.

Beispiel 7: Suchen eines Moduls, das eine DSC-Ressource enthält

Dieser Befehl gibt Module zurück, die DSC-Ressourcen enthalten. Der Parameter Includes verfügt über vier vordefinierte Funktionen, die zum Durchsuchen des Repositorys verwendet werden. Verwenden Sie tabvervollständigen, um die vier vom Includes-Parameter unterstützten Funktionen anzuzeigen.

Find-Module -Repository PSGallery -Includes DscResource

Version     Name                            Repository    Description
-------     ----                            ----------    -----------
2.7.0       Carbon                          PSGallery     Carbon is a PowerShell module...
8.5.0.0     xPSDesiredStateConfiguration    PSGallery     The xPSDesiredStateConfiguration module...
1.3.1       PackageManagement               PSGallery     PackageManagement (a.k.a. OneGet) is...
2.7.0.0     xWindowsUpdate                  PSGallery     Module with DSC Resources...
3.2.0.0     xCertificate                    PSGallery     This module includes DSC resources...
3.1.0.0     xPowerShellExecutionPolicy      PSGallery     This DSC resource can change the user...

Das Find-Module Cmdlet verwendet den Parameter "Repository ", um das Repository ,PSGallery' zu durchsuchen. Der Includes-Parameter gibt DscResource an, bei dem es sich um eine Funktionalität handelt, nach der der Parameter im Repository suchen kann.

Beispiel 8: Suchen eines Moduls mit einem Filter

In diesem Beispiel wird zum Suchen von Modulen ein Filter zum Durchsuchen des Repositorys verwendet.

Bei einem NuGet-basierten Repository durchsucht der Filter-Parameter den Namen, die Beschreibung und die Tags für das Argument.

Find-Module -Filter AppDomain

Version    Name              Repository           Description
-------    ----              ----------           -----------
1.0.0.0  AppDomainConfig     PSGallery            Manipulate AppDomain configuration...
1.1.0    ClassExplorer       PSGallery            Quickly search the AppDomain for classes...

Das Find-Module Cmdlet verwendet den Parameter "Filter ", um das Repository nach "AppDomain" zu durchsuchen.

Beispiel 9: Suchen eines Moduls nach Tag

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-Module -Tag CrescendoBuilt

Version Name            Repository Description
------- ----            ---------- -----------
0.1.0   Foil            PSGallery  A PowerShell Crescendo wrapper for Chocolatey
0.3.1   Cobalt          PSGallery  A PowerShell Crescendo wrapper for WinGet
1.1.0   SysInternals    PSGallery  PowerShell cmdlets for SysInternal tools
0.0.4   Croze           PSGallery  A PowerShell Crescendo wrapper for Homebrew
0.0.2   AptPackage      PSGallery  PowerShell Crescendo-generated Module to query APT-Package Information
1.0.1   RoboCopy        PSGallery  PowerShell cmdlet for the official RoboCopy.exe
1.0.2   TShark          PSGallery  PowerShell cmdlet for tshark.exe
1.0.0   SpeedTestCLI    PSGallery  PowerShell cmdlets speedtest-cli
1.0.0   SpeedTest-CLI   PSGallery  PowerShell cmdlets for Internet Speed Test
1.0.2   Image2Text      PSGallery  PowerShell Images into ASCII art
0.1.1   Quser.Crescendo PSGallery  This module displays session information of users logged onto a local or remote m...
1.0.2   Takeown         PSGallery  Crescendo Powershell wrapper of takeown.exe

Parameter

-AllowPrerelease

Enthält die Als Vorabversion gekennzeichneten Ergebnismodule.

Das Proxy-Cmdlet ordnet diesen Parameter dem Parameter Prerelease von Find-PSResource.

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

-AllVersions

Gibt an, dass alle Versionen eines Moduls in die Ergebnisse einbezogen werden sollen. Sie können den Parameter "AllVersions" nicht mit den Parametern "MinimumVersion", "MaximumVersion" oder "RequiredVersion " verwenden.

Das Proxy-Cmdlet transformiert diesen Parameter in den vor dem -Version * Aufrufen Find-PSResource.

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

-Command

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Credential

Gibt ein Benutzerkonto an, das über Berechtigungen zum Installieren eines Moduls für einen angegebenen Paketanbieter oder eine angegebene Quelle verfügt.

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

-DscResource

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Filter

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-IncludeDependencies

Gibt an, dass dieser Vorgang alle Module enthält, die von dem im Parameter Name angegebenen Modul abhängig sind.

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

-Includes

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

Typ:	String[]
Zulässige Werte:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MaximumVersion

Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Find-PSResourcezu erstellen.

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

-MinimumVersion

Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Find-PSResourcezu erstellen.

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

-Name

Gibt die Namen der Module an, nach der im Repository gesucht werden soll. Eine durch Trennzeichen getrennte Liste von Modulnamen wird akzeptiert. Wildcards werden akzeptiert.

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

-Proxy

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-ProxyCredential

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Repository

Verwenden Sie den Repository-Parameter , um anzugeben, welches Repository nach einem Modul gesucht werden soll. Wird verwendet, wenn mehrere Repositorys registriert sind. Akzeptiert eine durch Trennzeichen getrennte Liste von Repositorys. Verwenden Sie Register-PSRepositoryzum Registrieren eines Repositorys . Verwenden Sie Get-PSRepositoryzum Anzeigen registrierter Repositorys .

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

-RequiredVersion

Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Find-PSResourcezu erstellen.

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

-RoleCapability

Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom NameParameterSet von Find-PSResourcenicht unterstützt wird.

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

-Tag

Gibt ein Array von Tags an. Beispieltags sind DesiredStateConfiguration, DSC, DSCResourceKit oder PSModule.

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

Eingaben

String[]

String

Uri

PSCredential

Ausgaben

PSRepositoryItemInfo

Find-Module erstellt PSRepositoryItemInfo-Objekte , die an Cmdlets wie z Install-Module. B. die Pipeline gesendet werden können.

Hinweise

PowerShell enthält die folgenden Aliase für Find-Module:

Alle Plattformen:
- fimo

Der PowerShell-Katalog unterstützt die Tls-Versionen 1.0 und 1.1 nicht mehr. Sie müssen TLS 1.2 oder höher verwenden. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Freigeben über

Find-Module

Syntax

Beschreibung

Beispiele

Beispiel 1: Suchen eines Moduls anhand des Namens

Beispiel 2: Suchen von Modulen mit ähnlichen Namen

Beispiel 3: Suchen eines Moduls nach Mindestversion

Beispiel 4: Suchen eines Moduls nach einer bestimmten Version

Beispiel 5: Suchen eines Moduls in einem bestimmten Repository

Beispiel 6: Suchen eines Moduls in mehreren Repositorys

Beispiel 7: Suchen eines Moduls, das eine DSC-Ressource enthält

Beispiel 8: Suchen eines Moduls mit einem Filter

Beispiel 9: Suchen eines Moduls nach Tag

Parameter

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Eingaben

Ausgaben

Hinweise

Ähnliche Themen