Find-Module

Odwołanie

Moduł:: PowerShellGet

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

Składnia

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.

Przy pierwszej Find-Module próbie użycia repozytorium może zostać wyświetlony monit o zainstalowanie aktualizacji. Jeśli źródło repozytorium nie jest zarejestrowane za pomocą Register-PSRepository polecenia cmdlet, zwracany jest błąd.

Find-Module Zwraca najnowszą wersję modułu, jeśli nie są używane żadne parametry ograniczające wersję. Aby uzyskać listę repozytoriów wersji modułu, użyj parametru AllVersions.

Jeśli określono parametr MinimumVersion , Find-Module zwraca wersję modułu, która jest równa lub większa niż minimalna. Jeśli w repozytorium jest dostępna nowsza wersja, zwracana jest nowsza wersja.

Jeśli określono parametr MaximumVersion , zwraca najnowszą wersję modułu, Find-Module która nie przekracza określonej wersji.

Jeśli określono parametr RequiredVersion , Find-Module zwraca tylko wersję modułu, która jest dokładnie zgodna z określoną wersją. Find-Module wyszukuje wszystkie dostępne moduły, ponieważ mogą wystąpić konflikty nazw między źródłami.

Parametry, które przyjmują numery wersji modułu, oczekują ciągów sformatowanych jako numery wersji.

Numery wersji standardowych mają format x.y.z , w którym x, y i z to liczby
Wersje wstępne mają format x.y.z-<prerelease_label> , w <prerelease_label> którym jest przypisany dowolny ciąg do tej wersji.

W poniższych przykładach użyto Galeria programu PowerShell jako jedynego zarejestrowanego repozytorium. Get-PSRepository Wyświetla zarejestrowane repozytoria. Jeśli masz wiele zarejestrowanych repozytoriów, użyj parametru -Repository , aby określić nazwę repozytorium.

Przykłady

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

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

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 Funkcja zwraca moduł 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 wyszukiwanie dwóch repozytoriów: 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 wyszukiwać w repozytorium.

Przykład 8. Znajdowanie modułu z filtrem

W tym przykładzie w celu znalezienia modułów filtr jest używany do przeszukiwania repozytorium.

W przypadku repozytorium opartego na oprogramowaniu NuGet parametr Filter przeszukuje nazwę, opis i tagi 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 dla parametru 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

Obejmuje moduły wyników oznaczone jako wersja wstępna.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Command

Określa tablicę poleceń do znalezienia w modułach. Polecenie może być funkcją lub przepływem pracy.

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

-Credential

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

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

-DscResource

Określa nazwę lub część nazwy modułów, które zawierają zasoby DSC. Podczas podawania wielu argumentów na konwencje programu PowerShell wykonuje wyszukiwanie OR .

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

-Filter

Określa filtr na podstawie składni wyszukiwania specyficznej dla dostawcy PackageManagement . W przypadku modułów NuGet ten parametr jest odpowiednikiem wyszukiwania przy użyciu paska wyszukiwania w witrynie internetowej Galeria programu PowerShell.

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

-IncludeDependencies

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

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

-Includes

Zwraca tylko te moduły, które zawierają określone rodzaje funkcji programu PowerShell. Na przykład można znaleźć tylko moduły, które obejmują DSCResource. Dopuszczalne wartości tego parametru są następujące:

Polecenie cmdlet
DscResource
Funkcja
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

Określa maksymalną lub najnowszą wersję modułu do uwzględnienia w wynikach wyszukiwania. Parametr MaximumVersion i RequiredVersion nie może być używany w tym samym poleceniu.

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

-MinimumVersion

Określa minimalną wersję modułu do uwzględnienia w wynikach. Parametr MinimumVersion i RequiredVersion nie może być używany w tym samym poleceniu.

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

-Name

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

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

-Proxy

Określa serwer proxy dla żądania, zamiast łączyć się bezpośrednio z zasobem internetowym.

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

-ProxyCredential

Określa konto użytkownika, które ma uprawnienia do korzystania z serwera proxy, który jest określony przez parametr proxy .

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-RequiredVersion

Określa dokładny numer wersji modułu do uwzględnienia w wynikach. Parametr RequiredVersion nie może być używany w tym samym poleceniu co MinimumVersion lub MaximumVersion.

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

-RoleCapability

Określa tablicę możliwości roli.

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

-Tag

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

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

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-Moduleprogramu :

Wszystkie platformy:
- fimo

Ważne

Od kwietnia 2020 r. Galeria programu PowerShell nie obsługuje już protokołu Transport Layer Security (TLS) w wersji 1.0 i 1.1. Jeśli nie używasz protokołu TLS 1.2 lub nowszego, podczas próby uzyskania dostępu do Galeria programu PowerShell zostanie wyświetlony błąd. Użyj następującego polecenia, aby upewnić się, że używasz protokołu TLS 1.2:

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

Aby uzyskać więcej informacji, zobacz ogłoszenie w blogu programu PowerShell.

Udostępnij za pośrednictwem

Find-Module

Składnia

Opis

Przykłady

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

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

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

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

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

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

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

Przykład 8. Znajdowanie modułu z filtrem

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

Parametry

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Dane wejściowe

Dane wyjściowe

Uwagi

Dodatkowe zasoby

Udostępnij za pośrednictwem

Find-Module

Składnia

Opis

Przykłady

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

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

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

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

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

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

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

Przykład 8. Znajdowanie modułu z filtrem

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

Parametry

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Dane wejściowe

Dane wyjściowe

Uwagi

Linki powiązane

Dodatkowe zasoby