Freigeben über


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                 PSGallery

Find-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