Find-Script

模組:

PowerShellGet

尋找腳本。

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

Cmdlet Find-Script 會在已註冊的存放庫中尋找指定的腳本。

這是Microsoft.PowerShell.PSResourceGet中 Cmdlet 的 Proxy Cmdlet Find-PSResource 。 如需詳細資訊，請參閱 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

在標示為發行前版本的結果腳本中包含 。

Proxy Cmdlet 會將此參數對應至 的 Find-PSResource發行前版本參數。

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

-AllVersions

表示此作業會尋找所有腳本版本。

Proxy Cmdlet 會先將此參數 -Version * 轉換成 ，然後再呼叫 Find-PSResource 。

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

-Command

Proxy 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

Proxy 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

Proxy 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

Proxy Cmdlet 會使用此參數的值來建立 NuGet 版本搜尋字串，以搭配 的 Find-PSResourceVersion參數使用。

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

-MinimumVersion

Proxy 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

Proxy Cmdlet 會忽略此參數，因為 的 NameParameterSetFind-PSResource 不支援此參數。

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

-ProxyCredential

Proxy 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

Proxy 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

相關連結

• Install-Script
• Publish-Script
• Save-Script
• Uninstall-Script
• Update-Script