Find-Module
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ından gibi Install-Module
cmdlet'lere gönderilebilir.
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ılmazsa modülün en yeni sürümünü döndürür. 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 tüm kullanılabilir modüllerde arama yapabilir.
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-Module
PowerShellGet 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-Module
PowerShell içeren tüm modülleri bulmak için Ad 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-Module
PowerShellGet 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ığı 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 örnek, modülün belirli bir sürümünü temsil eden bir nesne döndürür. Belirtilen sürüm bulunamazsa bir hata döndürülür.
Find-Module -Name PowerShellGet -RequiredVersion 1.6.5
Version Name Repository Description
------- ---- ---------- -----------
1.6.5 PowerShellGet PSGallery PowerShell module with commands for discovering...
Cmdlet, Find-Module
PowerShellGet modülünü belirtmek için Name parametresini kullanır. RequiredVersion parametresi 1.6.5 sürümünü belirtir.
Ö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-Module
PowerShellGet 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-Module
Contoso modülünü belirtmek için yıldız işareti (*
) joker karakteriyle Name parametresini 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 tab-complete komutunu 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.
Parametreler
-AllowPrerelease
Yayın öncesi olarak işaretlenmiş sonuç modüllerine dahildir.
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Command
Modüllerde bulunacak komut dizisini belirtir. Komut bir işlev veya iş akışı olabilir.
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
DSC kaynaklarını içeren modüllerin adını veya adının bir bölümünü belirtir. PowerShell kuralları başına, birden çok bağımsız değişken sağladığınızda or araması gerçekleştirir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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ğunu kullanarak aramanın eşdeğeridir.
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
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 şunlardır:
- Cmdlet
- DscResource
- İşlev
- 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
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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
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: | False |
-Proxy
doğrudan İnternet kaynağına bağlanmak yerine istek için bir proxy sunucusu belirtir.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Proxy parametresi tarafından belirtilen ara sunucuyu kullanma iznine sahip bir kullanıcı hesabı belirtir.
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. Bir 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
Sonuçlara eklenecek modülün tam sürüm numarasını belirtir. RequiredVersion , MinimumVersion veya MaximumVersion ile aynı komutta kullanılamaz.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-RoleCapability
Rol yetenekleri dizisini belirtir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Bir etiket dizisi 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[]
Çıkışlar
PSRepositoryItemInfo
Find-Module
gibi Install-Module
cmdlet'lere işlem hattından gönderilebilen PSRepositoryItemInfo nesneleri oluşturur.
Notlar
Ö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 erişmeye çalışırken bir 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 blogundaki duyuruya bakın.