Delen via

Find-Module

  • Referentie
Module:
PowerShellGet

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.

Dit is een proxy-cmdlet voor de Find-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Zie Find-PSResource voor meer informatie.

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.

De proxy-cmdlet wijst deze parameter toe aan de prerelease-parameter van Find-PSResource.

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 .

De proxy-cmdlet transformeert deze parameter naar de -Version * voordat u aanroept Find-PSResource.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Command

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de NameParameterSet van Find-PSResource.

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

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de NameParameterSet van Find-PSResource.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de NameParameterSet van Find-PSResource.

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

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de NameParameterSet van Find-PSResource.

Type:String[]
Accepted values:DscResource, Cmdlet, Function, RoleCapability
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een nuGet-versiezoekreeks te maken voor gebruik met de versieparameter van Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-MinimumVersion

De proxy-cmdlet gebruikt de waarde van deze parameter om een nuGet-versiezoekreeks te maken voor gebruik met de versieparameter van Find-PSResource.

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

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de NameParameterSet van Find-PSResource.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de NameParameterSet van Find-PSResource.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Repository

Gebruik de parameter Repository om op te geven in welke opslagplaats een module moet worden gezocht. 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

De proxy-cmdlet gebruikt de waarde van deze parameter om een nuGet-versiezoekreeks te maken voor gebruik met de versieparameter van Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-RoleCapability

De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de NameParameterSet van Find-PSResource.

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

String

Uri

PSCredential

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

De PowerShell Gallery biedt geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. U moet TLS 1.2 of hoger gebruiken. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:

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