Dela via


Find-Module

Söker efter moduler på en lagringsplats som matchar angivna villkor.

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

Cmdleten Find-Module hittar moduler på en lagringsplats som matchar de angivna kriterierna. Find-Module returnerar ett PSRepositoryItemInfo-objekt för varje modul som hittas. Objekten kan skickas ned i pipelinen till cmdletar som Install-Module.

Det här är en proxy-cmdlet för Find-PSResource cmdleten i Microsoft.PowerShell.PSResourceGet. Mer information finns i Find-PSResource.

Exempel

Exempel 1: Hitta en modul efter namn

Det här exemplet hittar en modul på standardlagringsplatsen.

Find-Module -Name PowerShellGet

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

Cmdleten Find-Module använder parametern Namn för att ange PowerShellGet-modulen .

Exempel 2: Hitta moduler med liknande namn

I det här exemplet används jokertecknet asterisk (*) för att hitta moduler med liknande namn.

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

Cmdleten Find-Module använder parametern Namn med jokertecknet asterisk (*) för att hitta alla moduler som innehåller PowerShell.

Exempel 3: Hitta en modul efter lägsta version

Det här exemplet söker efter en moduls lägsta version. Om lagringsplatsen innehåller en nyare version av modulen returneras den nyare versionen.

Find-Module -Name PowerShellGet -MinimumVersion 1.6.5

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

Cmdleten Find-Module använder parametern Namn för att ange PowerShellGet-modulen . MinimumVersion anger version 1.6.5. Find-Module returnerar PowerShellGet version 2.1.0 eftersom den överskrider den lägsta versionen och är den senaste versionen.

Exempel 4: Hitta en modul efter specifik version

Det här exemplet visar hur du installerar en specifik förhandsversion av en modul. Förhandsversioner har formatet <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…

Exempel 5: Hitta en modul på en specifik lagringsplats

I det här exemplet används parametern Lagringsplats för att hitta en modul på en specifik lagringsplats.

Find-Module -Name PowerShellGet -Repository PSGallery

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

Cmdleten Find-Module använder parametern Namn för att ange PowerShellGet-modulen . Parametern Repository anger att psGallery-lagringsplatsen ska sökas igenom.

Exempel 6: Hitta en modul i flera lagringsplatser

I det Register-PSRepository här exemplet används för att ange en lagringsplats. Find-Module använder lagringsplatsen för att söka efter en modul.

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

Cmdleten Register-PSRepository registrerar en ny lagringsplats. Parametern Namn tilldelar namnet MySource. Parametern SourceLocation anger lagringsplatsens adress.

Cmdleten Find-Module använder parametern Namn med jokertecknet asterisk (*) för att ange Contoso-modulen . Parametern Repository anger att två lagringsplatser ska sökas igenom, PSGallery och MySource.

Exempel 7: Hitta en modul som innehåller en DSC-resurs

Det här kommandot returnerar moduler som innehåller DSC-resurser. Parametern Includes har fyra fördefinierade funktioner som används för att söka på lagringsplatsen. Använd tab-complete för att visa de fyra funktioner som stöds av parametern Inkluderar .

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

Cmdleten Find-Module använder parametern Repository för att söka på lagringsplatsen PSGallery. Parametern Omfattar anger DscResource, vilket är en funktion som parametern kan söka efter på lagringsplatsen.

Exempel 8: Hitta en modul med ett filter

I det här exemplet används ett filter för att söka i lagringsplatsen för att hitta moduler.

För en NuGet-baserad lagringsplats söker filterparametern igenom namnet, beskrivningen och taggarna för argumentet.

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

Cmdleten Find-Module använder filterparametern för att söka på lagringsplatsen efter AppDomain.

Exempel 9: Hitta en modul efter tagg

Det här exemplet visar hur du hittar moduler med en tagg. Värdet CrescendoBuilt är en tagg som läggs till automatiskt i moduler som skapats med hjälp av modulen 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

Parametrar

-AllowPrerelease

Innehåller i resultatmodulerna som markerats som en förhandsversion.

Proxy-cmdleten mappar den här parametern till parametern Prerelease för Find-PSResource.

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

-AllVersions

Anger att alla versioner av en modul ska inkluderas i resultatet. Du kan inte använda parametern AllVersions med parametrarna MinimumVersion, MaximumVersion eller RequiredVersion .

Proxy-cmdleten omvandlar den här parametern till innan den -Version * anropar Find-PSResource.

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

-Command

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.

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

-Credential

Anger ett användarkonto som har behörighet att installera en modul för en angiven paketleverantör eller källa.

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

-DscResource

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.

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

-Filter

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.

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

-IncludeDependencies

Anger att den här åtgärden innehåller alla moduler som är beroende av modulen som anges i parametern Namn .

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

-Includes

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för 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

Proxy-cmdleten använder värdet för den här parametern för att skapa en NuGet-versionssökningssträng för användning med parametern Version för Find-PSResource.

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

-MinimumVersion

Proxy-cmdleten använder värdet för den här parametern för att skapa en NuGet-versionssökningssträng för användning med parametern Version för Find-PSResource.

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

-Name

Anger namnen på moduler som ska sökas efter på lagringsplatsen. En kommaavgränsad lista över modulnamn accepteras. Jokertecken accepteras.

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

-Proxy

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.

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

-ProxyCredential

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.

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

-Repository

Använd parametern Lagringsplats för att ange vilken lagringsplats som ska söka efter en modul. Används när flera lagringsplatser registreras. Accepterar en kommaavgränsad lista över lagringsplatser. Om du vill registrera en lagringsplats använder du Register-PSRepository. Om du vill visa registrerade lagringsplatser använder du Get-PSRepository.

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

-RequiredVersion

Proxy-cmdleten använder värdet för den här parametern för att skapa en NuGet-versionssökningssträng för användning med parametern Version för Find-PSResource.

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

-RoleCapability

Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.

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

-Tag

Anger en matris med taggar. Exempeltaggar är DesiredStateConfiguration, DSC, DSCResourceKit eller PSModule.

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

Indata

String[]

String

Uri

PSCredential

Utdata

PSRepositoryItemInfo

Find-Module skapar PSRepositoryItemInfo-objekt som kan skickas ned i pipelinen till cmdletar som Install-Module.

Kommentarer

PowerShell innehåller följande alias för Find-Module:

  • Alla plattformar:
    • fimo

PowerShell-galleriet har inte längre stöd för TLS-versionerna 1.0 och 1.1. Du måste använda TLS 1.2 eller senare. Använd följande kommando för att kontrollera att du använder TLS 1.2:

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