Find-Module
Megkeresi a megadott feltételeknek megfelelő modulokat egy adattárban.
Syntax
All
Find-Module
[[-Name] <string[]>]
[-MinimumVersion <version>]
[-MaximumVersion <version>]
[-RequiredVersion <version>]
[-AllVersions]
[-IncludeDependencies]
[-Filter <string>]
[-Tag <string[]>]
[-Includes <string[]>]
[-DscResource <string[]>]
[-Command <string[]>]
[-Repository <string[]>]
[<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
-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 |
-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: | Cmdlet, DscResource, 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: | Version |
| 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: | Version |
| Alapértelmezett érték: | None |
| Támogatja a helyettesítő karaktereket: | False |
| DontShow: | False |
| Aliasok: | verzió |
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: | True |
| 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 |
-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: | Version |
| 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 |
-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.
Kimenetek
PSRepositoryItemInfo
Find-Module
PSRepositoryItemInfo objektumokat hoz létre, amelyek elküldhetők a folyamaton olyan parancsmagoknak, mint a Install-Module.
Jegyzetek
Ez a parancsmag a PowerShell 5.0-s vagy újabb kiadásain, a Windows 7 vagy a Windows 2008 R2 és a Windows újabb kiadásain fut.