Find-Command
Hiermee vindt u PowerShell-opdrachten in modules.
Syntaxis
Find-Command
[[-Name] <String[]>]
[-ModuleName <String>]
[-MinimumVersion <Version>]
[-MaximumVersion <Version>]
[-RequiredVersion <Version>]
[-AllVersions]
[-Tag <String[]>]
[-Filter <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Repository <String[]>]
[<CommonParameters>]Description
De Find-Command cmdlet vindt PowerShell-opdrachten, zoals cmdlets, aliassen, functies en werkstromen.
Find-Command doorzoekt modules in geregistreerde opslagplaatsen.
Voor elke opdracht die wordt gevonden door Find-Command, wordt een PSGetCommandInfo--object geretourneerd. Het PSGetCommandInfo--object kan naar de pijplijn worden verzonden naar de Install-Module-cmdlet.
Install-Module installeert de module die de opdracht bevat.
Voorbeelden
Voorbeeld 1: Alle opdrachten zoeken in een opgegeven opslagplaats
Met de Find-Command cmdlet wordt in een geregistreerde opslagplaats naar modules gezocht.
Find-Command -Repository PSGallery | Select-Object -First 10
Name Version ModuleName Repository
---- ------- ---------- ----------
Disable-AzureRmDataCollection 5.8.3 AzureRM.profile PSGallery
Disable-AzureRmContextAutosave 5.8.3 AzureRM.profile PSGallery
Enable-AzureRmDataCollection 5.8.3 AzureRM.profile PSGallery
Enable-AzureRmContextAutosave 5.8.3 AzureRM.profile PSGallery
Remove-AzureRmEnvironment 5.8.3 AzureRM.profile PSGallery
Get-AzureRmEnvironment 5.8.3 AzureRM.profile PSGallery
Set-AzureRmEnvironment 5.8.3 AzureRM.profile PSGallery
Add-AzureRmEnvironment 5.8.3 AzureRM.profile PSGallery
Get-AzureRmSubscription 5.8.3 AzureRM.profile PSGallery
Connect-AzureRmAccount 5.8.3 AzureRM.profile PSGallery
Find-Command gebruikt de parameter Opslagplaats om de naam van een geregistreerde opslagplaats op te geven. De objecten worden via de pijplijn verzonden.
Select-Object de objecten ontvangt en de parameter First gebruikt om de eerste 10 resultaten weer te geven.
Voorbeeld 2: Een opdracht zoeken op naam
Find-Command kunt de naam van een opdracht gebruiken om de module in een opslagplaats te vinden. Het is mogelijk dat er een opdrachtnaam bestaat in meerdere ModuleNames.
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 gebruikt de parameter Repository om de PSGallery-te doorzoeken. De parameter Name geeft de opdracht Get-TargetResource.
Voorbeeld 3: Opdrachten zoeken op naam en de module installeren
Find-Command kunt de opdracht en module vinden en vervolgens het object naar Install-Moduleverzenden. Als een opdracht is opgenomen in meerdere modules, gebruikt u de Find-Command cmdlets modulenaam parameter.
Anders kunnen modules worden geïnstalleerd die u niet wilt installeren.
PS> Find-Command -Name Get-TargetResource -Repository PSGallery -ModuleName SystemLocaleDsc |
Install-Module
PS> Get-InstalledModule
Version Name Repository Description
------- ---- ---------- -----------
1.2.0.0 SystemLocaleDsc PSGallery This DSC Resource allows configuration of the Windows...
Find-Command gebruikt de parameter Name om de opdracht Get-TargetResource-op te geven. De parameter Repository doorzoekt de PSGallery-. De parameter ModuleName geeft de module op die u wilt installeren, SystemLocaleDsc-. Het object wordt naar Install-Module verzonden naar de pijplijn en de module is geïnstalleerd. Nadat de installatie is voltooid, kunt u Get-InstalledModule gebruiken om de resultaten weer te geven.
Voorbeeld 4: Een opdracht zoeken en de module opslaan
PS> 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 gebruikt de parameters Name en Repository om te zoeken naar de opdracht Invoke-ScriptAnalyzer- in de PSGallery-opslagplaats. Het object wordt naar Save-Moduleverzonden. De parameter Path bepaalt de locatie voor het opslaan van de module.
Uitgebreide is een optionele parameter, maar geeft statusuitvoer weer in de PowerShell-console. De uitgebreide uitvoer is nuttig voor het oplossen van problemen.
Parameters
-AllVersions
Geeft aan dat deze cmdlet alle versies van een module ophaalt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Filter
Hiermee vindt u modules op basis van de zoeksyntaxis van de PackageManagement provider. Geef bijvoorbeeld woorden op waarnaar moet worden gezocht in de eigenschappen ModuleName en Description.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MaximumVersion
Hiermee geeft u de maximale versie van de module op die moet worden opgenomen in resultaten. De MaximumVersion en de parameters RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-MinimumVersion
Hiermee geeft u de minimale versie van de module op die moet worden opgenomen in resultaten. De MinimumVersion en de parameters RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-ModuleName
Hiermee geeft u de naam van een module om te zoeken naar opdrachten. De standaardwaarde is alle modules.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Name
Hiermee geeft u de opdrachtnaam te zoeken in een opslagplaats. Gebruik komma's om een matrix met opdrachtnamen te scheiden.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Proxy
Hiermee geeft u een proxyserver voor de aanvraag, in plaats van een directe verbinding met de internetbron.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-ProxyCredential
Hiermee geeft u een gebruikersaccount op dat is gemachtigd voor het gebruik van de proxyserver die is opgegeven door de Proxy parameter.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | True |
| Jokertekens accepteren: | False |
-Repository
Hiermee geeft u de opslagplaats om te zoeken naar opdrachten. Gebruik komma's om een matrix met namen van opslagplaatsen te scheiden. De standaardwaarde is alle opslagplaatsen.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-RequiredVersion
Hiermee geeft u de versie van de module op die in de resultaten moet worden opgenomen.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
-Tag
Hiermee geeft u tags op die modules in een opslagplaats categoriseren. Gebruik komma's om een matrix met tags te scheiden.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Vereist: | False |
| Pijplijninvoer accepteren: | False |
| Jokertekens accepteren: | False |
Uitvoerwaarden
PSGetCommandInfo
Find-Command voert een PSGetCommandInfo--object uit.