Megosztás a következőn keresztül:


Find-Module

Megkeresi az adattár azon moduljait, amelyek megfelelnek a megadott feltételeknek.

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

A Find-Module parancsmag megkeresi az adattár azon moduljait, amelyek megfelelnek a megadott feltételeknek. Find-Module Egy PSRepositoryItemInfo objektumot ad vissza minden egyes megtalált modulhoz. Az objektumok elküldhetők a folyamaton olyan parancsmagoknak, mint a Install-Module.

Ez a Microsoft.PowerShell.PSResourceGet parancsmag proxyparancsmagjaFind-PSResource. További információ: Find-PSResource.

Példák

1. példa: Modul megkeresése név alapján

Ez a példa egy modult talál az alapértelmezett adattárban.

Find-Module -Name PowerShellGet

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

A Find-Module parancsmag a Name paraméter használatával adja meg a PowerShellGet modult.

2. példa: Hasonló nevű modulok keresése

Ez a példa a csillag (*) helyettesítő karakterrel keres hasonló nevű modulokat.

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

A Find-Module parancsmag a Name paramétert használja a csillag (*) helyettesítő karakterrel az összes PowerShell-modul megkereséséhez.

3. példa: Modul keresése minimális verzió szerint

Ez a példa egy modul minimális verzióját keresi. Ha az adattár a modul újabb verzióját tartalmazza, a rendszer az újabb verziót adja vissza.

Find-Module -Name PowerShellGet -MinimumVersion 1.6.5

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

A Find-Module parancsmag a Name paraméter használatával adja meg a PowerShellGet modult. A MinimumVersion az 1.6.5-ös verziót adja meg. Find-Module a PowerShellGet 2.1.0-s verzióját adja vissza, mert az meghaladja a minimális verziót, és a legújabb verzió.

4. példa: Modul keresése adott verzió szerint

Ez a példa bemutatja, hogyan telepítheti egy modul adott előzetes verzióját. Az előzetes verziók formátuma <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…

5. példa: Modul keresése egy adott adattárban

Ez a példa az Adattár paraméterrel keres egy modult egy adott adattárban.

Find-Module -Name PowerShellGet -Repository PSGallery

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

A Find-Module parancsmag a Name paraméter használatával adja meg a PowerShellGet modult. Az Adattár paraméter a PSGallery-adattárban való keresésre ad meg lehetőséget.

6. példa: Modul keresése több adattárban

Ez a példa a Register-PSRepository használatával határoz meg egy adattárat. Find-Module az adattár használatával keres egy modult.

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

A Register-PSRepository parancsmag új adattárat regisztrál. A Name paraméter hozzárendeli a MySource nevet. A SourceLocation paraméter határozza meg az adattár címét.

A Find-Module parancsmag a Name paramétert használja a csillag (*) helyettesítő karakterrel a Contoso modul megadásához. A Repository paraméter két adattárban( PSGallery és MySource) keres.

7. példa: DSC-erőforrást tartalmazó modul keresése

Ez a parancs DSC-erőforrásokat tartalmazó modulokat ad vissza. A Includes paraméter négy előre definiált funkcióval rendelkezik, amelyek az adattárban való keresésre szolgálnak. A Tab-complete paraméter használatával megjelenítheti a Includes paraméter által támogatott négy funkciót.

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

A Find-Module parancsmag az Adattár paramétert használja a PSGallery adattárban való kereséshez. A Includes paraméter a DscResource paramétert adja meg, amely egy olyan funkció, amelyre a paraméter rákereshet az adattárban.

8. példa: Modul keresése szűrővel

Ebben a példában a modulok kereséséhez egy szűrőt használunk az adattárban való kereséshez.

NuGet-alapú adattárak esetén a Filter paraméter az argumentum neve, leírása és címkéi között keres.

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

A Find-Module parancsmag a Filter paramétert használja az AppDomain adattárban való kereséshez.

9. példa: Modul keresése címke alapján

Ez a példa bemutatja, hogyan kereshet modulokat címke alapján. Az CrescendoBuilt érték egy olyan címke, amely automatikusan hozzáadódik a Microsoft.PowerShell.Crescendo modullal létrehozott modulokhoz.

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

Paraméterek

-AllowPrerelease

Tartalmazza a kiadás előttiként megjelölt eredménymodulokat.

A proxyparancsmag ezt a paramétert a Prerelease paraméterére Find-PSResourceképezi le.

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

-AllVersions

Meghatározza, hogy a modul összes verziója szerepeljen az eredmények között. Az AllVersions paraméter nem használható MinimumVersion, MaximumVersion vagy RequiredVersion paraméterekkel.

A proxy parancsmagja ezt a paramétert a -ra alakítja a -Version * hívás Find-PSResourceelőtt.

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

-Command

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel a NameParameterSet nem támogatja Find-PSResource.

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

-Credential

Olyan felhasználói fiókot ad meg, amely jogosultságokkal rendelkezik egy adott csomagszolgáltató vagy -forrás moduljának telepítéséhez.

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

-DscResource

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel a NameParameterSet nem támogatja Find-PSResource.

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

-Filter

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel a NameParameterSet nem támogatja Find-PSResource.

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

-IncludeDependencies

Azt jelzi, hogy ez a művelet tartalmazza az összes olyan modult, amely a Name paraméterben megadott modultól függ.

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

-Includes

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel a NameParameterSet nem támogatja 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

A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési Find-PSResourcesztringet a Verzió paraméterrel való használatra.

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

-MinimumVersion

A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési Find-PSResourcesztringet a Verzió paraméterrel való használatra.

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

-Name

Megadja az adattárban keresendő modulok nevét. A rendszer elfogadja a modulnevek vesszővel tagolt listáját. A rendszer helyettesítő karaktereket fogad el.

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

-Proxy

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel a NameParameterSet nem támogatja Find-PSResource.

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

-ProxyCredential

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel a NameParameterSet nem támogatja Find-PSResource.

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

-Repository

Az Adattár paraméterrel adhatja meg, hogy melyik adattárban szeretne modult keresni. Több adattár regisztrálásakor használatos. Az adattárak vesszővel tagolt listáját fogadja el. Adattár regisztrálásához használja a következőt Register-PSRepository: . A regisztrált adattárak megjelenítéséhez használja a következőt Get-PSRepository: .

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

-RequiredVersion

A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési Find-PSResourcesztringet a Verzió paraméterrel való használatra.

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

-RoleCapability

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel a NameParameterSet nem támogatja Find-PSResource.

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

-Tag

A címkék tömbjének megadása. Példacímkék: DesiredStateConfiguration, DSC, DSCResourceKit vagy PSModule.

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

Bevitelek

String[]

String

Uri

PSCredential

Kimenetek

PSRepositoryItemInfo

Find-ModulePSRepositoryItemInfo objektumokat hoz létre, amelyek elküldhetők a folyamaton olyan parancsmagoknak, mint a Install-Module.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza:Find-Module

  • Összes platform:
    • fimo

A PowerShell-galéria már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. A TLS 1.2-s vagy újabb verzióját kell használnia. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

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