Find-Command
Hiermee vindt u PowerShell-opdrachten in modules.
Find-Command
[[-Name] <String[]>]
[-ModuleName <String>]
[-MinimumVersion <Version>]
[-MaximumVersion <Version>]
[-RequiredVersion <Version>]
[-AllVersions]
[-Tag <String[]>]
[-Filter <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Repository <String[]>]
[<CommonParameters>]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 wordt gevonden door Find-Command, wordt een PSGetCommandInfo-object geretourneerd. Het object PSGetCommandInfo kan via de pijplijn naar de Install-Module cmdlet worden verzonden.
Install-Module installeert de module die de opdracht bevat.
De Find-Command cmdlet zoekt in een geregistreerde opslagplaats naar 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 PSGalleryFind-Command gebruikt de parameter Repository 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.
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 PSGalleryFind-Command gebruikt de parameter Repository om in de PSGallery te zoeken. Met de parameter Name wordt de opdracht Get-TargetResourceopgegeven.
Find-Command kan de opdracht en module vinden en het object vervolgens 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 wilde 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-TargetResourceop te geven. Met de parameter Repository wordt de PSGallery doorzocht. De parameter ModuleName geeft de module op die u wilt installeren, SystemLocaleDsc. Het object wordt door de pijplijn verzonden naar Install-Module en de module wordt geïnstalleerd. Nadat de installatie is voltooid, kunt u gebruiken Get-InstalledModule om de resultaten weer te geven.
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.
Geeft aan dat deze cmdlet alle versies van een module ophaalt.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hiermee geeft u de naam van een module 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 |
Hiermee geeft u de opdrachtnaam te zoeken in een opslagplaats. Gebruik komma's om een matrix met opdrachtnamen van elkaar te scheiden.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
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 |
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 |
Hiermee geeft u de opslagplaats te zoeken naar opdrachten. Gebruik komma's om een matrix met opslagplaatsnamen van elkaar te scheiden. De standaardwaarde is alle opslagplaatsen.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hiermee geeft u de versie van de module op die in de resultaten moet worden opgenomen.
| Type: | Version |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Hiermee geeft u tags op die modules in een opslagplaats categoriseren. 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 |
PSCustomObject[]
Find-Command voert een PSCustomObject-object uit .
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.
PowerShellGet-feedback
PowerShellGet is een open source project. Selecteer een koppeling om feedback te geven: