Find-Command
Sucht PowerShell-Befehle in Modulen.
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>]Beschreibung
Das Find-Command Cmdlet sucht Nach PowerShell-Befehlen wie Cmdlets, Aliasen, Funktionen und Workflows. Find-Command durchsucht Module in registrierten Repositorys.
Dies ist ein Proxy-Cmdlet für das Find-PSResource Cmdlet in Microsoft.PowerShell.PSResourceGet. Weitere Informationen finden Sie unter Find-PSResource.
Beispiele
Beispiel 1: Suchen eines Befehls anhand des Namens
Find-Command kann den Namen eines Befehls verwenden, um das Modul in einem Repository zu suchen. Es ist möglich, dass ein Befehlsname in mehreren ModuleNames vorhanden ist.
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 PSGalleryFind-Command verwendet den Repository-Parameter , um die PSGallery zu durchsuchen. Der Parameter Name gibt den Befehl Get-TargetResourcean.
Beispiel 2: Suchen von Befehlen nach Namen und Installieren des Moduls
Find-Command kann den Befehl und das Modul suchen und dann das -Objekt an Install-Modulesenden. Wenn ein Befehl in mehreren Modulen enthalten ist, verwenden Sie den Find-CommandParameter "Cmdlets ModuleName ".
Andernfalls werden möglicherweise Module installiert, die Sie nicht installieren wollten.
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-Command verwendet den Name-Parameter , um den Befehl Get-TargetResourceanzugeben. Der Repository-Parameter durchsucht die PSGallery. Der Parameter ModuleName gibt das Modul an, das Sie installieren möchten, SystemLocaleDsc. Das Objekt wird von der Pipeline an Install-Module gesendet, und das Modul wird installiert. Nach Abschluss der Installation können Get-InstalledModule Sie verwenden, um die Ergebnisse anzuzeigen.
Beispiel 3: Suchen eines Befehls und Speichern des zugehörigen Moduls
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-Commandverwendet die Parameter Name und Repository, um im PSGallery-Repository nach dem Befehl Invoke-ScriptAnalyzer zu suchen. Das -Objekt wird in der Pipeline an Save-Modulegesendet. Der Path-Parameter bestimmt den Speicherort für das Modul. Verbose ist ein optionaler Parameter, zeigt jedoch status Ausgabe in der PowerShell-Konsole an. Die ausführliche Ausgabe ist für die Problembehandlung von Vorteil.
Parameter
-AllowPrerelease
Enthält Module, die als Vorabversion in den Ergebnissen markiert sind.
Das Proxy-Cmdlet ordnet diesen Parameter dem Prerelease-Parameter von zu Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom CommandNameParameterSet von Find-PSResourcenicht unterstützt wird.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom CommandNameParameterSet von Find-PSResourcenicht unterstützt wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom CommandNameParameterSet von Find-PSResourcenicht unterstützt wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom CommandNameParameterSet von Find-PSResourcenicht unterstützt wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom CommandNameParameterSet von Find-PSResourcenicht unterstützt wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Gibt den Befehlsnamen an, nach dem in einem Repository gesucht werden soll. Verwenden Sie Kommas, um ein Array von Befehlsnamen zu trennen.
Das Proxy-Cmdlet ordnet diesen Parameter dem CommandName-Parameter von zu Find-PSResource.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom CommandNameParameterSet von Find-PSResourcenicht unterstützt wird.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom CommandNameParameterSet von Find-PSResourcenicht unterstützt wird.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
Gibt das Repository an, das nach Befehlen gesucht werden soll. Verwenden Sie Kommas, um ein Array von Repositorynamen zu trennen. Der Standardwert sind alle Repositorys.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom CommandNameParameterSet von Find-PSResourcenicht unterstützt wird.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
Das Proxy-Cmdlet ignoriert diesen Parameter, da er vom CommandNameParameterSet von Find-PSResourcenicht unterstützt wird.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Ausgaben
PSGetCommandInfo
Find-Command gibt ein PSGetCommandInfo-Objekt aus.
Hinweise
Die PowerShell-Katalog die TLS-Versionen 1.0 und 1.1 (Transport Layer Security) nicht mehr unterstützt. Sie müssen TLS 1.2 oder höher verwenden. Mit dem folgenden Befehl können Sie sicherstellen, dass Sie TLS 1.2 verwenden:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Ähnliche Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für