Find-Module

Modul:

PowerShellGet Module

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

Syntaxe

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

Rutina Find-Module najde moduly v úložišti, které odpovídají zadaným kritériím. Find-Module vrátí PSRepositoryItemInfo objekt pro každý modul, který najde. Objekty mohou být odeslány v kanálu rutinám, 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ý v Register-PSRepository rutině, vrátí se chyba.

Find-Module vrátí nejnovější verzi modulu, pokud se nepoužívají žádné parametry, které omezují verzi. Pokud chcete získat seznam verzí modulu úložiště, 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á je přesná shoda se zadanou verzí. Find-Module prohledává všechny dostupné moduly, protože může dojít ke konfliktům názvů mezi zdroji.

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

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

Následující příklady používají Galerii Prostředí PowerShell jako jediné registrované úložiště. Get-PSRepository zobrazí zaregistrovaná ú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

Tento příklad používá zástupný znak hvězdičky (*) k vyhledání modulů s podobnými názvy.

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 . Minimální verze 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 v několika úložištích

Tento příklad používá Register-PSRepository k určení úložiště. Find-Module používá ú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á k zadání modulu Contoso parametr * se zástupným znakem hvězdičky (). Parametr Repository určuje, že se mají prohledávat 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 vyhledávání v úložišti. Pomocí tabulátoru 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 používá parametr Repository k vyhledávání v úložišti 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žije 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 prohledá úložiště pro 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

Zahrnuje do modulů výsledků označených jako předběžná verze.

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-AllVersions

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Command

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Credential

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

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-DscResource

Určuje název nebo část názvu modulů, které obsahují prostředky DSC. Konvence PowerShellu provádějí vyhledávání nebo při zadání více argumentů.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Filter

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-IncludeDependencies

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

Vlastnosti parametru

Typ:	SwitchParameter
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Includes

Vrátí pouze ty moduly, které obsahují konkrétní typy 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í:

• cmdlet
• DscResource
• Funkce
• Schopnost role

Vlastnosti parametru

Typ:	String[]
Default value:	None
Přípustné hodnoty:	DscResource, Cmdlet, Function, RoleCapability
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-MaximumVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-MinimumVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Name

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	True
DontShow:	False

Sady parametrů

(All)

Position:	0
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Proxy

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

Vlastnosti parametru

Typ:	Uri
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-ProxyCredential

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

Vlastnosti parametru

Typ:	PSCredential
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-Repository

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-RequiredVersion

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

Vlastnosti parametru

Typ:	String
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	True
Hodnota ze zbývajících argumentů:	False

-RoleCapability

Určuje pole funkcí rolí.

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

-Tag

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

Vlastnosti parametru

Typ:	String[]
Default value:	None
Podporuje zástupné znaky:	False
DontShow:	False

Sady parametrů

(All)

Position:	Named
Povinné:	False
Hodnota z kanálu:	False
Hodnota z kanálu podle názvu vlastnosti:	False
Hodnota ze zbývajících argumentů:	False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

Vstupy

String

String

Uri

PSCredential

Výstupy

PSRepositoryItemInfo

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

Poznámky

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

• Všechny platformy:
  • fimo

Důležité

Od dubna 2020 galerie Prostředí PowerShell už 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 galerii 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í v blogu PowerShellu.

Související odkazy

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