Find-Command
Recherche les commandes PowerShell dans les modules.
Syntaxe
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
L’applet de commande Find-Command recherche des commandes PowerShell telles que des applets de commande, des alias, des fonctions et des flux de travail.
Find-Command recherche des modules dans des référentiels inscrits.
Il s’agit d’une applet de commande proxy pour l’applet Find-PSResource de commande dans Microsoft.PowerShell.PSResourceGet. Pour plus d’informations, consultez Find-PSResource.
Exemples
Exemple 1 : Rechercher une commande par nom
Find-Command pouvez utiliser le nom d’une commande pour localiser le module dans un référentiel. Il est possible qu’un nom de commande existe dans plusieurs 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
Get-TargetResource.
Exemple 2 : Rechercher des commandes par nom et installer le module
Find-Command pouvez localiser la commande et le module, puis envoyer l’objet à Install-Module. Si une commande est incluse dans plusieurs modules, utilisez le paramètre Find-Command des applets de commande.
Sinon, les modules peuvent être installés que vous ne souhaitez pas installer.
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 utilise le paramètre Name pour spécifier la commande Get-TargetResource. Le paramètre Install-Module et le module est installé. Une fois l’installation terminée, vous pouvez utiliser Get-InstalledModule pour afficher les résultats.
Exemple 3 : Rechercher une commande et enregistrer son module
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 utilise les paramètres Name et Repository pour rechercher la commande Invoke-ScriptAnalyzer dans le référentiel PSGallery . L’objet est envoyé dans le pipeline à Save-Module. Le paramètre Path détermine l’emplacement d’enregistrement du module.
verbose est un paramètre facultatif, mais affiche la sortie d’état dans la console PowerShell. La sortie détaillée est bénéfique pour la résolution des problèmes.
Paramètres
-AllowPrerelease
Inclut les modules marqués comme une préversion dans les résultats.
L’applet de commande proxy mappe ce paramètre au paramètre Prerelease de Find-PSResource.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-AllVersions
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par CommandNameParameterSet de Find-PSResource.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Filter
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par CommandNameParameterSet de Find-PSResource.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MaximumVersion
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par CommandNameParameterSet de Find-PSResource.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-MinimumVersion
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par CommandNameParameterSet de Find-PSResource.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ModuleName
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par CommandNameParameterSet de Find-PSResource.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom de la commande à rechercher dans un référentiel. Utilisez des virgules pour séparer un tableau de noms de commandes.
L’applet de commande proxy mappe ce paramètre au paramètre CommandName de Find-PSResource.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 0 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Proxy
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par CommandNameParameterSet de Find-PSResource.
Propriétés du paramètre
| Type: | Uri |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-ProxyCredential
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par CommandNameParameterSet de Find-PSResource.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Repository
Spécifie le référentiel à rechercher des commandes. Utilisez des virgules pour séparer un tableau de noms de référentiels. La valeur par défaut est tous les référentiels.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-RequiredVersion
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par CommandNameParameterSet de Find-PSResource.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Tag
L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par CommandNameParameterSet de Find-PSResource.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.
Sorties
PSGetCommandInfo
Find-Command génère un objet PSGetCommandInfo.
Notes
PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Vous devez utiliser TLS 1.2 ou version ultérieure. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
