Find-Command

Modül:

PowerShellGet Module

Modüllerdeki PowerShell komutlarını bulur.

Syntax

All

Find-Command
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-AllowPrerelease]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [<CommonParameters>]

Description

Find-Command cmdlet'i cmdlet'ler, diğer adlar, işlevler ve iş akışları gibi PowerShell komutlarını bulur. Find-Command kayıtlı depolardaki modülleri arar.

Find-Commandtarafından bulunan her komut için bir PSGetCommandInfo nesnesi döndürülür. PSGetCommandInfo nesnesi, işlem hattını Install-Module cmdlet'ine gönderilebilir. Install-Module komutunu içeren modülü yükler.

Örnekler

Örnek 1: Belirtilen depodaki tüm komutları bulma

Find-Command cmdlet'i kayıtlı bir depoda modüller arar.

Find-Command -Repository PSGallery | Select-Object -First 10

Name                                Version    ModuleName          Repository
----                                -------    ----------          ----------
Disable-AzureRmDataCollection       5.8.3      AzureRM.profile     PSGallery
Disable-AzureRmContextAutosave      5.8.3      AzureRM.profile     PSGallery
Enable-AzureRmDataCollection        5.8.3      AzureRM.profile     PSGallery
Enable-AzureRmContextAutosave       5.8.3      AzureRM.profile     PSGallery
Remove-AzureRmEnvironment           5.8.3      AzureRM.profile     PSGallery
Get-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Set-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Add-AzureRmEnvironment              5.8.3      AzureRM.profile     PSGallery
Get-AzureRmSubscription             5.8.3      AzureRM.profile     PSGallery
Connect-AzureRmAccount              5.8.3      AzureRM.profile     PSGallery

Find-Command, kayıtlı bir deponun adını belirtmek için Deposu parametresini kullanır. Nesneler işlem hattına gönderilir. Select-Object nesneleri alır ve ilk 10 sonucu görüntülemek için first parametresini kullanır.

Örnek 2: Ada göre bir komut bulma

Find-Command, depodaki modülü bulmak için komutun adını kullanabilir. Bir komut adınınbirden çok ModuleNames içinde mevcut olması mümkündür.

Find-Command -Repository PSGallery -Name Get-TargetResource

Name                  Version    ModuleName                      Repository
----                  -------    ----------                      ----------
Get-TargetResource    3.1.0.0    xPowerShellExecutionPolicy      PSGallery
Get-TargetResource    1.0.0      xInternetExplorerHomePage       PSGallery
Get-TargetResource    1.2.0.0    SystemLocaleDsc                 PSGallery

Find-Command, PSGalleryaramak için Deposu parametresini kullanır. Name parametresi komutunu Get-TargetResourcebelirtir.

Örnek 3: Komutları ada göre bulma ve modülü yükleme

Find-Command komutunu ve modülünü bulup nesnesini Install-Modulegönderebilir. Bir komut birden çok modüle dahil edilmişse, cmdlets Find-Command parametresini kullanın. Aksi takdirde, yüklemek istemediğiniz modüller yüklenebilir.

PS> Find-Command -Name Get-TargetResource -Repository PSGallery -ModuleName SystemLocaleDsc |
    Install-Module

PS> Get-InstalledModule

Version   Name               Repository   Description
-------   ----               ----------   -----------
1.2.0.0   SystemLocaleDsc    PSGallery    This DSC Resource allows configuration of the Windows...

Find-Commandkomutunu belirtmek için Get-TargetResource parametresini kullanır. Deposu parametresi PSGalleryarar. ModuleName parametresi, SystemLocaleDscyüklemek istediğiniz modülü belirtir. nesnesi işlem hattına Install-Module gönderilir ve modül yüklenir. Yükleme tamamlandıktan sonra sonuçları görüntülemek için Get-InstalledModule kullanabilirsiniz.

Örnek 4: Bir komut bulma ve modülünü kaydetme

PS> Find-Command -Name Invoke-ScriptAnalyzer -Repository PSGallery | Save-Module -Path C:\Test\Modules -Verbose

VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/PSScriptAnalyzer/1.18.0'.
VERBOSE: Completed downloading 'PSScriptAnalyzer'.
VERBOSE: Module 'PSScriptAnalyzer' was saved successfully to path 'C:\Test\Modules\PSScriptAnalyzer\1.18.0'.

Find-Command , PSGallery deposunda komutu aramak için Invoke-ScriptAnalyzerve Depo parametrelerini kullanır. Nesne Save-Moduleişlem hattına gönderilir. Path parametresi modülün kaydedileceği konumu belirler. Ayrıntılı isteğe bağlı bir parametredir, ancak PowerShell konsolunda durum çıktısını görüntüler. Ayrıntılı çıkış, sorun giderme için yararlıdır.

Parametreler

-AllowPrerelease

Sonuçlara yayın öncesi olarak işaretlenmiş modülleri içerir.

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

Bu cmdlet'in bir modülün tüm sürümlerini aldığını 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

-Filter

PackageManagement sağlayıcısının arama söz dizimini temel alan modülleri bulur. Örneğin, ModuleName içinde aranacak sözcükleri belirtin ve Açıklama özellikleri .

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

-MaximumVersion

Sonuçlara dahil etmek için modülün en yüksek sürümünü belirtir. MaximumVersion ve RequiredVersion parametreleri 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:	False
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 parametreleri 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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ModuleName

Komut aranacak modülün adını belirtir. Varsayılan olarak tüm modüller kullanılır.

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

-Name

Bir depoda aranacak komut adını belirtir. Komut adları dizisini ayırmak için virgül kullanın.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
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:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Proxy

İnternet kaynağına doğrudan bağlantı 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

Komut aranacak depoyu belirtir. Depo adları dizisini ayırmak için virgül kullanın. Varsayılan değer tüm depolarıdır.

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 sürümünü 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

Depodaki modülleri kategorilere ayıran etiketleri belirtir. Bir etiket dizisini ayırmak için virgül kullanın.

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.

Çıkışlar

PSGetCommandInfo

Find-Command bir PSGetCommandInfo nesnesi 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'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.

İlişkili Bağlantılar

• Get-InstalledModule
• Install-Module
• Save-Module
• Nesne Seç
• Uninstall-Module