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 wysłać w dół potoku do poleceń cmdlet, takich jak Install-Module.

Podczas pierwszej Find-Module próby użycia repozytorium może zostać wyświetlony monit o zainstalowanie aktualizacji. Jeśli źródło repozytorium nie zostało 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, które ograniczają wersję. Aby uzyskać listę wersji repozytorium 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 , Find-Module zwraca najnowszą wersję modułu, 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.

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

W tym przykładzie 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 zwracany jest obiekt reprezentujący określoną wersję modułu. Jeśli określona wersja nie zostanie znaleziona, zostanie zwrócony błąd.

Find-Module -Name PowerShellGet -RequiredVersion 1.6.5

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

Polecenie Find-Module cmdlet używa parametru Name do określenia modułu PowerShellGet . Parametr RequiredVersion określa wersję 1.6.5.

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

W tym przykładzie użyto parametru repozytorium do 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 Repozytorium określa, aby przeszukać repozytorium PSGallery .

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

W tym przykładzie użyto wartości , 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 repozytorium 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 Uwzględnij .

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, która jest 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 służy do przeszukiwania repozytorium.

W przypadku repozytorium opartego na nuGet parametr Filter wyszukuje 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 , aby wyszukać repozytorium AppDomain.

Parametry

-AllowPrerelease

Zawiera w modułach wyników oznaczonych 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 lub źródła pakietów.

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 zawierających zasoby DSC. Na konwencje programu PowerShell wykonuje wyszukiwanie OR po podaniu wielu argumentów.

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

-Filter

Określa filtr oparty na składni wyszukiwania specyficznej dla dostawcy PackageManagement . W przypadku modułów NuGet ten parametr jest odpowiednikiem wyszukiwania przy użyciu paska Search 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 zawiera 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żesz znaleźć tylko moduły, które obejmują dsCResource. Dopuszczalne wartości tego parametru są następujące:

Polecenie cmdlet
DscResource
Funkcja
RolaCapability

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. Akceptowane są symbole wieloznaczne.

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

-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 używania serwera proxy określonego przez parametr serwera proxy .

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

-Repository

Użyj parametru repozytorium , aby określić repozytorium do wyszukania modułu. Używane, gdy zarejestrowano wiele 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

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

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

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