Find-Module

Modul:

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

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

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

Parametrar

-AllowPrerelease

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

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 .

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

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

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

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.

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

Anger ett filter baserat på providerspecifik söksyntax för PackageManagement . För NuGet-moduler motsvarar den här parametern att söka med hjälp av sökfältet på PowerShell-galleriet webbplats.

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

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

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

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

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

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

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

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

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

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

Anger det exakta versionsnumret för modulen som ska inkluderas i resultatet. RequiredVersion kan inte användas i samma kommando som MinimumVersion eller MaximumVersion.

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

Anger en matris med rollfunktioner.

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

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.

Relaterade länkar

• Get-PSRepository
• Install-Module
• Publish-Module
• Save-Module
• Uninstall-Module
• Update-Module
• Register-PSRepository