Find-Module

Modul:

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

Toto je rutina proxy pro tuto rutinu Find-PSResource v modulu Microsoft.PowerShell.PSResourceGet. Další informace naleznete 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

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.

Rutina proxy mapuje tento parametr na parametr Prerelease parametru Find-PSResource.

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 .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 vyšší. 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

Související odkazy

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