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 .

Si tratta di 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

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.

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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 .

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Command

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

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Credential

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

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-DscResource

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

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Filter

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

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-IncludeDependencies

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

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Includes

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

Tipo:	String[]
Valori accettati:	DscResource, Cmdlet, Function, RoleCapability
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	String[]
Posizione:	0
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	True

-Proxy

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

Tipo:	Uri
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-ProxyCredential

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

Tipo:	PSCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	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.

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-RoleCapability

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

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Tag

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

Tipo:	String[]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	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

PowerShell Gallery non supporta più Transport Layer Security (TLS) versioni 1.0 e 1.1. È necessario usare TLS 1.2 o versione successiva. Usare il comando seguente per assicurarsi di usare TLS 1.2:

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

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 contenente una risorsa DSC

Esempio 8: Trovare un modulo con un filtro

Esempio 9: Trovare un modulo in base al tag

Parametri

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Input

Output

Note

Collegamenti correlati