Find-Module

Module:

PowerShellGet Module

Hiermee vindt u modules in een opslagplaats die voldoen aan de opgegeven criteria.

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

Description

Met de Find-Module cmdlet worden modules in een opslagplaats gevonden 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 dat Find-Module 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 versies van een module op te halen.

Als de parameter MinimumVersion is opgegeven, Find-Module wordt de versie van de module geretourneerd 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 wordt de nieuwste versie van de module geretourneerd die niet hoger is dan de opgegeven versie.

Als de parameter RequiredVersion is opgegeven, Find-Module wordt alleen de moduleversie geretourneerd die exact overeenkomt met de opgegeven versie. Find-Module doorzoekt alle beschikbare modules, omdat 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
• Prerelease-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 -Repository parameter om de naam van de opslagplaats op te geven.

Voorbeelden

Voorbeeld 1: Een module zoeken op naam

In dit voorbeeld wordt een module gevonden in de standaardopslagplaats.

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 zoeken met vergelijkbare namen

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 vinden die PowerShell bevatten.

Voorbeeld 3: Een module zoeken op minimale versie

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 minimale versie 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. Prerelease-versies hebben een indeling van <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 Opslagplaats gebruikt om een module in een specifieke opslagplaats te vinden.

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 Repository geeft aan om de PSGallery-opslagplaats te doorzoeken.

Voorbeeld 6: Een module zoeken in meerdere opslagplaatsen

In dit voorbeeld wordt de Register-PSRepository opslagplaats opgegeven. 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...

De Register-PSRepository cmdlet registreert een nieuwe opslagplaats. Met de parameter Naam wordt de naam MySource toegewezen. De parameter SourceLocation geeft het adres van de opslagplaats op.

De Find-Module cmdlet gebruikt de parameter Name met het jokerteken sterretje (*) om de Contoso-module op te geven. De parameter Repository geeft aan 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 Inclusief .

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. De parameter Includes specificeert DscResource. Dit is een functionaliteit waarnaar de parameter kan zoeken in de opslagplaats.

Voorbeeld 8: Een module zoeken met een filter

In dit voorbeeld wordt een filter gebruikt om in de opslagplaats te zoeken.

Voor een NuGet-opslagplaats doorzoekt de filterparameter 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 filterparameter om in de opslagplaats naar AppDomain te zoeken.

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 Microsoft.PowerShell.Crescendo-module .

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 de resultatenmodules die zijn gemarkeerd als een voorlopige versie.

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-AllVersions

Hiermee geeft u alle versies van een module in de resultaten op. U kunt de parameter AllVersions niet gebruiken met de parameters MinimumVersion, MaximumVersion of RequiredVersion .

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Command

Hiermee geeft u een matrix van opdrachten te vinden in modules. Een opdracht kan een functie of werkstroom zijn.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Credential

Hiermee geeft u een gebruikersaccount met rechten voor het installeren van een module voor een opgegeven pakketprovider of bron.

Parametereigenschappen

Type:	PSCredential
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	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.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Filter

Hiermee geeft u een filter op basis van de providerspecifieke zoeksyntaxis van PackageManagement . Voor NuGet-modules is deze parameter het equivalent van zoeken met behulp van de zoekbalk op de website van de PowerShell Gallery .

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-IncludeDependencies

Geeft aan dat deze bewerking alle modules bevat die afhankelijk zijn van de module die is opgegeven in de parameter Naam .

Parametereigenschappen

Type:	SwitchParameter
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Includes

Retourneert alleen de modules die specifieke soorten PowerShell-functionaliteit bevatten. U wilt bijvoorbeeld alleen modules zoeken die DSCResource bevatten. De acceptabele waarden voor deze parameter zijn als volgt:

• Cmdlet
• DscResource
• Functie
• Rolvermogen

Parametereigenschappen

Type:	String[]
Default value:	None
Geaccepteerde waarden:	DscResource, Cmdlet, Function, RoleCapability
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-MaximumVersion

Hiermee geeft u het maximum of de meest recente versie van de module op die moet worden opgenomen in de zoekresultaten. MaximumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-MinimumVersion

Hiermee geeft u de minimale versie van de module op die moet worden opgenomen in resultaten. MinimumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Name

Hiermee geeft u de namen van modules te zoeken in de opslagplaats. Er wordt een door komma's gescheiden lijst met modulenamen geaccepteerd. Wildcards worden geaccepteerd.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	True
DontShow:	False

Parametersets

(All)

Position:	0
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Proxy

Hiermee geeft u een proxyserver voor de aanvraag op, in plaats van rechtstreeks verbinding te maken met de internetresource.

Parametereigenschappen

Type:	Uri
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-ProxyCredential

Hiermee geeft u een gebruikersaccount op dat gemachtigd is voor het gebruik van de proxyserver die is opgegeven door de proxyparameter .

Parametereigenschappen

Type:	PSCredential
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-Repository

Gebruik de parameter Opslagplaats om op te geven welke opslagplaats moet worden gezocht naar een module. Wordt gebruikt wanneer meerdere opslagplaatsen zijn 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.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-RequiredVersion

Hiermee geeft u het exacte versienummer van de module op dat in de resultaten moet worden opgenomen. RequiredVersion kan niet worden gebruikt in dezelfde opdracht als MinimumVersion of MaximumVersion.

Parametereigenschappen

Type:	String
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	True
Waarde van resterende argumenten:	False

-RoleCapability

Hiermee geeft u een matrix van rolmogelijkheden.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

-Tag

Hiermee specificeert u een reeks van tags. Voorbeelden van tags zijn DesiredStateConfiguration, DSC, DSCResourceKit of PSModule.

Parametereigenschappen

Type:	String[]
Default value:	None
Ondersteunt jokertekens:	False
DontShow:	False

Parametersets

(All)

Position:	Named
Verplicht:	False
Waarde uit pijplijn:	False
Waarde uit pijplijn op eigenschapsnaam:	False
Waarde van resterende argumenten:	False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

String

String

Uri

PSCredential

Uitvoerwaarden

PSRepositoryItemInfo

Find-Module maakt PSRepositoryItemInfo-objecten die naar de pijplijn kunnen worden verzonden naar cmdlets zoals Install-Module.

Notities

PowerShell bevat de volgende aliassen voor Find-Module:

• Alle platforms:
  • 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

• Get-PSRepository
• Install-Module
• Publish-Module
• Save-Module
• Uninstall-Module
• Update-Module
• Register-PSRepository