Partager via

Find-Script

  • Référence
Module:
PowerShellGet

Recherche un script.

Syntax

Find-Script
    [[-Name] <String[]>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-RequiredVersion <String>]
    [-AllVersions]
    [-IncludeDependencies]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-Command <String[]>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AllowPrerelease]
    [<CommonParameters>]

Description

L’applet Find-Script de commande recherche un script spécifié dans les dépôts inscrits.

Exemples

Exemple 1 : Rechercher tous les scripts disponibles

Find-Script

Cette commande recherche tous les scripts disponibles.

Exemple 2 : Rechercher un script par nom

Find-Script -Name "Start-WFContosoServer"

Cette commande recherche le script nommé Start-WFContosoServer.

Exemple 3 : Rechercher un script par nom, version requise et à partir d’un dépôt spécifié

Find-Script -Name "Required-Script2" -RequiredVersion 2.0 -Repository "LocalRepo01"

Cette commande recherche un script par nom et par version requise dans le référentiel LocalRepo01.

Exemple 4 : Rechercher un script et mettre en forme la sortie sous forme de liste

Find-Script -Name "Required-Script2" -RequiredVersion 2.0 -Repository "LocalRepo1" | Format-List * -Force

Cette commande recherche Required-Script2 dans le référentiel LocalRepo1, puis transmet l’objet PSRepositoryItemInfo résultant à l’applet de Format-List commande.

Exemple 5 : Rechercher un script dans la plage de versions spécifiée

Find-Script -Name "Required-Script2" -MinimumVersion 2.1 -MaximumVersion 2.5 -Repository "LocalRepo1"
Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script

Cette commande recherche toutes les versions de RequiredScript2 comprises entre les versions 2.1 et 2.5 dans le respository LocalRepo1.

Exemple 6 : Rechercher toutes les versions d’un script

Find-Script -Name "Required-Script02" -AllVersions

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
1.0        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script
1.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script
2.0        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script
2.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script

Cette commande recherche toutes les versions de Required-Script02.

Exemple 7 : Rechercher un script et ses dépendances

Find-Script -Name "Script-WithDependencies1" -IncludeDependencies -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
1.0        Script-WithDependencies1            Script     LocalRepo1           Description for the Script-WithDependencies1 script
2.0        RequiredModule3                     Script     LocalRepo1           RequiredModule3 module
2.5        Required-Script1                    Script     LocalRepo1           Description for the Required-Script1 script
2.5        Required-Script2                    Script     LocalRepo1           Description for the Required-Script2 script

Cette commande recherche un script et ses dépendances.

Exemple 8 : Rechercher des scripts avec la balise spécifiée

Find-Script -Tag "Tag1" -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
1.0        Fabrikam-ClientScript               Script     LocalRepo1           Description for the Fabrikam-ClientScript script

Cette commande recherche les scripts qui ont la balise Tag1 dans le référentiel LocalRepo1

Exemple 9 : Rechercher des scripts avec le nom de commande spécifié

Find-Script -Command Test-FunctionFromScript_Required-Script3 -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Required-Script3                    Script     LocalRepo1           Description for the Required-Script3 script

Cette commande recherche un script qui contient le nom de commande spécifié.

Exemple 10 : Rechercher des scripts avec des workflows

Find-Script -Includes "Workflow" -Repository "LocalRepo1"

Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Fabrikam-ClientScript               Script     LocalRepo1           Description for the Fabrikam-ClientScript script
1.0        Fabrikam-Script                     Script     LocalRepo1           Description for the Fabrikam-Script script

Cette commande recherche les scripts de flux de travail dans le référentiel LocalRepo1.

Exemple 11 : Rechercher des scripts à l’aide de caractères génériques

Find-Script -Name "Required-Script*" -Repository "LocalRepo1"
Version    Name                                Type       Repository           Description
-------    ----                                ----       ----------           -----------
2.5        Required-Script1                    Script     local1               Description for the Required-Script1 script
2.5        Required-Script2                    Script     local1               Description for the Required-Script2 script
2.5        Required-Script3                    Script     local1               Description for the Required-Script3 script

Cette commande utilise le caractère générique (*) pour rechercher les scripts qui commencent par Obligatoire-Script.

Paramètres

-AllowPrerelease

Inclut dans les scripts de résultats marqués en tant que préversion.

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

-AllVersions

Indique que cette opération recherche toutes les versions de script.

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

-Command

Spécifie un tableau de commandes à rechercher dans les scripts. Une commande peut être une fonction ou un workflow.

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

-Credential

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

-Filter

Recherche les scripts en fonction de la syntaxe de recherche propre au fournisseur PackageManagement .

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

-IncludeDependencies

Indique que cette opération obtient tous les scripts qui dépendent du script spécifié dans le paramètre Name .

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

-Includes

Spécifie le type de script à obtenir. Les valeurs valides pour ce paramètre sont :

  • Function
  • Workflow
Type:String[]
Accepted values:Function, Workflow
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

Spécifie la version maximale ou la plus récente du script à rechercher. Les paramètres MaximumVersion et RequiredVersion s’excluent mutuellement ; Vous ne pouvez pas utiliser les deux paramètres dans la même commande.

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

-MinimumVersion

Spécifie la version minimale du script à rechercher. Les paramètres MinimumVersion et RequiredVersion s’excluent mutuellement ; Vous ne pouvez pas utiliser les deux paramètres dans la même commande.

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

-Name

Spécifie un tableau de noms de scripts à rechercher.

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

-Proxy

Spécifie un serveur proxy pour la requête, plutôt que de se connecter directement à la ressource Internet.

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

-ProxyCredential

Spécifie un compte d'utilisateur qui a l'autorisation d'utiliser le serveur proxy spécifié par le paramètre Proxy.

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

-Repository

Spécifie le nom convivial d’un dépôt qui a été inscrit en exécutant Register-PSRepository.

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

-RequiredVersion

Spécifie le numéro de version exact du script à rechercher.

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

-Tag

Spécifie un tableau de balises.

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

Entrées

String[]

String

Uri

PSCredential

Sorties

PSRepositoryItemInfo

Notes

Important

Depuis avril 2020, PowerShell Gallery ne prend plus en charge les versions 1.0 et 1.1 de Transport Layer Security (TLS). Si vous n'utilisez pas TLS 1.2 ou une version plus récente, vous recevez une erreur lorsque vous tentez d'accéder à 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 sur le blog PowerShell.