Find-Script

查找脚本。

语法

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

说明

cmdlet Find-Script 在已注册的存储库中查找指定的脚本。

这是 Microsoft.PowerShell.PSResourceGet 中 cmdlet 的代理 Find-PSResource cmdlet。 有关详细信息,请参阅 Find-PSResource

示例

示例 1:按名称查找脚本

Find-Script -Name "Start-WFContosoServer"

此命令查找名为 的 Start-WFContosoServer脚本。

示例 2:按名称、所需版本和从指定存储库查找脚本

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

此命令在 LocalRepo01 存储库中按名称和所需版本查找脚本。

示例 3:查找指定版本范围内的脚本

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

此命令在 LocalRepo1 存储库中查找版本 2.1 和 2.5 之间的所有 RequiredScript2 版本。

示例 4:查找脚本的所有版本

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

此命令查找 Required-Script02 的所有版本。

示例 5:查找脚本及其依赖项

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

此命令查找脚本及其依赖项。

示例 6:查找具有指定标记的脚本

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

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

此命令在 LocalRepo1 存储库中查找标记 Tag1 的脚本

示例 7:查找具有指定命令名称的脚本

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

此命令查找包含指定命令名称的脚本。

示例 8:使用通配符查找脚本

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

此命令使用通配符 (*) 查找以 Required-Script 开头的脚本。

参数

-AllowPrerelease

在标记为预发行版的结果脚本中包含 。

代理 cmdlet 将此参数映射到 的 Find-PSResourcePrerelease 参数。

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

-AllVersions

指示此操作查找所有脚本版本。

代理 cmdlet 在调用 Find-PSResource之前将-Version *此参数转换为 。

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

-Command

代理 cmdlet 忽略此参数,因为 的 NameParameterSetFind-PSResource不支持此参数。

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

代理 cmdlet 忽略此参数,因为 的 NameParameterSetFind-PSResource不支持此参数。

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

-IncludeDependencies

指示此操作获取依赖于 Name 参数中指定的脚本的所有脚本。

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

-Includes

代理 cmdlet 忽略此参数,因为 的 NameParameterSetFind-PSResource不支持此参数。

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

-MaximumVersion

代理 cmdlet 使用此参数的值来创建 NuGet 版本搜索字符串,以便与 Find-PSResourceVersion 参数一起使用。

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

-MinimumVersion

代理 cmdlet 使用此参数的值来创建 NuGet 版本搜索字符串,以便与 Find-PSResourceVersion 参数一起使用。

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

-Name

指定要查找的脚本名称的数组。

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

-Proxy

代理 cmdlet 忽略此参数,因为 的 NameParameterSetFind-PSResource不支持此参数。

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

-ProxyCredential

代理 cmdlet 忽略此参数,因为 的 NameParameterSetFind-PSResource不支持此参数。

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

-Repository

指定已通过运行 Register-PSRepository注册的存储库的友好名称。

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

-RequiredVersion

代理 cmdlet 使用此参数的值来创建 NuGet 版本搜索字符串,以便与 Find-PSResourceVersion 参数一起使用。

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

-Tag

指定标记的数组。

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

输入

String[]

String

Uri

PSCredential

输出

PSRepositoryItemInfo

备注

PowerShell 库不再支持传输层安全性 (TLS) 版本 1.0 和 1.1。 必须使用 TLS 1.2 或更高版本。 使用以下命令可以确定使用的是 TLS 1.2:

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