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.

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

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

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.

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

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

-Command

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

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

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

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

-Filter

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

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

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

Type:	String[]
Accepted values:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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 .Find-PSResource

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

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

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

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

-ProxyCredential

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

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

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

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

-RoleCapability

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

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

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

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

Opinia

Dodatkowe zasoby

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

Opinia

Dodatkowe zasoby