Find-Module
Hittar moduler på en lagringsplats som matchar angivna villkor.
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
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 cmdleten Find-PSResource 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 söka i två lagringsplatser, 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 i lagringsplatsen PSGallery.
Parametern Includes 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 parametern Filter igenom argumentets namn, beskrivning och taggar.
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 parametern Filter för att söka efter AppDomain på lagringsplatsen.
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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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 transformerar den här parametern till innan den -Version * anropar Find-PSResource.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Command
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Credential
Anger ett användarkonto som har behörighet att installera en modul för en angiven paketleverantör eller källa.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-DscResource
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Filter
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-IncludeDependencies
Anger att den här åtgärden innehåller alla moduler som är beroende av modulen som anges i parametern Namn .
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Includes
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Godkända värden: | DscResource, Cmdlet, Function, RoleCapability |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Name
Anger namnen på moduler som ska sökas efter på lagringsplatsen. En kommaavgränsad lista över modulnamn accepteras. Jokersymboler accepteras.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | True |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Proxy
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | Uri |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-ProxyCredential
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | PSCredential |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | String |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-RoleCapability
Proxy-cmdleten ignorerar den här parametern eftersom den inte stöds av NameParameterSet för Find-PSResource.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
-Tag
Anger en matris med taggar. Exempeltaggar är DesiredStateConfiguration, DSC, DSCResourceKit eller PSModule.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
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 stöder inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Du måste använda TLS 1.2 eller senare. Använd följande kommando för att se till att du använder TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
