Aracılığıyla paylaş


Find-Command

Modüllerdeki PowerShell komutlarını bulur.

Syntax

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

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

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: Ada göre bir komut bulma

Find-Command bir depodaki modülü bulmak için komutun adını kullanabilir. Birden çok ModuleNames içinde bir komut adı olabilir.

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, PSGallery'de arama yapmak için Repository parametresini kullanır. Name parametresi komutunu Get-TargetResourcebelirtir.

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

Find-Command komutunu ve modülünü bulup nesnesini adresine Install-Modulegönderebilir. Bir komut birden çok modüle dahil edilmişse, cmdlet'ler ModuleName parametresini kullanınFind-Command. Aksi takdirde, yüklemek istemediğiniz modüller yüklenmiş olabilir.

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

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

Find-Commandkomutunu Get-TargetResourcebelirtmek için Name parametresini kullanır. Repository parametresi PSGallery'de aramalar. ModuleName parametresi, yüklemek istediğiniz SystemLocaleDsc modülünü 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 kullanabilirsiniz Get-InstalledModule .

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

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 Invoke-ScriptAnalyzer aramak için Adve Depo parametrelerini kullanır. nesnesi işlem hattına Save-Modulegö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

Ön sürüm olarak işaretlenmiş modülleri sonuçlara ekler.

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

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

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

-Filter

Proxy cmdlet'i, commandnameparameterSet 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

-MaximumVersion

Proxy cmdlet'i, commandnameparameterSet 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

-MinimumVersion

Proxy cmdlet'i, commandnameparameterSet 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

-ModuleName

Proxy cmdlet'i, commandnameparameterSet 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

-Name

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

Proxy cmdlet'i bu parametreyi komutundaki CommandName parametresiyle eşler Find-PSResource.

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

-Proxy

Proxy cmdlet'i, commandnameparameterSet 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, commandnameparameterSet 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

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

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

-RequiredVersion

Proxy cmdlet'i, commandnameparameterSet 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

Proxy cmdlet'i, commandnameparameterSet 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

Çıkışlar

PSGetCommandInfo

Find-Command bir PSGetCommandInfo nesnesi çıktısı alır.

Notlar

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