Find-Module

Modul:

PowerShellGet Module

Megkeresi a megadott feltételeknek megfelelő modulokat egy adattárban.

Syntax

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

A Find-Module parancsmag megkeresi a megadott feltételeknek megfelelő modulokat egy adattárban. 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.

Amikor először Find-Module próbál meg adattárat használni, előfordulhat, hogy a rendszer frissítések telepítésére kéri. Ha az adattár forrása nincs regisztrálva a parancsmaggal Register-PSRepository , a rendszer hibát ad vissza.

Find-Module A modul legújabb verzióját adja vissza, ha nem használ olyan paramétereket, amelyek korlátozzák a verziót. Az adattár modulverzióinak listájának lekéréséhez használja az AllVersions paramétert.

Ha a MinimumVersion paraméter meg van adva, Find-Module a modul minimális vagy annál nagyobb verzióját adja vissza. Ha az adattárban elérhető egy újabb verzió, a rendszer visszaadja az újabb verziót.

Ha a MaximumVersion paraméter meg van adva, a modul legújabb verzióját adja vissza, Find-Module amely nem haladja meg a megadott verziót.

Ha a RequiredVersion paraméter meg van adva, csak azt a modulverziót adja vissza, Find-Module amely pontosan megegyezik a megadott verzióval. Find-Module az összes elérhető modulban keres, mert a források között névütközések léphetnek fel.

Az alábbi példák a PowerShell-gyűjteményt használják az egyetlen regisztrált adattárként. Get-PSRepository megjeleníti a regisztrált adattárakat. Ha több regisztrált adattárral rendelkezik, a -Repository paraméter használatával adja meg az adattár nevét.

Példák

1. példa: Modul megkeresése név szerint

Ez a példa megkeres egy modult 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 Név 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 Név 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 visszaadja az újabb verziót.

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 Név 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 egy olyan objektumot ad vissza, amely egy modul adott verzióját képviseli. Ha a megadott verzió nem található, a rendszer hibát ad vissza.

Find-Module -Name PowerShellGet -RequiredVersion 1.6.5

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

A Find-Module parancsmag a Név paraméter használatával adja meg a PowerShellGet modult. A RequiredVersion paraméter az 1.6.5-ös verziót adja meg.

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 Név paraméter használatával adja meg a PowerShellGet modult. Az Adattár paraméter a PSGallery-adattár keresését adja meg.

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

Ez a példa egy Register-PSRepository adattár megadására használja. 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 regisztrál egy új adattárat. A Név paraméter hozzárendeli a MySource nevet. A SourceLocation paraméter megadja az adattár címét.

A Find-Module parancsmag a Név paramétert használja a csillag (*) helyettesítő karakterrel a Contoso modul megadásához. Az Adattár paraméter két adattárban, a PSGalleryben és a MySource-on való keresést határozza meg.

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

Ez a parancs DSC-erőforrásokat tartalmazó modulokat ad vissza. Az Includes paraméter négy előre definiált funkcióval rendelkezik, amelyek az adattárban való keresésre szolgálnak. A tabulátorral megjelenítheti az 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ár kereséséhez. Az Includes paraméter a DscResource-t adja meg, amely egy olyan funkció, amelyet a paraméter az adattárban kereshet.

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 Szűrő paraméter az argumentum nevére, leírására és címkéire 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 Szűrő paraméter használatával keres az AppDomain adattárában.

Paraméterek

-AllowPrerelease

Tartalmazza az előzetes kiadásként megjelölt eredménymodulokat.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-AllVersions

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Command

A modulokban keresendő parancsok tömbje. A parancsok lehetnek függvények vagy munkafolyamatok.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Credential

Olyan felhasználói fiókot határoz meg, amely jogosult modul telepítésére egy adott csomagszolgáltatóhoz vagy -forráshoz.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-DscResource

A DSC-erőforrásokat tartalmazó modulok nevét vagy egy részét adja meg. PowerShell-konvenciók szerint OR-keresést hajt végre, ha több argumentumot ad meg.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Filter

A PackageManagement szolgáltatóspecifikus keresési szintaxisán alapuló szűrőt ad meg. NuGet-modulok esetén ez a paraméter egyenértékű a PowerShell-galéria webhely keresősávjával végzett kereséssel.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-IncludeDependencies

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Includes

Csak azokat a modulokat adja vissza, amelyek bizonyos Típusú PowerShell-funkciókat tartalmaznak. Előfordulhat például, hogy csak a DSCResource-t tartalmazó modulokat szeretné megtalálni. A paraméter elfogadható értékei a következők:

• Cmdlet
• DscResource
• Funkció
• Szerepképesség

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Elfogadott értékek:	DscResource, Cmdlet, Function, RoleCapability
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-MaximumVersion

Megadja a modul maximális vagy legújabb verzióját, amely szerepel a keresési eredmények között. A MaximumVersion és a RequiredVersion nem használható ugyanabban a parancsban.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-MinimumVersion

Meghatározza a modul minimális verzióját, amely az eredményekbe belefoglalandó. A MinimumVersion és a RequiredVersion nem használható ugyanabban a parancsban.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Name

Megadja az adattárban keresni kívánt modulok nevét. A modulnevek vesszővel tagolt listája elfogadott. A helyettesítő karaktereket a rendszer elfogadja.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	0
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Proxy

Proxykiszolgálót ad meg a kéréshez, ahelyett, hogy közvetlenül csatlakozik az interneterőforráshoz.

Paramétertulajdonságok

Típus:	Uri
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-ProxyCredential

Olyan felhasználói fiókot ad meg, amely jogosult a proxyparaméter által megadott proxykiszolgáló használatára.

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Repository

Az Adattár paraméterrel megadhatja, hogy melyik adattárban keressen egy modult. Több adattár regisztrálásakor használatos. Elfogadja az adattárak vesszővel tagolt listáját. 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: .

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-RequiredVersion

Megadja annak a modulnak a pontos verziószámát, amely szerepel az eredmények között. A RequiredVersion nem használható ugyanabban a parancsban, mint a MinimumVersion vagy a MaximumVersion.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-RoleCapability

A szerepkör-képességek tömbjének megadása.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Tag

Egy címkék tömbjét határozza meg. Ilyen címkék például a DesiredStateConfiguration, a DSC, a DSCResourceKit vagy a PSModule.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

String

Uri

PSCredential

Kimenetek

PSRepositoryItemInfo

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

Jegyzetek

Fontos

2020 áprilisától a PowerShell-katalógus már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2 vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-gyűjtemény elérésekor. A következő paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

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

További információ: közlemény a PowerShell blogjában.

Kapcsolódó hivatkozások

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