Find-Command
Hiermee vindt u 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.
Dit is een proxy-cmdlet voor de Find-PSResource cmdlet in Microsoft.PowerShell.PSResourceGet. Zie Find-PSResource voor meer informatie.
Voorbeelden
Voorbeeld 1: 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 PSGalleryFind-Command gebruikt de parameter Repository om in de PSGallery te zoeken. Met de parameter Name wordt de opdracht Get-TargetResourceopgegeven.
Voorbeeld 2: Opdrachten zoeken op naam en de module installeren
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.
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 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.
Voorbeeld 3: Een opdracht zoeken en de module opslaan
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.
De proxy-cmdlet wijst deze parameter toe aan de prerelease-parameter van Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
| 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 van elkaar te scheiden.
De proxy-cmdlet wijst deze parameter toe aan de parameter CommandName van Find-PSResource.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
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 |
-RequiredVersion
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
| 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
De PowerShell Gallery biedt geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. U moet TLS 1.2 of hoger gebruiken. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
Verwante koppelingen
PSResourceGet
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor