Find-Command
Vindt PowerShell-opdrachten in modules.
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>]
Description
De Find-Command
cmdlet vindt PowerShell-opdrachten, zoals cmdlets, aliassen, functies en werkstromen. Find-Command
Zoekt naar modules in geregistreerde opslagplaatsen.
Voor elke opdracht die door Find-Command
wordt gevonden, wordt een PSGetCommandInfo-object geretourneerd. Het psGetCommandInfo-object kan door de pijplijn naar de Install-Module
cmdlet worden verzonden.
Install-Module
installeert de module die de opdracht bevat.
Voorbeelden
Voorbeeld 1: Alle opdrachten in een opgegeven opslagplaats zoeken
De Find-Command
cmdlet doorzoekt een geregistreerde opslagplaats voor modules.
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 door de pijplijn verzonden. Select-Object
ontvangt de objecten en gebruikt de parameter First om de eerste 10 resultaten weer te geven.
Voorbeeld 2: Een opdracht zoeken op naam
Find-Command
kan de naam van een opdracht gebruiken om de module in een opslagplaats te vinden. Het is mogelijk dat 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 te zoeken in de PSGallery. Met de parameter Name wordt de opdracht opgegeven Get-TargetResource
.
Voorbeeld 3: Opdrachten zoeken op naam en de module installeren
Find-Command
kan de opdracht en module vinden en vervolgens het object verzenden naar Install-Module
. Als een opdracht is opgenomen in meerdere modules, gebruikt u de Find-Command
cmdlets ModuleName 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 verzonden naar de pijplijn en Install-Module
de module wordt geïnstalleerd. Nadat de installatie is voltooid, kunt u gebruiken Get-InstalledModule
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 Naam en Opslagplaats om te zoeken naar de opdracht Invoke-ScriptAnalyzer
in de PSGallery-opslagplaats . Het object wordt door de pijplijn verzonden naar Save-Module
. De path-parameter bepaalt de locatie voor het opslaan van de module. Uitgebreid is een optionele parameter, maar geeft statusuitvoer weer in de PowerShell-console. De uitgebreide uitvoer is nuttig voor het oplossen van problemen.
Parameters
-AllowPrerelease
Bevat modules die zijn gemarkeerd als een voorlopige versie in de resultaten.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AllVersions
Geeft aan dat met deze cmdlet alle versies van een module worden ophaalt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Filter
Hiermee vindt u modules op basis van de zoeksyntaxis van de provider PackageManagement . Geef bijvoorbeeld woorden op waarnaar moet worden gezocht in de eigenschappen ModuleName en Description .
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumVersion
Hiermee geeft u de maximale versie van de module op die in de resultaten moet worden opgenomen. De parameters MaximumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinimumVersion
Hiermee geeft u de minimale versie van de module op die in de resultaten moet worden opgenomen. De parameters MinimumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde opdracht.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProxyCredential
Hiermee geeft u een gebruikersaccount op dat is gemachtigd voor het gebruik van de proxyserver die is opgegeven door de proxyparameter .
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Repository
Hiermee geeft u de opslagplaats op 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredVersion
Hiermee geeft u de versie van de module op die in de resultaten moet worden opgenomen.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Hiermee geeft u tags op die modules categoriseren in een opslagplaats. Gebruik komma's om een matrix met tags van elkaar te scheiden.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Uitvoerwaarden
PSGetCommandInfo
Find-Command
voert een PSGetCommandInfo-object uit.
Notities
Belangrijk
Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u tls 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Zie de aankondiging in de PowerShell-blog voor meer informatie.