Find-Module

Referencia

Modul:: PowerShellGet

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

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

Ez egy proxyparancsmag a Find-PSResourceMicrosoft.PowerShell.PSResourceGet parancsmaghoz. További információ: Find-PSResource.

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 bemutatja, hogyan telepíthető egy modul egy adott előzetes verziója. A prerelease-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 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.

9. példa: Modul keresése címke szerint

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 az előzetes kiadásként megjelölt eredménymodulokat.

A proxy parancsmag ezt a paramétert a prerelease paraméterreFind-PSResourceképezi le.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

A proxyparancsmag ezt a paramétert a hívás Find-PSResourceelőtt átalakítja.-Version *

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Command

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

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	PSCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-DscResource

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

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Filter

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

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Includes

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

Típus:	String[]
Elfogadott értékek:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-MaximumVersion

A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési sztringet, amely a következő verzióparaméterrelFind-PSResourcehasználható: .

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-MinimumVersion

A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési sztringet, amely a következő verzióparaméterrelFind-PSResourcehasználható: .

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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.

Típus:	String[]
Position:	0
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	True

-Proxy

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

Típus:	Uri
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ProxyCredential

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

Típus:	PSCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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: .

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-RequiredVersion

A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési sztringet, amely a következő verzióparaméterrelFind-PSResourcehasználható: .

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-RoleCapability

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

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

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

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

Minden platform:
- fimo

A PowerShell-katalógus már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. A TLS 1.2 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

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

Find-Module

Syntax

Description

Példák

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

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

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

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

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

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

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

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

9. példa: Modul keresése címke szerint

Paraméterek

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások