Freigeben über

Find-Command

  • Referenz
Modul:
PowerShellGet

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 findet PowerShell-Befehle wie Cmdlets, Aliase, 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 nach Namen

Find-Command kann den Namen eines Befehls verwenden, um das Modul in einem Repository zu finden. 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-Module. Wenn ein Befehl in mehreren Modulen enthalten ist, verwenden Sie den Find-CommandParameter "Cmdlets ModuleName ". Andernfalls werden Module möglicherweise 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 Parameter Name , 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 an die Pipeline Install-Module gesendet und das Modul wird installiert. Nach Abschluss der Installation können Get-InstalledModule Sie die Ergebnisse anzeigen.

Beispiel 3: Suchen eines Befehls und Speichern des 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-Module gesendet. Der Path-Parameter bestimmt den Speicherort zum Speichern des Moduls. Verbose ist ein optionaler Parameter, zeigt aber die Statusausgabe in der PowerShell-Konsole an. Die ausführliche Ausgabe ist für die Problembehandlung von Vorteil.

Parameter

-AllowPrerelease

Enthält Module, die in den Ergebnissen als Vorabrelease gekennzeichnet sind.

Das Proxy-Cmdlet ordnet diesen Parameter dem Parameter Prerelease von Find-PSResource.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-AllVersions

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Filter

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MaximumVersion

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MinimumVersion

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ModuleName

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren: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 Find-PSResource.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Proxy

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.

Typ:Uri
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ProxyCredential

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.

Typ:PSCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Repository

Gibt das Repository an, das nach Befehlen gesucht werden soll. Verwenden Sie Kommas, um ein Array von Repositorynamen zu trennen. Der Standardwert ist alle Repositorys.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RequiredVersion

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Tag

Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

PSGetCommandInfo

Find-Command gibt ein PSGetCommandInfo -Objekt aus.

Hinweise

Der PowerShell-Katalog unterstützt die Tls-Versionen 1.0 und 1.1 nicht mehr. Sie müssen TLS 1.2 oder höher verwenden. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12