Find-Module

Riferimento

Modulo:: PowerShellGet

Trova i moduli in un repository che soddisfano i 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 trova i moduli in un repository che soddisfano i criteri specificati. Find-Module restituisce un oggetto PSRepositoryItemInfo per ogni modulo trovato. Gli oggetti possono essere inviati alla pipeline ai cmdlet, ad Install-Moduleesempio .

La prima volta Find-Module che si tenta di usare un repository, potrebbe essere richiesto di installare gli aggiornamenti. Se l'origine del repository non è registrata con Register-PSRepository il cmdlet, viene restituito un errore.

Find-Module restituisce la versione più recente di un modulo se non vengono usati parametri che limitano la versione. Per ottenere l'elenco di versioni di un repository, usare il parametro AllVersions.

Se viene specificato il parametro MinimumVersion , Find-Module restituisce la versione del modulo uguale o maggiore del valore minimo. Se nel repository è disponibile una versione più recente, viene restituita la versione più recente.

Se viene specificato il parametro MaximumVersion , Find-Module restituisce la versione più recente del modulo che non supera la versione specificata.

Se viene specificato il parametro RequiredVersion , Find-Module restituisce solo la versione del modulo corrispondente esattamente alla versione specificata. Find-Module esegue ricerche in tutti i moduli disponibili, perché possono verificarsi conflitti di nomi tra origini.

I parametri che accettano numeri di versione del modulo prevedono stringhe formattate come numeri di versione.

I numeri di versione standard hanno un formato in x.y.z cui x, y e z sono numeri
Le versioni non definitive hanno un formato in x.y.z-<prerelease_label> cui la <prerelease_label> stringa è arbitraria assegnata a tale versione.

Gli esempi seguenti usano il PowerShell Gallery come unico repository registrato. Get-PSRepository visualizza i repository registrati. Se sono presenti più repository registrati, usare il -Repository parametro per specificare il nome del repository.

Esempio

Esempio 1: Trovare un modulo in base al nome

Questo esempio trova 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

In questo esempio viene cercata 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

Questo esempio illustra come installare una versione non definitiva specifica di un modulo. Le versioni non definitive hanno un formato .<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 di eseguire ricerche nel 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 di eseguire la ricerca in due repository, PSGallery e MySource.

Esempio 7: Trovare un modulo che contiene una risorsa DSC

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

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 Includes 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 i moduli, viene usato un filtro per eseguire ricerche nel 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 AppDomain nel repository.

Esempio 9: Trovare un modulo per tag

In questo esempio viene illustrato come trovare 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 non definitiva.

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 utilizzare il parametro AllVersions con i parametri MinimumVersion, MaximumVersion o RequiredVersion .

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

-Command

Specifica una matrice di comandi da trovare nei moduli. Un comando può essere una funzione o un flusso di lavoro.

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

Specifica il nome, o parte del nome, dei moduli che contengono risorse DSC. Per ogni convenzione di PowerShell, esegue una ricerca OR quando si specificano più argomenti.

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

-Filter

Specifica un filtro basato sulla sintassi di ricerca specifica del provider PackageManagement . Per i moduli NuGet, questo parametro è l'equivalente della ricerca usando la barra di ricerca nel sito Web di PowerShell Gallery.

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 che dipendono dal modulo specificato nel parametro Name .

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

-Includes

Restituisce solo i moduli che includono tipi specifici di funzionalità di PowerShell. Ad esempio, è possibile trovare solo moduli che includono DSCResource. I valori accettabili per questo parametro sono i seguenti:

Cmdlet
DscResource
Funzione
RoleCapability

Type:	String[]
Accepted values:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

Specifica la versione massima o più recente del modulo da includere nei risultati della ricerca. MaximumVersion e RequiredVersion non possono essere usati nello stesso comando.

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

-MinimumVersion

Specifica la versione minima del modulo da includere nei risultati. MinimumVersion e RequiredVersion non possono essere usati nello stesso comando.

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 di nomi di modulo. I caratteri jolly vengono accettati.

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

-Proxy

Specifica un server proxy per la richiesta, anziché connettersi direttamente alla risorsa Internet.

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

-ProxyCredential

Specifica un account utente con autorizzazioni per l'uso del server proxy specificato dal parametro Proxy.

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

-Repository

Usare il parametro Repository per specificare il repository in cui cercare un modulo. Usato quando vengono registrati più repository. Accetta un elenco delimitato da virgole di 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

Specifica il numero di versione esatto del modulo da includere nei risultati. RequiredVersion non può essere usato nello stesso comando di MinimumVersion o MaximumVersion.

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

-RoleCapability

Specifica una matrice di funzionalità del ruolo.

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, ad Install-Moduleesempio .

Note

PowerShell include gli alias seguenti per Find-Module:

Tutte le piattaforme:
- fimo

Importante

A partire da aprile 2020 PowerShell Gallery non supporta più le versioni 1.0 e 1.1 di TLS (Transport Layer Security). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si tenta di accedere a PowerShell Gallery. Per verificare di usare TLS 1.2, eseguire il comando seguente:

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

Per altre informazioni, vedere l'annuncio corrispondente nel blog di PowerShell.

Condividi tramite

Find-Module

Sintassi

Descrizione

Esempio

Esempio 1: Trovare un modulo in base al nome

Esempio 2: Trovare moduli con nomi simili

Esempio 3: Trovare un modulo per versione minima

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

Esempio 5: Trovare un modulo in un repository specifico

Esempio 6: Trovare un modulo in più repository

Esempio 7: Trovare un modulo che contiene una risorsa DSC

Esempio 8: Trovare un modulo con un filtro

Esempio 9: Trovare un modulo per tag

Parametri

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Input

Output

Note

Risorse aggiuntive

Condividi tramite

Find-Module

Sintassi

Descrizione

Esempio

Esempio 1: Trovare un modulo in base al nome

Esempio 2: Trovare moduli con nomi simili

Esempio 3: Trovare un modulo per versione minima

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

Esempio 5: Trovare un modulo in un repository specifico

Esempio 6: Trovare un modulo in più repository

Esempio 7: Trovare un modulo che contiene una risorsa DSC

Esempio 8: Trovare un modulo con un filtro

Esempio 9: Trovare un modulo per tag

Parametri

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Input

Output

Note

Collegamenti correlati

Risorse aggiuntive