Find-Command
Sucht PowerShell-Befehle in Modulen.
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>]
Beschreibung
Das cmdlet Find-Command 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 können den Namen eines Befehls verwenden, um das Modul in einem Repository zu suchen. Es ist möglich, dass ein Befehlsname in mehreren ModuleNamesvorhanden 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 Parameter Repository, um den PSGalleryzu durchsuchen. Der Parameter Name gibt den Befehl Get-TargetResourcean.
Beispiel 2: Suchen von Befehlen nach Namen und Installieren des Moduls
Find-Command können 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 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 parameter Repository durchsucht die PSGallery. Der parameter ModuleName gibt das Modul an, das Sie installieren möchten, SystemLocaleDsc. Das Objekt wird an Install-Module gesendet, und das Modul wird installiert. Nach Abschluss der Installation können Sie Get-InstalledModule verwenden, um die Ergebnisse anzuzeigen.
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 Invoke-ScriptAnalyzer nach dem Befehl zu suchen. Das Objekt wird in der Pipeline an Save-Module gesendet. Der parameter Path bestimmt den Speicherort zum Speichern des Moduls.
Ausführliche ist ein optionaler Parameter, zeigt jedoch 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-AllVersions
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Filter
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MaximumVersion
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-MinimumVersion
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-ModuleName
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Proxy
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.
Parametereigenschaften
| Typ: | Uri |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-ProxyCredential
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.
Parametereigenschaften
| Typ: | PSCredential |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-RequiredVersion
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.
Parametereigenschaften
| Typ: | String |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
-Tag
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht vom CommandNameParameterSet von Find-PSResource.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
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
