Find-Module
Sucht Module in einem Repository, die den angegebenen Kriterien entsprechen.
Syntax
All
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.
Wenn Sie zum ersten Mal Find-Module versuchen, ein Repository zu verwenden, werden Sie möglicherweise aufgefordert, Updates zu installieren.
Wenn die Repositoryquelle nicht mit Register-PSRepository dem Cmdlet registriert ist, wird ein Fehler zurückgegeben.
Find-Module gibt die neueste Version eines Moduls zurück, wenn keine Parameter verwendet werden, die die Version einschränken. Verwenden Sie den Parameter AllVersions, um die Liste der Versionen eines Moduls abzurufen.
Wenn der Parameter "MinimumVersion " angegeben ist, wird die Version des Moduls zurückgegeben, Find-Module die gleich oder größer als das Minimum ist. Wenn im Repository eine neuere Version verfügbar ist, wird die neuere Version zurückgegeben.
Wenn der Parameter MaximumVersion angegeben ist, wird die neueste Version des Moduls zurückgegeben, Find-Module die die angegebene Version nicht überschreitet.
Wenn der Parameter RequiredVersion angegeben ist, wird nur die Modulversion zurückgegeben, Find-Module die genau mit der angegebenen Version übereinstimmt.
Find-Module durchsucht alle verfügbaren Module, da Namenskonflikte zwischen Quellen auftreten können.
Die Parameter, die Modulversionsnummern verwenden, erwarten Zeichenfolgen, die als Versionsnummern formatiert sind.
- Standardversionsnummern weisen ein Format auf
x.y.z, wobei "x", "y" und "z" Zahlen sind. - Vorabversionen weisen ein Format
x.y.z-<prerelease_label>auf, in dem die<prerelease_label>beliebige Zeichenfolge dieser Version zugewiesen ist.
In den folgenden Beispielen wird der PowerShell-Katalog als einziges registriertes Repository verwendet.
Get-PSRepository zeigt die registrierten Repositorys an. Wenn Sie über mehrere registrierte Repositorys verfügen, verwenden Sie den -Repository Parameter, um den Namen des Repositorys anzugeben.
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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Command
Gibt ein Array von Befehlen an, die in Modulen gefunden werden sollen. Ein Befehl kann eine Funktion oder ein Workflow sein.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Credential
Gibt ein Benutzerkonto an, das über Berechtigungen zum Installieren eines Moduls für einen angegebenen Paketanbieter oder eine angegebene Quelle verfügt.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-DscResource
Gibt den Namen oder einen Teil des Namens von Modulen an, die DSC-Ressourcen enthalten. Nach PowerShell-Konventionen führt eine OR-Suche aus, wenn Sie mehrere Argumente angeben.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Filter
Gibt einen Filter basierend auf der anbieterspezifischen Suchsyntax "PackageManagement " an. Bei NuGet-Modulen entspricht dieser Parameter der Suche mithilfe der Suchleiste auf der PowerShell-Katalogwebsite .
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-IncludeDependencies
Gibt an, dass dieser Vorgang alle Module enthält, die von dem im Parameter Name angegebenen Modul abhängig sind.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Includes
Gibt nur die Module zurück, die bestimmte Arten von PowerShell-Funktionen enthalten. Sie können beispielsweise nur Module suchen, die DSCResource enthalten. Die zulässigen Werte für diesen Parameter sind wie folgt:
- Cmdlet
- DscResource
- Funktion
- RoleCapability
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Zulässige Werte: | DscResource, Cmdlet, Function, RoleCapability |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MaximumVersion
Gibt die maximale oder neueste Version des Moduls an, die in die Suchergebnisse eingeschlossen werden soll. MaximumVersion und RequiredVersion können nicht im gleichen Befehl verwendet werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-MinimumVersion
Gibt die Mindestversion des Moduls an, die in Ergebnisse eingeschlossen werden soll. MinimumVersion und RequiredVersion können nicht im selben Befehl verwendet werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | True |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Proxy
Gibt einen Proxyserver für die Anforderung an, anstatt eine direkte Verbindung mit der Internetressource herzustellen.
Parametereigenschaften
| Typ: | Uri |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ProxyCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zum Verwenden des Proxyservers verfügt, der durch den Proxyparameter angegeben wird.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | 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 .
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RequiredVersion
Gibt die genaue Versionsnummer des Moduls an, das in die Ergebnisse eingeschlossen werden soll. RequiredVersion kann nicht im gleichen Befehl wie MinimumVersion oder MaximumVersion verwendet werden.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-RoleCapability
Gibt ein Array von Rollenfunktionen an.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Tag
Gibt ein Array von Tags an. Beispieltags sind DesiredStateConfiguration, DSC, DSCResourceKit oder PSModule.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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
Wichtig
Ab April 2020 unterstützt der PowerShell-Katalog die Tls-Versionen 1.0 und 1.1 nicht mehr. Wenn Sie TLS 1.2 oder höher nicht verwenden, wird beim Versuch, auf den PowerShell-Katalog zuzugreifen, eine Fehlermeldung angezeigt. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Weitere Informationen finden Sie in der Ankündigung im PowerShell-Blog.
