Find-Module

Başvuru

Modül:: PowerShellGet

Bir depoda belirtilen ölçütlerle eşleşen modülleri bulur.

Syntax

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

Description

Cmdlet, Find-Module bir depoda belirtilen ölçütlerle eşleşen modülleri bulur. Find-Module bulduğu her modül için bir PSRepositoryItemInfo nesnesi döndürür. Nesneler işlem hattına gibi Install-Modulecmdlet'lere gönderilebilir.

Bu, Microsoft.PowerShell.PSResourceGet içindeki cmdlet için Find-PSResource bir proxy cmdlet'idir. Daha fazla bilgi için bkz. Find-PSResource.

Örnekler

Örnek 1: Modülü ada göre bulma

Bu örnek, varsayılan depoda bir modül bulur.

Find-Module -Name PowerShellGet

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

Cmdlet, Find-ModulePowerShellGet modülünü belirtmek için Name parametresini kullanır.

Örnek 2: Benzer adlara sahip modülleri bulma

Bu örnekte benzer adlara sahip modülleri bulmak için yıldız işareti (*) joker karakteri kullanılır.

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

Cmdlet, Find-ModulePowerShell içeren tüm modülleri bulmak için Name parametresini yıldız işareti (*) joker karakteriyle birlikte kullanır.

Örnek 3: En düşük sürüme göre modül bulma

Bu örnekte modülün en düşük sürümü aranmaktadır. Depo modülün daha yeni bir sürümünü içeriyorsa, daha yeni sürüm döndürülür.

Find-Module -Name PowerShellGet -MinimumVersion 1.6.5

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

Cmdlet, Find-ModulePowerShellGet modülünü belirtmek için Name parametresini kullanır. MinimumVersion1.6.5 sürümünü belirtir. Find-Module , en düşük sürümü aştığından ve en güncel sürüm olduğundan PowerShellGet sürüm 2.1.0'ı döndürür.

Örnek 4: Belirli bir sürüme göre modül bulma

Bu örnekte, modülün belirli bir yayın öncesi sürümünün nasıl yükleneceği gösterilmektedir. Yayın öncesi sürümler biçimindedir <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…

Örnek 5: Belirli bir depoda modül bulma

Bu örnekte, belirli bir depodaki modülü bulmak için Repository parametresi kullanılır.

Find-Module -Name PowerShellGet -Repository PSGallery

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

Cmdlet, Find-ModulePowerShellGet modülünü belirtmek için Name parametresini kullanır. Repository parametresi, PSGallery deposunda arama yapmak için belirtir.

Örnek 6: Birden çok depoda modül bulma

Bu örnekte bir depo belirtmek için kullanılır Register-PSRepository . Find-Module bir modülü aramak için depoyu kullanır.

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

cmdlet'i Register-PSRepository yeni bir depo kaydeder. Name parametresi MySource adını atar. SourceLocation parametresi deponun adresini belirtir.

Cmdlet, Find-ModuleContoso modülünü belirtmek için Name parametresini yıldız işareti (*) joker karakteriyle birlikte kullanır. Repository parametresi, PSGallery ve MySource olmak üzere iki depoda arama yapmak için belirtir.

Örnek 7: DSC kaynağı içeren bir modülü bulma

Bu komut, DSC kaynaklarını içeren modülleri döndürür. Includes parametresi, depoda arama yapmak için kullanılan önceden tanımlanmış dört işleve sahiptir. Includes parametresi tarafından desteklenen dört işlevi görüntülemek için sekme-tamamlama özelliğini kullanın.

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

cmdlet'iFind-Module, PSGallery deposunu aramak için Repository parametresini kullanır. Includes parametresi, parametrenin depoda arayabileceği bir işlev olan DscResource'u belirtir.

Örnek 8: Filtre içeren bir modül bulma

Bu örnekte, modülleri bulmak için depoda arama yapmak için bir filtre kullanılır.

NuGet tabanlı bir depo için Filter parametresi bağımsız değişkeninin adı, açıklaması ve etiketlerini arar.

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

Cmdlet, Find-ModuleAppDomain deposunu aramak için Filter parametresini kullanır.

Örnek 9: Etikete göre modül bulma

Bu örnekte modülleri etikete göre bulma gösterilmektedir. CrescendoBuilt değeri, Microsoft.PowerShell.Crescendo modülü kullanılarak oluşturulan modüllere otomatik olarak eklenen bir etikettir.

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

Parametreler

-AllowPrerelease

Yayın öncesi olarak işaretlenmiş sonuç modüllerine dahildir.

Proxy cmdlet'i bu parametreyi ön sürüm parametresiyle eşler Find-PSResource.

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

-AllVersions

Sonuçlara modülün tüm sürümlerinin eklenmesini belirtir. AllVersions parametresini MinimumVersion, MaximumVersion veya RequiredVersion parametreleriyle kullanamazsınız.

Proxy cmdlet'i çağrıdan Find-PSResourceönce bu parametreyi öğesine -Version * dönüştürür.

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

-Command

Proxy cmdlet'i, nameParameterSet tarafından desteklenmediğinden bu parametreyi Find-PSResourceyoksayar.

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

-Credential

Belirtilen paket sağlayıcısı veya kaynağı için modül yükleme haklarına sahip bir kullanıcı hesabı belirtir.

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

-DscResource

Proxy cmdlet'i, nameParameterSet tarafından desteklenmediğinden bu parametreyi Find-PSResourceyoksayar.

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

-Filter

Proxy cmdlet'i, nameParameterSet tarafından desteklenmediğinden bu parametreyi Find-PSResourceyoksayar.

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

-IncludeDependencies

Bu işlemin Name parametresinde belirtilen modüle bağımlı olan tüm modülleri içerdiğini gösterir.

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

-Includes

Proxy cmdlet'i, nameParameterSet tarafından desteklenmediğinden bu parametreyi Find-PSResourceyoksayar.

Type:	String[]
Accepted values:	DscResource, Cmdlet, Function, RoleCapability
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumVersion

Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleFind-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

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

-MinimumVersion

Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleFind-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

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

-Name

Depoda aranacak modüllerin adlarını belirtir. Modül adlarının virgülle ayrılmış listesi kabul edilir. Joker karakterler kabul edilir.

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

-Proxy

Proxy cmdlet'i, nameParameterSet tarafından desteklenmediğinden bu parametreyi Find-PSResourceyoksayar.

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

-ProxyCredential

Proxy cmdlet'i, nameParameterSet tarafından desteklenmediğinden bu parametreyi Find-PSResourceyoksayar.

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

-Repository

Modül için hangi deponun aranacağını belirtmek için Repository parametresini kullanın. Birden çok depo kaydedildiğinde kullanılır. Depoların virgülle ayrılmış listesini kabul eder. Depo kaydetmek için kullanın Register-PSRepository. Kayıtlı depoları görüntülemek için kullanın Get-PSRepository.

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

-RequiredVersion

Proxy cmdlet'i, bu parametrenin değerini kullanarak version parametresiyleFind-PSResourcekullanılacak bir NuGet sürüm arama dizesi oluşturur.

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

-RoleCapability

Proxy cmdlet'i, nameParameterSet tarafından desteklenmediğinden bu parametreyi Find-PSResourceyoksayar.

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

-Tag

Bir etiket dizisini belirtir. Örnek etiketler şunlardır: DesiredStateConfiguration, DSC, DSCResourceKit veya PSModule.

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

Girişler

String[]

String

Uri

PSCredential

Çıkışlar

PSRepositoryItemInfo

Find-Modulegibi Install-Modulecmdlet'lere işlem hattından gönderilebilen PSRepositoryItemInfo nesneleri oluşturur.

Notlar

PowerShell, için Find-Moduleaşağıdaki diğer adları içerir:

Tüm platformlar:
- fimo

PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1.0 ve 1.1 sürümlerini desteklememektedir. TLS 1.2 veya üzerini kullanmanız gerekir. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:

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

Find-Module

Syntax

Description

Örnekler

Örnek 1: Modülü ada göre bulma

Örnek 2: Benzer adlara sahip modülleri bulma

Örnek 3: En düşük sürüme göre modül bulma

Örnek 4: Belirli bir sürüme göre modül bulma

Örnek 5: Belirli bir depoda modül bulma

Örnek 6: Birden çok depoda modül bulma

Örnek 7: DSC kaynağı içeren bir modülü bulma

Örnek 8: Filtre içeren bir modül bulma

Örnek 9: Etikete göre modül bulma

Parametreler

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Girişler

Çıkışlar

Notlar

Geri Bildirim

Ek kaynaklar

Find-Module

Syntax

Description

Örnekler

Örnek 1: Modülü ada göre bulma

Örnek 2: Benzer adlara sahip modülleri bulma

Örnek 3: En düşük sürüme göre modül bulma

Örnek 4: Belirli bir sürüme göre modül bulma

Örnek 5: Belirli bir depoda modül bulma

Örnek 6: Birden çok depoda modül bulma

Örnek 7: DSC kaynağı içeren bir modülü bulma

Örnek 8: Filtre içeren bir modül bulma

Örnek 9: Etikete göre modül bulma

Parametreler

-AllowPrerelease

-AllVersions

-Command

-Credential

-DscResource

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-RoleCapability

-Tag

Girişler

Çıkışlar

Notlar

İlişkili Bağlantılar

Geri Bildirim

Ek kaynaklar