Condividi tramite


Find-Module

Trova i moduli in un repository che corrispondono ai criteri specificati.

Sintassi

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

Descrizione

Il Find-Module cmdlet individua i moduli in un repository che corrispondono ai criteri specificati. Find-Module restituisce un oggetto PSRepositoryItemInfo per ogni modulo trovato. Gli oggetti possono essere inviati alla pipeline ai cmdlet, Install-Modulead esempio .

Questo è un cmdlet proxy per il Find-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Per altre informazioni, vedere Find-PSResource.

Esempio

Esempio 1: Trovare un modulo in base al nome

In questo esempio viene trovato un modulo nel repository predefinito.

Find-Module -Name PowerShellGet

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

Il Find-Module cmdlet usa il parametro Name per specificare il modulo PowerShellGet .

Esempio 2: Trovare moduli con nomi simili

In questo esempio viene usato il carattere jolly asterisco (*) per trovare moduli con nomi simili.

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

Il Find-Module cmdlet usa il parametro Name con il carattere jolly asterisco (*) per trovare tutti i moduli che contengono PowerShell.

Esempio 3: Trovare un modulo per versione minima

Questo esempio cerca la versione minima di un modulo. Se il repository contiene una versione più recente del modulo, viene restituita la versione più recente.

Find-Module -Name PowerShellGet -MinimumVersion 1.6.5

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

Il Find-Module cmdlet usa il parametro Name per specificare il modulo PowerShellGet . MinimumVersion specifica la versione 1.6.5. Find-Module restituisce PowerShellGet versione 2.1.0 perché supera la versione minima ed è la versione più recente.

Esempio 4: Trovare un modulo in base a una versione specifica

In questo esempio viene illustrato come installare una versione preliminare specifica di un modulo. Le versioni precedenti hanno un formato di <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…

Esempio 5: Trovare un modulo in un repository specifico

In questo esempio viene usato il parametro Repository per trovare un modulo in un repository specifico.

Find-Module -Name PowerShellGet -Repository PSGallery

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

Il Find-Module cmdlet usa il parametro Name per specificare il modulo PowerShellGet . Il parametro Repository specifica per cercare il repository PSGallery .

Esempio 6: Trovare un modulo in più repository

In questo esempio viene usato per Register-PSRepository specificare un repository. Find-Module usa il repository per cercare un modulo.

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

Il Register-PSRepository cmdlet registra un nuovo repository. Il parametro Name assegna il nome MySource. Il parametro SourceLocation specifica l'indirizzo del repository.

Il Find-Module cmdlet usa il parametro Name con il carattere jolly asterisco (*) per specificare il modulo Contoso . Il parametro Repository specifica la ricerca di due repository, PSGallery e MySource.

Esempio 7: Trovare un modulo contenente una risorsa DSC

Questo comando restituisce i moduli che contengono risorse DSC. Il parametro Include include quattro funzionalità predefinite usate per eseguire ricerche nel repository. Usare tabulazioni complete per visualizzare le quattro funzionalità supportate dal parametro Include .

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

Il Find-Module cmdlet usa il parametro Repository per eseguire ricerche nel repository, PSGallery. Il parametro Include specifica DscResource, ovvero una funzionalità che il parametro può cercare nel repository.

Esempio 8: Trovare un modulo con un filtro

In questo esempio, per trovare moduli, viene usato un filtro per cercare il repository.

Per un repository basato su NuGet, il parametro Filter cerca il nome, la descrizione e i tag per l'argomento.

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

Il Find-Module cmdlet usa il parametro Filter per cercare il repository per AppDomain.

Esempio 9: Trovare un modulo per tag

In questo esempio viene illustrato come trovare i moduli in base a un tag. Il CrescendoBuilt valore è un tag aggiunto automaticamente ai moduli creati usando il modulo 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

Parametri

-AllowPrerelease

Include nei moduli dei risultati contrassegnati come versione preliminare.

Il cmdlet proxy esegue il mapping di questo parametro al parametro Prerelease di Find-PSResource.

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

-AllVersions

Specifica di includere tutte le versioni di un modulo nei risultati. Non è possibile usare il parametro AllVersions con i parametri MinimumVersion, MaximumVersion o RequiredVersion .

Il cmdlet proxy trasforma questo parametro in -Version * prima di chiamare Find-PSResource.

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

-Command

Il cmdlet proxy ignora questo parametro perché non è supportato da NameParameterSet di Find-PSResource.

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

-Credential

Specifica un account utente con diritti per installare un modulo per un provider di pacchetti o un'origine specificati.

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

-DscResource

Il cmdlet proxy ignora questo parametro perché non è supportato da NameParameterSet di Find-PSResource.

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

-Filter

Il cmdlet proxy ignora questo parametro perché non è supportato da NameParameterSet di Find-PSResource.

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

-IncludeDependencies

Indica che questa operazione include tutti i moduli dipendenti dal modulo specificato nel parametro Name .

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

-Includes

Il cmdlet proxy ignora questo parametro perché non è supportato da NameParameterSet di 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

Il cmdlet proxy usa il valore di questo parametro per creare una stringa di ricerca della versione NuGet da usare con il parametro Version di Find-PSResource.

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

-MinimumVersion

Il cmdlet proxy usa il valore di questo parametro per creare una stringa di ricerca della versione NuGet da usare con il parametro Version di Find-PSResource.

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

-Name

Specifica i nomi dei moduli da cercare nel repository. Viene accettato un elenco delimitato da virgole dei nomi dei moduli. I caratteri jolly sono accettati.

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

-Proxy

Il cmdlet proxy ignora questo parametro perché non è supportato da NameParameterSet di Find-PSResource.

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

-ProxyCredential

Il cmdlet proxy ignora questo parametro perché non è supportato da NameParameterSet di Find-PSResource.

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

-Repository

Usare il parametro Repository per specificare quale repository cercare un modulo. Usato quando vengono registrati più repository. Accetta un elenco delimitato da virgole dei repository. Per registrare un repository, usare Register-PSRepository. Per visualizzare i repository registrati, usare Get-PSRepository.

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

-RequiredVersion

Il cmdlet proxy usa il valore di questo parametro per creare una stringa di ricerca della versione NuGet da usare con il parametro Version di Find-PSResource.

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

-RoleCapability

Il cmdlet proxy ignora questo parametro perché non è supportato da NameParameterSet di Find-PSResource.

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

-Tag

Specifica una matrice di tag. I tag di esempio includono DesiredStateConfiguration, DSC, DSCResourceKit o PSModule.

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

Input

String[]

String

Uri

PSCredential

Output

PSRepositoryItemInfo

Find-Module crea oggetti PSRepositoryItemInfo che possono essere inviati alla pipeline ai cmdlet, Install-Modulead esempio .

Note

PowerShell include gli alias seguenti per Find-Module:

  • Tutte le piattaforme:
    • fimo

La PowerShell Gallery non supporta più Transport Layer Security (TLS) versioni 1.0 e 1.1. È necessario usare TLS 1.2 o versione successiva. Per verificare di usare TLS 1.2, eseguire il comando seguente:

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