Find-Module

Reference

Modul:: PowerShellGet

Vyhledá moduly v úložišti, které odpovídají zadaným kritériím.

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

Rutina Find-Module najde v úložišti moduly, které odpovídají zadaným kritériím. Find-Module vrátí objekt PSRepositoryItemInfo pro každý modul, který najde. Objekty je možné odeslat do kanálu do rutin, jako Install-Moduleje .

Při prvním Find-Module pokusu o použití úložiště se může zobrazit výzva k instalaci aktualizací. Pokud zdroj úložiště není zaregistrovaný pomocí Register-PSRepository rutiny, vrátí se chyba.

Find-Module vrátí nejnovější verzi modulu, pokud nejsou použity žádné parametry, které omezují verzi. Pokud chcete získat seznam verzí modulu v úložišti, použijte parametr AllVersions.

Pokud je zadán parametr MinimumVersion , Find-Module vrátí verzi modulu, která je rovna nebo větší než minimum. Pokud je v úložišti k dispozici novější verze, vrátí se novější verze.

Pokud je zadán parametr MaximumVersion , Find-Module vrátí nejnovější verzi modulu, která nepřekračuje zadanou verzi.

Pokud je zadán parametr RequiredVersion , Find-Module vrátí pouze verzi modulu, která přesně odpovídá zadané verzi. Find-Module prohledá všechny dostupné moduly, protože může docházet ke konfliktům názvů mezi zdroji.

Parametry, které přebírají čísla verzí modulů, očekávají řetězce formátované jako čísla verzí.

Standardní čísla verzí mají formát x.y.z , kde x, y a z jsou čísla.
Předběžné verze mají formát x.y.z-<prerelease_label> , ve kterém <prerelease_label> je k dané verzi přiřazen libovolný řetězec.

Následující příklady používají Galerie prostředí PowerShell jako jediné zaregistrované úložiště. Get-PSRepository zobrazí registrovaná úložiště. Pokud máte více registrovaných úložišť, zadejte název úložiště pomocí -Repository parametru .

Příklady

Příklad 1: Vyhledání modulu podle názvu

Tento příklad najde modul ve výchozím úložišti.

Find-Module -Name PowerShellGet

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

Rutina Find-Module používá parametr Name k určení modulu PowerShellGet .

Příklad 2: Vyhledání modulů s podobnými názvy

V tomto příkladu se k vyhledání modulů s podobnými názvy používá zástupný znak hvězdička (*).

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

Rutina Find-Module pomocí parametru Name se zástupným znakem hvězdička (*) vyhledá všechny moduly, které obsahují PowerShell.

Příklad 3: Vyhledání modulu podle minimální verze

Tento příklad vyhledá minimální verzi modulu. Pokud úložiště obsahuje novější verzi modulu, vrátí se novější verze.

Find-Module -Name PowerShellGet -MinimumVersion 1.6.5

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

Rutina Find-Module používá parametr Name k určení modulu PowerShellGet . MinimumVersion určuje verzi 1.6.5. Find-Module vrátí PowerShellGet verze 2.1.0 , protože překračuje minimální verzi a je nejnovější verzí.

Příklad 4: Vyhledání modulu podle konkrétní verze

Tento příklad ukazuje, jak nainstalovat konkrétní předběžnou verzi modulu. Předběžné verze mají formát <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…

Příklad 5: Vyhledání modulu v konkrétním úložišti

Tento příklad používá parametr Repository k vyhledání modulu v konkrétním úložišti.

Find-Module -Name PowerShellGet -Repository PSGallery

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

Rutina Find-Module používá parametr Name k určení modulu PowerShellGet . Parametr Repository určuje, že se má prohledávat úložiště PSGallery .

Příklad 6: Vyhledání modulu ve více úložištích

V tomto příkladu se Register-PSRepository používá k určení úložiště. Find-Module použije úložiště k vyhledání modulu.

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

Rutina Register-PSRepository zaregistruje nové úložiště. Parametr Name přiřadí název MySource. Parametr SourceLocation určuje adresu úložiště.

Rutina Find-Module používá parametr Name se zástupným znakem hvězdičky (*) k určení modulu Contoso . Parametr Repository určuje prohledat dvě úložiště , PSGallery a MySource.

Příklad 7: Vyhledání modulu, který obsahuje prostředek DSC

Tento příkaz vrátí moduly, které obsahují prostředky DSC. Parametr Includes má čtyři předdefinované funkce, které se používají k prohledávání úložiště. Pomocí příkazu tab-complete zobrazte čtyři funkce podporované parametrem Includes .

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

Rutina Find-Module pomocí parametru Repository prohledá úložiště PSGallery. Parametr Includes určuje DscResource, což je funkce, kterou parametr může vyhledat v úložišti.

Příklad 8: Vyhledání modulu s filtrem

V tomto příkladu se k vyhledání modulů používá filtr pro vyhledávání v úložišti.

V případě úložiště založeného na NuGetu prohledá parametr Filter název, popis a značky argumentu.

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

Rutina Find-Module pomocí parametru Filter vyhledá v úložišti AppDomain.

Příklad 9: Vyhledání modulu podle značky

Tento příklad ukazuje, jak najít moduly podle značky. Hodnota CrescendoBuilt je značka, která se automaticky přidá do modulů vytvořených pomocí modulu 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

Parametry

-AllowPrerelease

Zahrne do výsledků moduly označené jako předběžná verze.

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

-AllVersions

Určuje, že se mají do výsledků zahrnout všechny verze modulu. Parametr AllVersions nelze použít s parametry MinimumVersion, MaximumVersion nebo RequiredVersion .

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

-Command

Určuje pole příkazů, které se mají najít v modulech. Příkazem může být funkce nebo pracovní postup.

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

-Credential

Určuje uživatelský účet, který má práva k instalaci modulu pro zadaného poskytovatele balíčků nebo zdroj.

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

-DscResource

Určuje název nebo část názvu modulů, které obsahují prostředky DSC. Na základě konvencí PowerShellu provede vyhledávání NEBO , když zadáte více argumentů.

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

-Filter

Určuje filtr založený na syntaxi vyhledávání specifické pro zprostředkovatele PackageManagement . Pro moduly NuGet je tento parametr ekvivalentem vyhledávání pomocí panelu hledání na webu Galerie prostředí PowerShell.

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

-IncludeDependencies

Označuje, že tato operace zahrnuje všechny moduly, které jsou závislé na modulu zadaném v parametru Name .

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

-Includes

Vrátí pouze moduly, které obsahují konkrétní druhy funkcí PowerShellu. Můžete například chtít najít jenom moduly, které obsahují DSCResource. Přijatelné hodnoty pro tento parametr jsou následující:

Rutina
DscResource
Funkce
RoleCapability

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

-MaximumVersion

Určuje maximální nebo nejnovější verzi modulu, která se má zahrnout do výsledků hledání. MaximumVersion a RequiredVersion nelze použít ve stejném příkazu.

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

-MinimumVersion

Určuje minimální verzi modulu, která se má zahrnout do výsledků. MinimumVersion a RequiredVersion nelze použít ve stejném příkazu.

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

-Name

Určuje názvy modulů, které se mají v úložišti hledat. Přijímá se seznam názvů modulů oddělených čárkami. Zástupné cardy jsou přijímány.

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

-Proxy

Určuje proxy server pro požadavek místo přímého připojení k internetovému prostředku.

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

-ProxyCredential

Určuje uživatelský účet, který má oprávnění používat proxy server určený parametrem Proxy .

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

-Repository

Pomocí parametru Repository určete, které úložiště se má modul vyhledat. Používá se při registraci více úložišť. Přijímá seznam úložišť oddělených čárkami. K registraci úložiště použijte Register-PSRepository. Pokud chcete zobrazit registrovaná úložiště, použijte Get-PSRepository.

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

-RequiredVersion

Určuje přesné číslo verze modulu, který se má zahrnout do výsledků. RequiredVersion nelze použít ve stejném příkazu jako MinimumVersion nebo MaximumVersion.

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

-RoleCapability

Určuje pole schopností role.

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

-Tag

Určuje pole značek. Mezi příklady značek patří DesiredStateConfiguration, DSC, DSCResourceKit nebo PSModule.

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

Vstupy

String[]

String

Uri

PSCredential

Výstupy

PSRepositoryItemInfo

Find-Module vytvoří objekty PSRepositoryItemInfo , které lze odeslat do kanálu rutinám, jako Install-Moduleje .

Poznámky

PowerShell obsahuje následující aliasy pro Find-Module:

Všechny platformy:
- fimo

Důležité

Od dubna 2020 už Galerie prostředí PowerShell nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo vyšší, při pokusu o přístup k Galerie prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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

Další informace najdete v oznámení na blogu o PowerShellu.

Sdílet prostřednictvím

Find-Module

Syntax

Description

Příklady

Příklad 1: Vyhledání modulu podle názvu

Příklad 2: Vyhledání modulů s podobnými názvy

Příklad 3: Vyhledání modulu podle minimální verze

Příklad 4: Vyhledání modulu podle konkrétní verze

Příklad 5: Vyhledání modulu v konkrétním úložišti

Příklad 6: Vyhledání modulu ve více úložištích

Příklad 7: Vyhledání modulu, který obsahuje prostředek DSC

Příklad 8: Vyhledání modulu s filtrem

Příklad 9: Vyhledání modulu podle značky

Parametry

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Vstupy

Výstupy

Poznámky

Další materiály

Sdílet prostřednictvím

Find-Module

Syntax

Description

Příklady

Příklad 1: Vyhledání modulu podle názvu

Příklad 2: Vyhledání modulů s podobnými názvy

Příklad 3: Vyhledání modulu podle minimální verze

Příklad 4: Vyhledání modulu podle konkrétní verze

Příklad 5: Vyhledání modulu v konkrétním úložišti

Příklad 6: Vyhledání modulu ve více úložištích

Příklad 7: Vyhledání modulu, který obsahuje prostředek DSC

Příklad 8: Vyhledání modulu s filtrem

Příklad 9: Vyhledání modulu podle značky

Parametry

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Vstupy

Výstupy

Poznámky

Související odkazy

Další materiály