Find-Module
Bir depoda belirtilen ölçütlerle eşleşen modülleri bulur.
Syntax
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>]
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 gibi cmdlet'lere Install-Moduleişlem hattına gönderilebilir.
Bir depoyu ilk kez Find-Module kullanmayı denediğinizde güncelleştirmeleri yüklemeniz istenebilir.
Depo kaynağı cmdlet'ine Register-PSRepository kayıtlı değilse bir hata döndürülür.
Find-Module , sürümü sınırlayan hiçbir parametre kullanılmadıysa modülün en yeni sürümünü döndürür. Bir deponun modül sürümlerinin listesini almak için AllVersions parametresini kullanın.
MinimumVersion parametresi belirtilirse, Find-Module modülün minimuma eşit veya ondan büyük sürümünü döndürür. Depoda daha yeni bir sürüm varsa, daha yeni sürüm döndürülür.
MaximumVersion parametresi belirtilirse, Find-Module modülün belirtilen sürümü aşmayan en yeni sürümünü döndürür.
RequiredVersion parametresi belirtilirse, Find-Module yalnızca belirtilen sürümle tam olarak eşleşen modül sürümünü döndürür.
Find-Module kaynaklar arasında ad çakışmaları olabileceğinden, kullanılabilir tüm modüllerde arama yapabilir.
Modül sürüm numaralarını alan parametreler, sürüm numaraları olarak biçimlendirilmiş dizeler bekler.
- Standart sürüm numaralarının
x.y.zbiçimi x, y ve z sayıdır - Yayın öncesi sürümler, bu sürüme rastgele dizenin atandığı
x.y.z-<prerelease_label>bir biçime<prerelease_label>sahiptir.
Aşağıdaki örneklerde, powershell galerisi tek kayıtlı depo olarak kullanılır.
Get-PSRepository kayıtlı depoları görüntüler. Birden çok kayıtlı deponuz varsa, deponun -Repository adını belirtmek için parametresini kullanın.
Ö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 * parametresini yıldız işareti () joker karakteriyle birlikte kullanır.
Örnek 3: Modülü en düşük sürüme göre 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.
MinimumVersion, 1.6.5 sürümünü belirtir.
Find-Module en düşük sürümü aştığı ve en güncel sürüm olduğu için 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ümlerin biçimi vardır <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...
Register-PSRepository cmdlet'i yeni bir depo kaydeder.
Name parametresi MySource adını atar.
SourceLocation parametresi, deponun adresini belirtir.
Cmdlet, Find-ModuleContoso modülünü belirtmek için * 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...
Find-Module cmdlet'i, PSGallery deposunu aramak için Repository parametresini kullanır.
Includes parametresi, parametrenin depoda arayabileceği bir işlev olan DscResource'ı 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şken için ad, açıklama ve etiketlerde arama yapılır.
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'i Find-Module, Depoda AppDomain araması yapmak 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.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-AllVersions
Sonuçlara modülün tüm sürümlerinin eklenmesini belirtir. AllVersions parametresini MinimumVersion, MaximumVersion veya RequiredVersion parametreleriyle kullanamazsınız.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Command
Modüllerde bulunacak komut dizisini belirtir. Komut bir işlev veya iş akışı olabilir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Credential
Belirtilen paket sağlayıcısı veya kaynağı için modül yükleme haklarına sahip bir kullanıcı hesabı belirtir.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-DscResource
DSC kaynaklarını içeren modüllerin adını veya adının bir bölümünü belirtir. PowerShell kuralları gereği, birden çok bağımsız değişken sağladığınızda BIR VEYA araması gerçekleştirir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Filter
PackageManagement sağlayıcısına özgü arama söz dizimini temel alan bir filtre belirtir. NuGet modülleri için bu parametre, PowerShell Galerisi web sitesindeki Arama çubuğu kullanılarak yapılan aramanın eşdeğeridir.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-IncludeDependencies
Bu işlemin Name parametresinde belirtilen modüle bağımlı olan tüm modülleri içerdiğini gösterir.
Parametre özellikleri
| Tür: | SwitchParameter |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Includes
Yalnızca belirli türde PowerShell işlevleri içeren modülleri döndürür. Örneğin, yalnızca DSCResource içeren modülleri bulmak isteyebilirsiniz. Bu parametre için kabul edilebilir değerler aşağıdaki gibidir:
- Cmdlet
- DscResource
- İşlev
- Rol Yeteneği
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Kabul edilen değerler: | DscResource, Cmdlet, Function, RoleCapability |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-MaximumVersion
Arama sonuçlarına dahil etmek için modülün en yüksek veya en son sürümünü belirtir. MaximumVersion ve RequiredVersion aynı komutta kullanılamaz.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-MinimumVersion
Sonuçlara dahil etmek için modülün en düşük sürümünü belirtir. MinimumVersion ve RequiredVersion aynı komutta kullanılamaz.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | True |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Proxy
doğrudan İnternet kaynağına bağlanmak yerine istek için bir ara sunucu belirtir.
Parametre özellikleri
| Tür: | Uri |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ProxyCredential
Proxy parametresi tarafından belirtilen ara sunucuyu kullanma iznine sahip bir kullanıcı hesabı belirtir.
Parametre özellikleri
| Tür: | PSCredential |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | 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. Bir depo kaydetmek için kullanın Register-PSRepository. Kayıtlı depoları görüntülemek için kullanın Get-PSRepository.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-RequiredVersion
Sonuçlara eklenecek modülün tam sürüm numarasını belirtir. RequiredVersion , MinimumVersion veya MaximumVersion ile aynı komutta kullanılamaz.
Parametre özellikleri
| Tür: | String |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-RoleCapability
Rol özellikleri dizisini belirtir.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Tag
Bir etiket dizisi belirtir. Örnek etiketler: DesiredStateConfiguration, DSC, DSCResourceKit veya PSModule.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | Named |
| Zorunlu: | False |
| İşlem hattından gelen değer: | False |
| Özellik adına göre işlem hattından gelen değer: | False |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
CommonParameters
Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.
Girişler
String
String
Uri
PSCredential
Çıkışlar
PSRepositoryItemInfo
Find-Modulegibi cmdlet'lere işlem hattına gönderilebilen Install-Module nesneleri oluşturur.
Notlar
PowerShell, Find-Moduleiçin aşağıdaki diğer adları içerir:
- Tüm platformlar:
fimo
Önemli
Nisan 2020 itibarıyla 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 kullanmıyorsanız PowerShell Galerisi'ne erişmeye çalışırken hata alırsınız. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Daha fazla bilgi için PowerShell blogunda duyuru bakın.
