Find-Module

Modulo:: PowerShellGet v3 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 .

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.

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 .

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

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

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

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

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

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

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

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

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

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

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.

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

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.

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

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

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

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

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

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.

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

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

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

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

Commenti e suggerimenti

Questa pagina è stata utile?

Condividi tramite

Find-Module

Sintassi

All

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

Proprietà dei parametri

Set di parametri

-AllVersions

Proprietà dei parametri

Set di parametri

-Command

Proprietà dei parametri

Set di parametri

-Credential

Proprietà dei parametri

Set di parametri

-DscResource

Proprietà dei parametri

Set di parametri

-Filter

Proprietà dei parametri

Set di parametri

-IncludeDependencies

Proprietà dei parametri

Set di parametri

-Includes

Proprietà dei parametri

Set di parametri

-MaximumVersion

Proprietà dei parametri

Set di parametri

-MinimumVersion

Proprietà dei parametri

Set di parametri

-Name

Proprietà dei parametri

Set di parametri

-Proxy

Proprietà dei parametri

Set di parametri

-ProxyCredential

Proprietà dei parametri

Set di parametri

-Repository

Proprietà dei parametri

Set di parametri

-RequiredVersion

Proprietà dei parametri

Set di parametri

-RoleCapability

Proprietà dei parametri

Set di parametri

-Tag

Proprietà dei parametri

Set di parametri

CommonParameters

Input

String

String

Uri

PSCredential

Output

PSRepositoryItemInfo

Note

Collegamenti correlati

Commenti e suggerimenti