Find-Command
Hiermee vindt u PowerShell-opdrachten in modules.
Syntaxis
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>]
Description
De Find-Command cmdlet vindt PowerShell-opdrachten, zoals cmdlets, aliassen, functies en werkstromen.
Find-Command doorzoekt 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 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. Met de parameter Name geeft u de opdracht Get-TargetResourceop.
Voorbeeld 2: 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 parameter Find-Command van cmdlets.
Anders kunnen modules worden geïnstalleerd die u niet wilt 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. 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 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 via de pijpleiding 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
-AllowPrerelease
Bevat modules die zijn gemarkeerd als een voorlopige versie in de resultaten.
De proxy-cmdlet wijst deze parameter toe aan de parameter Prerelease van Find-PSResource.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-AllVersions
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Filter
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-MaximumVersion
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-MinimumVersion
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-ModuleName
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Name
Hiermee geeft u de opdrachtnaam te zoeken in een opslagplaats. Gebruik komma's om een matrix met opdrachtnamen te scheiden.
De proxy-cmdlet wijst deze parameter toe aan de parameter CommandName van Find-PSResource.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | 0 |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Proxy
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
Parametereigenschappen
| Type: | Uri |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-ProxyCredential
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
Parametereigenschappen
| Type: | PSCredential |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | 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.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-RequiredVersion
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Tag
De proxy-cmdlet negeert deze parameter omdat deze niet wordt ondersteund door de CommandNameParameterSet van Find-PSResource.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
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
