Find-Module
Hiermee vindt u modules in een opslagplaats die voldoen aan opgegeven criteria.
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>]
Description
De Find-Module
cmdlet vindt modules in een opslagplaats die voldoen aan de opgegeven criteria.
Find-Module
retourneert een PSRepositoryItemInfo-object voor elke module die wordt gevonden. De objecten kunnen via de pijplijn worden verzonden naar cmdlets zoals Install-Module
.
De eerste keer Find-Module
dat u een opslagplaats probeert te gebruiken, wordt u mogelijk gevraagd om updates te installeren.
Als de bron van de opslagplaats niet is geregistreerd bij Register-PSRepository
de cmdlet, wordt er een fout geretourneerd.
Find-Module
retourneert de nieuwste versie van een module als er geen parameters worden gebruikt die de versie beperken. Gebruik de parameter AllVersions om de lijst met de versies van een module van een opslagplaats op te halen.
Als de parameter MinimumVersion is opgegeven, Find-Module
retourneert de moduleversie die gelijk is aan of groter is dan het minimum. Als er een nieuwere versie beschikbaar is in de opslagplaats, wordt de nieuwere versie geretourneerd.
Als de parameter MaximumVersion is opgegeven, Find-Module
retourneert de nieuwste versie van de module die niet groter is dan de opgegeven versie.
Als de parameter RequiredVersion is opgegeven, Find-Module
retourneert alleen de moduleversie die exact overeenkomt met de opgegeven versie. Find-Module
doorzoekt alle beschikbare modules, omdat er naamconflicten tussen bronnen kunnen optreden.
De parameters die moduleversienummers gebruiken, verwachten tekenreeksen die zijn opgemaakt als versienummers.
- Standaardversienummers hebben een notatie waarbij
x.y.z
x, y en z getallen zijn - Voorlopige versies hebben een indeling waarin
x.y.z-<prerelease_label>
de<prerelease_label>
willekeurige tekenreeks is toegewezen aan die release.
In de volgende voorbeelden wordt de PowerShell Gallery gebruikt als de enige geregistreerde opslagplaats. Get-PSRepository
geeft de geregistreerde opslagplaatsen weer. Als u meerdere geregistreerde opslagplaatsen hebt, gebruikt u de parameter om de -Repository
naam van de opslagplaats op te geven.
Voorbeelden
Voorbeeld 1: Een module zoeken op naam
In dit voorbeeld wordt een module in de standaardopslagplaats gevonden.
Find-Module -Name PowerShellGet
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
De Find-Module
cmdlet gebruikt de parameter Name om de PowerShellGet-module op te geven.
Voorbeeld 2: Modules met vergelijkbare namen zoeken
In dit voorbeeld wordt het jokerteken sterretje (*
) gebruikt om modules met vergelijkbare namen te zoeken.
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
De Find-Module
cmdlet gebruikt de parameter Name met het jokerteken sterretje (*
) om alle modules te zoeken die PowerShell bevatten.
Voorbeeld 3: Een module zoeken op minimumversie
In dit voorbeeld wordt gezocht naar de minimale versie van een module. Als de opslagplaats een nieuwere versie van de module bevat, wordt de nieuwere versie geretourneerd.
Find-Module -Name PowerShellGet -MinimumVersion 1.6.5
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
De Find-Module
cmdlet gebruikt de parameter Name om de PowerShellGet-module op te geven. De MinimumVersion geeft versie 1.6.5 op. Find-Module
Retourneert PowerShellGet versie 2.1.0 omdat deze de minimumversie overschrijdt en de meest recente versie is.
Voorbeeld 4: Een module zoeken op specifieke versie
In dit voorbeeld ziet u hoe u een specifieke voorlopige versie van een module installeert. Voorlopige versies hebben de indeling <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…
Voorbeeld 5: Een module zoeken in een specifieke opslagplaats
In dit voorbeeld wordt de parameter Repository gebruikt om een module in een specifieke opslagplaats te zoeken.
Find-Module -Name PowerShellGet -Repository PSGallery
Version Name Repository Description
------- ---- ---------- -----------
2.1.0 PowerShellGet PSGallery PowerShell module with commands for discovering...
De Find-Module
cmdlet gebruikt de parameter Name om de PowerShellGet-module op te geven. De parameter Opslagplaats geeft aan om te zoeken in de PSGallery-opslagplaats .
Voorbeeld 6: Een module zoeken in meerdere opslagplaatsen
In dit voorbeeld wordt de Register-PSRepository
gebruikt om een opslagplaats op te geven. Find-Module
gebruikt de opslagplaats om te zoeken naar een module.
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...
Met de Register-PSRepository
cmdlet wordt een nieuwe opslagplaats geregistreerd. Met de parameter Name wordt de naam MySource toegewezen. Met de parameter SourceLocation wordt het adres van de opslagplaats opgegeven.
De Find-Module
cmdlet gebruikt de parameter Name met het jokerteken sterretje (*
) om de Contoso-module op te geven. Met de parameter Repository geeft u op om te zoeken in twee opslagplaatsen, PSGallery en MySource.
Voorbeeld 7: Een module zoeken die een DSC-resource bevat
Met deze opdracht worden modules geretourneerd die DSC-resources bevatten. De parameter Includes heeft vier vooraf gedefinieerde functies die worden gebruikt om de opslagplaats te doorzoeken. Gebruik tab-complete om de vier functies weer te geven die worden ondersteund door de parameter Includes .
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...
De Find-Module
cmdlet gebruikt de parameter Repository om te zoeken in de opslagplaats PSGallery.
Met de parameter Includes wordt DscResource opgegeven. Dit is een functionaliteit waarnaar de parameter in de opslagplaats kan zoeken.
Voorbeeld 8: Een module met een filter zoeken
In dit voorbeeld wordt een filter gebruikt om in de opslagplaats te zoeken om modules te zoeken.
Voor een op NuGet gebaseerde opslagplaats doorzoekt de parameter Filter de naam, beschrijving en tags voor het 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...
De Find-Module
cmdlet gebruikt de parameter Filter om in de opslagplaats te zoeken naar AppDomain.
Voorbeeld 9: Een module zoeken op tag
In dit voorbeeld ziet u hoe u modules kunt vinden op basis van een tag. De CrescendoBuilt
waarde is een tag die automatisch wordt toegevoegd aan modules die zijn gemaakt met behulp van de module Microsoft.PowerShell.Crescendo .
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
Parameters
-AllowPrerelease
Bevat in de resultaten modules gemarkeerd als een pre-release.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllVersions
Hiermee geeft u alle versies van een module op in de resultaten. U kunt de parameter AllVersions niet gebruiken met de parameters MinimumVersion, MaximumVersion of RequiredVersion .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Command
Hiermee geeft u een matrix van opdrachten te zoeken in modules. Een opdracht kan een functie of werkstroom zijn.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Hiermee geeft u een gebruikersaccount met rechten voor het installeren van een module voor een opgegeven pakketprovider of bron.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DscResource
Hiermee geeft u de naam, of een deel van de naam, van modules die DSC-resources bevatten. Volgens PowerShell-conventies voert u een OR-zoekopdracht uit wanneer u meerdere argumenten opgeeft.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Filter
Hiermee geeft u een filter op basis van de packageManagement provider-specifieke zoeksyntaxis. Voor NuGet-modules is deze parameter het equivalent van zoeken met behulp van de zoekbalk op de PowerShell Gallery-website.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IncludeDependencies
Geeft aan dat deze bewerking alle modules omvat die afhankelijk zijn van de module die is opgegeven in de parameter Name .
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Includes
Retourneert alleen de modules die specifieke soorten PowerShell-functionaliteit bevatten. Mogelijk wilt u bijvoorbeeld alleen modules zoeken die DSCResource bevatten. De acceptabele waarden voor deze parameter zijn als volgt:
- Cmdlet
- DscResource
- Functie
- RoleCapability
Type: | String[] |
Accepted values: | DscResource, Cmdlet, Function, RoleCapability |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumVersion
Hiermee geeft u de maximale of meest recente versie van de module op die moet worden opgenomen in de zoekresultaten. MaximumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-MinimumVersion
Hiermee geeft u de minimale versie van de module op die in de resultaten moet worden opgenomen. MinimumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Hiermee geeft u de namen van modules te zoeken in de opslagplaats. Een door komma's gescheiden lijst met modulenamen wordt geaccepteerd. Jokertekens worden geaccepteerd.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Proxy
Hiermee geeft u een proxyserver voor de aanvraag, in plaats van rechtstreeks verbinding te maken met de internetbron.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Hiermee geeft u een gebruikersaccount op dat is gemachtigd voor het gebruik van de proxyserver die is opgegeven door de proxyparameter .
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Repository
Gebruik de parameter Opslagplaats om op te geven welke opslagplaats moet worden gezocht naar een module. Wordt gebruikt wanneer meerdere opslagplaatsen worden geregistreerd. Accepteert een door komma's gescheiden lijst met opslagplaatsen. Als u een opslagplaats wilt registreren, gebruikt u Register-PSRepository
. Als u geregistreerde opslagplaatsen wilt weergeven, gebruikt u Get-PSRepository
.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredVersion
Hiermee geeft u het exacte versienummer van de module op om op te nemen in de resultaten. RequiredVersion kan niet worden gebruikt in dezelfde opdracht als MinimumVersion of MaximumVersion.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RoleCapability
Hiermee geeft u een matrix van rolmogelijkheden op.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Hiermee geeft u een matrix van tags. Voorbeelden van tags zijn DesiredStateConfiguration, DSC, DSCResourceKit of PSModule.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
String[]
Uitvoerwaarden
PSRepositoryItemInfo
Find-Module
maakt PSRepositoryItemInfo-objecten die in de pijplijn kunnen worden verzonden naar cmdlets zoals Install-Module
.
Notities
PowerShell bevat de volgende aliassen voor Find-Module
:
- Alle platformen:
fimo
Belangrijk
Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u tls 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Zie de aankondiging in de PowerShell-blog voor meer informatie.
Verwante koppelingen
PowerShellGet
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor