Partager via

Find-Command

  • Référence
Module:
PowerShellGet

Recherche des commandes PowerShell dans des 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

L’applet Find-Command de commande recherche les commandes PowerShell telles que les applets de commande, les alias, les fonctions et les workflows. Find-Command recherche les modules dans les référentiels inscrits.

Il s’agit d’une applet de commande de 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 peut utiliser le nom d’une commande pour localiser le module dans un dépôt. Il est possible qu’un nom de commande existe dans plusieurs ModulesNames.

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 utilise le paramètre Repository pour effectuer une recherche dans PSGallery. Le paramètre Name spécifie la commande Get-TargetResource.

Exemple 2 : Rechercher les commandes par nom et installer le module

Find-Command peut localiser la commande et le module, puis envoyer l’objet à Install-Module. Si une commande est incluse dans plusieurs modules, utilisez le Find-Command paramètre ModuleName des applets de commande. Sinon, des 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 Repository recherche dans PSGallery. Le paramètre ModuleName spécifie le module que vous souhaitez installer, SystemLocaleDsc. L’objet est envoyé vers le bas du pipeline vers 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é vers le bas du pipeline vers Save-Module. Le paramètre Path détermine l’emplacement d’enregistrement du module. Le détail est un paramètre facultatif, mais affiche status sortie dans la console PowerShell. La sortie détaillée est utile pour la résolution des problèmes.

Paramètres

-AllowPrerelease

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par commandNameParameterSet de Find-PSResource.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par commandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par commandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par commandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par commandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom de la commande à rechercher dans un dépôt. 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.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par commandNameParameterSet de Find-PSResource.

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par commandNameParameterSet de Find-PSResource.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Repository

Spécifie le dépôt à rechercher pour les commandes. Utilisez des virgules pour séparer un tableau de noms de référentiels. La valeur par défaut est tous les dépôts.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par commandNameParameterSet de Find-PSResource.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

L’applet de commande proxy ignore ce paramètre, car il n’est pas pris en charge par commandNameParameterSet de Find-PSResource.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Sorties

PSGetCommandInfo

Find-Command génère un objet PSGetCommandInfo .

Notes

Le 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