Find-Module

Moduł:

PowerShellGet v3 Module

Znajduje moduły w repozytorium, które spełniają określone kryteria.

Składnia

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

Opis

Polecenie Find-Module cmdlet znajduje moduły w repozytorium, które spełniają określone kryteria. Find-Module Zwraca obiekt PSRepositoryItemInfo dla każdego znalezionego modułu. Obiekty można wysyłać w dół potoku do poleceń cmdlet, takich jak Install-Module.

Jest to polecenie cmdlet serwera proxy dla Find-PSResource polecenia cmdlet w elemecie Microsoft.PowerShell.PSResourceGet. Aby uzyskać więcej informacji, zobacz Find-PSResource.

Przykłady

Przykład 1. Znajdowanie modułu według nazwy

W tym przykładzie moduł znajduje się w domyślnym repozytorium.

Find-Module -Name PowerShellGet

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

Polecenie Find-Module cmdlet używa parametru Name do określenia modułu PowerShellGet .

Przykład 2. Znajdowanie modułów o podobnych nazwach

W tym przykładzie użyto symbolu wieloznakowego gwiazdki (*), aby znaleźć moduły o podobnych nazwach.

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

Polecenie Find-Module cmdlet używa parametru Name z symbolem wieloznacznymi gwiazdki (*), aby znaleźć wszystkie moduły zawierające program PowerShell.

Przykład 3. Znajdowanie modułu według minimalnej wersji

Ten przykład wyszukuje minimalną wersję modułu. Jeśli repozytorium zawiera nowszą wersję modułu, zwracana jest nowsza wersja.

Find-Module -Name PowerShellGet -MinimumVersion 1.6.5

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

Polecenie Find-Module cmdlet używa parametru Name do określenia modułu PowerShellGet . Parametr MinimumVersion określa wersję 1.6.5. Find-Module Zwraca polecenie PowerShellGet w wersji 2.1.0 , ponieważ przekracza minimalną wersję i jest najnowszą wersją.

Przykład 4. Znajdowanie modułu według określonej wersji

W tym przykładzie pokazano, jak zainstalować określoną wersję wstępną modułu. Wersje wstępne mają format <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…

Przykład 5. Znajdowanie modułu w określonym repozytorium

W tym przykładzie użyto parametru Repository w celu znalezienia modułu w określonym repozytorium.

Find-Module -Name PowerShellGet -Repository PSGallery

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

Polecenie Find-Module cmdlet używa parametru Name do określenia modułu PowerShellGet . Parametr Repository określa, aby przeszukać repozytorium PSGallery .

Przykład 6. Znajdowanie modułu w wielu repozytoriach

W tym przykładzie użyto parametru , Register-PSRepository aby określić repozytorium. Find-Module używa repozytorium do wyszukiwania modułu.

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

Polecenie Register-PSRepository cmdlet rejestruje nowe repozytorium. Parametr Name przypisuje nazwę MySource. Parametr SourceLocation określa adres repozytorium.

Polecenie Find-Module cmdlet używa parametru Name z symbolem wieloznacznymi gwiazdki (*), aby określić moduł Contoso . Parametr Repository określa, aby przeszukiwać dwa repozytoria, PSGallery i MySource.

Przykład 7. Znajdowanie modułu zawierającego zasób DSC

To polecenie zwraca moduły zawierające zasoby DSC. Parametr Includes ma cztery wstępnie zdefiniowane funkcje, które są używane do przeszukiwania repozytorium. Użyj tabulacji, aby wyświetlić cztery funkcje obsługiwane przez parametr 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...

Polecenie Find-Module cmdlet używa parametru Repository do przeszukiwania repozytorium PSGallery. Parametr Includes określa dscResource, czyli funkcję, którą parametr może wyszukać w repozytorium.

Przykład 8. Znajdowanie modułu z filtrem

W tym przykładzie, aby znaleźć moduły, filtr jest używany do przeszukiwania repozytorium.

W przypadku repozytorium opartego na nuGet parametr Filter przeszukuje nazwę, opis i tagi dla argumentu.

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

Polecenie Find-Module cmdlet używa parametru Filter do przeszukiwania repozytorium appDomain.

Przykład 9. Znajdowanie modułu według tagu

W tym przykładzie pokazano, jak znaleźć moduły według tagu. Wartość CrescendoBuilt to tag, który jest automatycznie dodawany do modułów utworzonych przy użyciu modułu 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

Parametry

-AllowPrerelease

Zawiera w modułach wyników oznaczonych jako wersja wstępna.

Polecenie cmdlet serwera proxy mapuje ten parametr na parametr Wersji wstępnej .Find-PSResource

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-AllVersions

Określa, aby uwzględnić wszystkie wersje modułu w wynikach. Nie można użyć parametru AllVersions z parametrami MinimumVersion, MaximumVersion lub RequiredVersion.

Polecenie cmdlet serwera proxy przekształca ten parametr na -Version * przed wywołaniem metody Find-PSResource.

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Command

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr NameParameterSet klasy Find-PSResource.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Credential

Określa konto użytkownika, które ma uprawnienia do instalowania modułu dla określonego dostawcy pakietów lub źródła.

Właściwości parametru

Typ:	PSCredential
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-DscResource

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr NameParameterSet klasy Find-PSResource.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Filter

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr NameParameterSet klasy Find-PSResource.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-IncludeDependencies

Wskazuje, że ta operacja zawiera wszystkie moduły zależne od modułu określonego w parametrze Name .

Właściwości parametru

Typ:	SwitchParameter
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Includes

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr NameParameterSet klasy Find-PSResource.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Dopuszczalne wartości:	DscResource, Cmdlet, Function, RoleCapability
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-MaximumVersion

Polecenie cmdlet serwera proxy używa wartości tego parametru do utworzenia ciągu wyszukiwania wersji NuGet do użycia z parametrem Version parametru Find-PSResource.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-MinimumVersion

Polecenie cmdlet serwera proxy używa wartości tego parametru do utworzenia ciągu wyszukiwania wersji NuGet do użycia z parametrem Version parametru Find-PSResource.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Name

Określa nazwy modułów do wyszukania w repozytorium. Akceptowana jest rozdzielona przecinkami lista nazw modułów. Symbole wieloznaczne są akceptowane.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	True
DontShow:	False

Zestawy parametrów

(All)

Position:	0
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Proxy

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr NameParameterSet klasy Find-PSResource.

Właściwości parametru

Typ:	Uri
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-ProxyCredential

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr NameParameterSet klasy Find-PSResource.

Właściwości parametru

Typ:	PSCredential
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-Repository

Użyj parametru Repository , aby określić repozytorium do wyszukania modułu. Używane w przypadku zarejestrowania wielu repozytoriów. Akceptuje rozdzielaną przecinkami listę repozytoriów. Aby zarejestrować repozytorium, użyj polecenia Register-PSRepository. Aby wyświetlić zarejestrowane repozytoria, użyj polecenia Get-PSRepository.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-RequiredVersion

Polecenie cmdlet serwera proxy używa wartości tego parametru do utworzenia ciągu wyszukiwania wersji NuGet do użycia z parametrem Version parametru Find-PSResource.

Właściwości parametru

Typ:	String
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	True
Wartość z pozostałych argumentów:	False

-RoleCapability

Polecenie cmdlet serwera proxy ignoruje ten parametr, ponieważ nie jest obsługiwany przez parametr NameParameterSet klasy Find-PSResource.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

-Tag

Określa tablicę tagów. Przykładowe tagi obejmują DesiredStateConfiguration, DSC, DSCResourceKit lub PSModule.

Właściwości parametru

Typ:	String[]
Domyślna wartość:	None
Obsługuje symbole wieloznaczne:	False
DontShow:	False

Zestawy parametrów

(All)

Position:	Named
Obowiązkowy:	False
Wartość z potoku:	False
Wartość z potoku według nazwy właściwości:	False
Wartość z pozostałych argumentów:	False

CommonParameters

To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.

Dane wejściowe

String

String

Uri

PSCredential

Dane wyjściowe

PSRepositoryItemInfo

Find-Module Tworzy obiekty PSRepositoryItemInfo , które można wysłać w dół potoku do poleceń cmdlet, takich jak Install-Module.

Uwagi

Program PowerShell zawiera następujące aliasy dla Find-Module:

• Wszystkie platformy:
  • fimo

Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Należy użyć protokołu TLS 1.2 lub nowszego. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Linki powiązane

• Get-PSRepository
• Install-Module
• Publish-Module
• Save-Module
• Uninstall-Module
• Update-Module
• Register-PSRepository