Find-Module
Trova i moduli in un repository che soddisfano i criteri specificati.
Sintassi
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>]
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 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 utilizzati parametri che limitano la versione. Per ottenere l'elenco delle 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 si specifica il parametro RequiredVersion , Find-Module restituisce solo la versione del modulo che corrisponde 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.zcui 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 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
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
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 ricerche in due repository, PSGallery e MySource.
Esempio 7: Trovare un modulo contenente 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 in base al 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 non definitiva.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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 .
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Command
Specifica una matrice di comandi da trovare nei moduli. Un comando può essere una funzione o un flusso di lavoro.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Credential
Specifica un account utente con diritti per installare un modulo per un provider di pacchetti o un'origine specificati.
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-DscResource
Specifica il nome, o parte del nome, dei moduli che contengono risorse DSC. Per le convenzioni di PowerShell, esegue una ricerca OR quando si specificano più argomenti.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Filter
Specifica un filtro basato sulla sintassi di ricerca specifica del provider PackageManagement . Per i moduli NuGet, questo parametro equivale alla ricerca usando la barra di ricerca nel sito Web di PowerShell Gallery .
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-IncludeDependencies
Indica che questa operazione include tutti i moduli dipendenti dal modulo specificato nel parametro Name .
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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 (un piccolo script o comando in PowerShell)
- DscResource
- Funzione
- RuoloCapacità
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Valori accettati: | DscResource, Cmdlet, Function, RoleCapability |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-MinimumVersion
Specifica la versione minima del modulo da includere nei risultati. MinimumVersion e RequiredVersion non possono essere usati nello stesso comando.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | True |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-Proxy
Specifica un server proxy per la richiesta, anziché connettersi direttamente alla risorsa Internet.
Proprietà dei parametri
| Tipo: | Uri |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-ProxyCredential
Specifica un account utente autorizzato a usare il server proxy specificato dal parametro Proxy .
Proprietà dei parametri
| Tipo: | PSCredential |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | 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.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RequiredVersion
Specifica il numero esatto di versione del modulo da includere nei risultati. RequiredVersion non può essere usato nello stesso comando di MinimumVersion o MaximumVersion.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | True |
| Valore dagli argomenti rimanenti: | False |
-RoleCapability
Specifica una matrice di funzionalità del ruolo.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Tag
Specifica una matrice di tag. I tag di esempio includono DesiredStateConfiguration, DSC, DSCResourceKit o PSModule.
Proprietà dei parametri
| Tipo: | String[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
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
Importante
A partire da aprile 2020, PowerShell Gallery non supporta più le versioni 1.0 e 1.1 di Transport Layer Security (TLS). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si prova ad accedere a PowerShell Gallery. Usare il comando seguente per assicurarsi di usare TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Per altre informazioni, vedere l'annuncio nel blog di PowerShell.
