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>]
Beskrivning
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.
Första gången Find-Module du försöker använda en lagringsplats kan du uppmanas att installera uppdateringar.
Om lagringsplatsens källa inte är registrerad med Register-PSRepository cmdlet returneras ett fel.
Find-Module returnerar den senaste versionen av en modul om inga parametrar används som begränsar versionen. Om du vill hämta en lagringsplatss lista över en moduls versioner använder du parametern AllVersions.
Om parametern MinimumVersion anges Find-Module returnerar modulens version som är lika med eller större än minimivärdet. Om det finns en nyare version tillgänglig på lagringsplatsen returneras den nyare versionen.
Om parametern MaximumVersion har angetts Find-Module returnerar den senaste versionen av modulen som inte överskrider den angivna versionen.
Om parametern RequiredVersion har angetts Find-Module returnerar den modulversion som är en exakt matchning till den angivna versionen.
Find-Module söker igenom alla tillgängliga moduler eftersom namnkonflikter mellan källor kan uppstå.
Parametrarna som tar modulversionsnummer förväntar sig strängar som formateras som versionsnummer.
- Standardversionsnummer
x.y.zhar ett format där x, y och z är tal - Förhandsversioner har ett format
x.y.z-<prerelease_label>där<prerelease_label>är godtycklig sträng tilldelad till den versionen.
I följande exempel används PowerShell-galleriet som den enda registrerade lagringsplatsen.
Get-PSRepository visar de registrerade lagringsplatserna. Om du har flera registrerade lagringsplatser använder du parametern -Repository för att ange lagringsplatsens namn.
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.
Egenskaper för parameter
| 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 .
Egenskaper för parameter
| 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
Anger en matris med kommandon som ska hittas i moduler. Ett kommando kan vara en funktion eller ett arbetsflöde.
Egenskaper för parameter
| 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.
Egenskaper för parameter
| 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
Anger namnet eller en del av namnet på moduler som innehåller DSC-resurser. Utför en ELLER-sökning enligt PowerShell-konventioner när du anger flera argument.
Egenskaper för parameter
| 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
Anger ett filter baserat på providerspecifik söksyntax för PackageManagement . För NuGet-moduler motsvarar den här parametern sökning med hjälp av sökfältet på PowerShell-galleriets webbplats.
Egenskaper för parameter
| 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 .
Egenskaper för parameter
| 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
Returnerar endast de moduler som innehåller specifika typer av PowerShell-funktioner. Du kanske till exempel bara vill hitta moduler som innehåller DSCResource. Godkända värden för den här parametern är följande:
- Cmdlet (ett PowerShell-kommando)
- DscResource
- Funktion
- RollKapacitet
Egenskaper för parameter
| 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
Anger den maximala eller senaste versionen av modulen som ska inkluderas i sökresultaten. MaximumVersion och RequiredVersion kan inte användas i samma kommando.
Egenskaper för parameter
| 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
Anger den lägsta versionen av modulen som ska inkluderas i resultatet. MinimumVersion och RequiredVersion kan inte användas i samma kommando.
Egenskaper för parameter
| 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.
Egenskaper för parameter
| 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
Anger en proxyserver för begäran i stället för att ansluta direkt till Internetresursen.
Egenskaper för parameter
| 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
Anger ett användarkonto som har behörighet att använda proxyservern som anges av proxyparametern.
Egenskaper för parameter
| 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.
Egenskaper för parameter
| 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
Anger det exakta versionsnumret för modulen som ska inkluderas i resultatet. RequiredVersion kan inte användas i samma kommando som MinimumVersion eller MaximumVersion.
Egenskaper för parameter
| 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
Anger en matris med rollfunktioner.
Egenskaper för parameter
| 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.
Egenskaper för parameter
| 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.
Ingångar
String
String
Uri
PSCredential
Utgångar
PSRepositoryItemInfo
Find-Module skapar PSRepositoryItemInfo-objekt som kan skickas ned i pipelinen till cmdletar som Install-Module.
Anteckningar
PowerShell innehåller följande alias för Find-Module:
- Alla plattformar:
fimo
Viktigt!
Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna (Transport Layer Security) 1.0 och 1.1. Om du inte använder TLS 1.2 eller senare får du ett felmeddelande när du försöker komma åt PowerShell-galleriet. Använd följande kommando för att se till att du använder TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Mer information finns i meddelande i PowerShell-bloggen.
