Sdílet prostřednictvím


Find-Module

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 se dají v kanálu odeslat do rutin, jako Install-Moduleje .

Toto je rutina proxy pro rutinu Find-PSResource v Microsoft.PowerShell.PSResourceGet. Další informace najdete v tématu Find-PSResource.

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 . Hodnota 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 k určení úložiště používá . 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čka (*) k určení modulu Contoso . 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 prohledávání úložiště. Pomocí 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 může parametr 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 k prohledávání úložiště.

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

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

Rutina proxy serveru mapuje tento parametr na parametr Předběžné verze pro Find-PSResource.

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 .

Rutina proxy před voláním Find-PSResourcetransformuje tento parametr na hodnotu -Version * .

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

-Command

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje NameParameterSet z .Find-PSResource

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

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

-DscResource

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje NameParameterSet z .Find-PSResource

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

-Filter

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje NameParameterSet z .Find-PSResource

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

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje NameParameterSet z .Find-PSResource

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

-MaximumVersion

Rutina proxy používá hodnotu tohoto parametru k vytvoření vyhledávacího řetězce verze NuGet pro použití s parametrem Version pro Find-PSResource.

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

-MinimumVersion

Rutina proxy používá hodnotu tohoto parametru k vytvoření vyhledávacího řetězce verze NuGet pro použití s parametrem Version pro Find-PSResource.

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í vyhledat v úložišti. 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

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje NameParameterSet z .Find-PSResource

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

-ProxyCredential

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje NameParameterSet z .Find-PSResource

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

Rutina proxy používá hodnotu tohoto parametru k vytvoření vyhledávacího řetězce verze NuGet pro použití s parametrem Version pro Find-PSResource.

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

-RoleCapability

Rutina proxy serveru tento parametr ignoruje, protože ho nepodporuje NameParameterSet z .Find-PSResource

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

Galerie prostředí PowerShell už nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Musíte použít protokol TLS 1.2 nebo novější. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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