Partager via

Find-Command

Module:
PowerShellGet Module

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.

Pour chaque commande trouvée par Find-Command, un objet PSGetCommandInfo est retourné. L’objet PSGetCommandInfo peut être envoyé au pipeline à l’applet de commande Install-Module. Install-Module installe le module qui contient la commande.

Exemples

Exemple 1 : Rechercher toutes les commandes dans un référentiel spécifié

L’applet de commande Find-Command recherche un référentiel inscrit pour les 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

utilise le paramètre de référentiel pour spécifier le nom d’un référentiel inscrit. Les objets sont envoyés vers le bas du pipeline. Select-Object reçoit les objets et utilise le paramètre First pour afficher les 10 premiers résultats.

Exemple 2 : 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

utilise le paramètre du référentiel de pour rechercher lePSGallery . Le paramètre Name spécifie la commande Get-TargetResource.

Exemple 3 : 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.

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 utilise le paramètre Name pour spécifier la commande Get-TargetResource. Le paramètre Repository recherche lePSGallery . Le paramètre ModuleName spécifie le module que vous souhaitez installer, SystemLocaleDsc. L’objet est envoyé vers le bas du pipeline pour Install-Module et le module est installé. Une fois l’installation terminée, vous pouvez utiliser Get-InstalledModule pour afficher les résultats.

Exemple 4 : Rechercher une commande et enregistrer son module

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 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.

Propriétés des paramètres

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

Indique que cette applet de commande obtient toutes les versions d’un module.

Propriétés des paramètres

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

Recherche les modules en fonction de la syntaxe de recherche du fournisseur PackageManagement. Par exemple, spécifiez des mots à rechercher dans les propriétés moduleName et Description.

Propriétés des paramètres

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

Spécifie la version maximale du module à inclure dans les résultats. Les MaximumVersion et les paramètres RequiredVersion ne peuvent pas être utilisés dans la même commande.

Propriétés des paramètres

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

Spécifie la version minimale du module à inclure dans les résultats. Les MinimumVersion et les paramètres RequiredVersion ne peuvent pas être utilisés dans la même commande.

Propriétés des paramètres

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

Spécifie le nom d’un module à rechercher des commandes. La valeur par défaut est tous les modules.

Propriétés des paramètres

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.

Propriétés des paramètres

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

Spécifie un serveur proxy pour la requête, plutôt qu’une connexion directe à la ressource Internet.

Propriétés des paramètres

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

Spécifie un compte d’utilisateur autorisé à utiliser le serveur proxy spécifié par le paramètre Proxy .

Propriétés des paramètres

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 des paramètres

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

Spécifie la version du module à inclure dans les résultats.

Propriétés des paramètres

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

Spécifie des balises qui classent les modules dans un référentiel. Utilisez des virgules pour séparer un tableau de balises.

Propriétés des paramètres

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

Important

Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions TLS (Transport Layer Security) 1.0 et 1.1. Si vous n’utilisez pas TLS 1.2 ou version ultérieure, vous recevez une erreur lors de la tentative d’accès à PowerShell Gallery. Utilisez la commande suivante pour vous assurer que vous utilisez TLS 1.2 :

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Pour plus d’informations, consultez l’annonce dans le blog PowerShell.