Find-Module

Referens

Modul:: PowerShellGet

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.

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

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 returnerar ett objekt som representerar en moduls specifika version. Om den angivna versionen inte hittas returneras ett fel.

Find-Module -Name PowerShellGet -RequiredVersion 1.6.5

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

Cmdleten Find-Module använder parametern Namn för att ange PowerShellGet-modulen . Parametern RequiredVersion anger version 1.6.5.

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.

Parametrar

-AllowPrerelease

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

Type:	SwitchParameter
Position:	Named
Default value:	None
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 .

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

-Command

Anger en matris med kommandon som ska hittas i moduler. Ett kommando kan vara en funktion eller ett arbetsflöde.

Type:	String[]
Position:	Named
Default value:	None
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
Accept pipeline input:	True
Accept wildcard characters:	False

-DscResource

Anger namnet eller en del av namnet på moduler som innehåller DSC-resurser. Enligt PowerShell-konventioner utför en OR-sökning när du anger flera argument.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	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-galleriet webbplats.

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	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
DscResource
Funktion
RoleCapability

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

-MaximumVersion

Anger den maximala eller senaste versionen av modulen som ska ingå i sökresultaten. MaximumVersion och RequiredVersion kan inte användas i samma kommando.

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

-MinimumVersion

Anger den lägsta versionen av modulen som ska inkluderas i resultatet. MinimumVersion och RequiredVersion kan inte användas i samma kommando.

Type:	String
Position:	Named
Default value:	None
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
Accept pipeline input:	True
Accept wildcard characters:	False

-Proxy

Anger en proxyserver för begäran i stället för att ansluta direkt till Internetresursen.

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

-ProxyCredential

Anger ett användarkonto som har behörighet att använda proxyservern som anges av proxyparametern.

Type:	PSCredential
Position:	Named
Default value:	None
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
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-RoleCapability

Anger en matris med rollfunktioner.

Type:	String[]
Position:	Named
Default value:	None
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
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

Viktigt

Från och med april 2020 stöder PowerShell-galleriet inte längre TLS-versionerna 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 kontrollera att du använder TLS 1.2:

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

Mer information finns i tillkännagivandet i PowerShell-bloggen.