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 會在已註冊的存放庫中尋找指定的腳本。

範例

範例 1：尋找所有可用的腳本

Find-Script

此命令會尋找所有可用的腳本。

範例 2：依名稱尋找腳本

Find-Script -Name "Start-WFContosoServer"

此命令會尋找名為 Start-WFContosoServer 的腳本。

範例 3：依名稱、必要版本以及從指定的存放庫尋找腳本

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

此命令會在 LocalRepo01 存放庫中依名稱和必要版本尋找腳本。

範例 4：尋找腳本並將輸出格式化為清單

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

此命令會在 LocalRepo1 存放庫中尋找Required-Script2，然後將產生的 PSRepositoryItemInfo 物件傳遞至 Format-List Cmdlet。

範例 5：在指定的版本範圍中尋找腳本

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 所有版本。

範例 6：尋找腳本的所有版本

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 的所有版本。

範例 7：尋找腳本及其相依性

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

此命令會尋找腳本及其相依性。

範例 8：尋找具有指定標籤的腳本

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 標籤的腳本

範例 9：尋找具有指定命令名稱的腳本

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

此命令會尋找包含指定命令名稱的腳本。

範例 10：使用工作流程尋找腳本

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

此命令會在 LocalRepo1 存放庫中尋找工作流程腳本。

範例 11：使用萬用字元尋找腳本

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

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

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

-AllVersions

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

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

-Command

指定要在腳本中尋找的命令陣列。命令可以是函式或工作流程。

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

根據 PackageManagement 提供者特定的搜尋語法尋找腳本。

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

指定要取得的腳本類型。此參數可接受的值為：

Function
Workflow

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

-MaximumVersion

指定要尋找之腳本的最大值或最新版本。 MaximumVersion 和 RequiredVersion 參數是互斥的；您無法在相同的命令中使用這兩個參數。

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

-MinimumVersion

指定要尋找的腳本最低版本。 MinimumVersion 和 RequiredVersion 參數是互斥的；您無法在相同的命令中使用這兩個參數。

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 伺服器，而不是直接連線到網際網路資源。

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

-ProxyCredential

指定具有使用 Proxy 參數所指定 Proxy 伺服器之權限的使用者帳戶。

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

指定要尋找的腳本確切版本號碼。

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

備註

重要

從 2020 年 4 月起，PowerShell 資源庫已不再支援傳輸層安全性 (TLS) 1.0 和 1.1 版。如果您不是使用 TLS 1.2 或更高版本，您在嘗試存取 PowerShell 資源庫時將會收到錯誤。使用下列命令來確保您使用的是 TLS 1.2：

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

如需詳細資訊，請參閱 PowerShell 部落格中的公告 \(英文\)。

共用方式為

Find-Script

Syntax

Description

範例

範例 1：尋找所有可用的腳本

範例 2：依名稱尋找腳本

範例 3：依名稱、必要版本以及從指定的存放庫尋找腳本

範例 4：尋找腳本並將輸出格式化為清單

範例 5：在指定的版本範圍中尋找腳本

範例 6：尋找腳本的所有版本

範例 7：尋找腳本及其相依性

範例 8：尋找具有指定標籤的腳本

範例 9：尋找具有指定命令名稱的腳本

範例 10：使用工作流程尋找腳本

範例 11：使用萬用字元尋找腳本

參數

-AllowPrerelease

-AllVersions

-Command

-Credential

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

輸入

輸出

備註

意見反應

其他資源

共用方式為

Find-Script

Syntax

Description

範例

範例 1：尋找所有可用的腳本

範例 2：依名稱尋找腳本

範例 3：依名稱、必要版本以及從指定的存放庫尋找腳本

範例 4：尋找腳本並將輸出格式化為清單

範例 5：在指定的版本範圍中尋找腳本

範例 6：尋找腳本的所有版本

範例 7：尋找腳本及其相依性

範例 8：尋找具有指定標籤的腳本

範例 9：尋找具有指定命令名稱的腳本

範例 10：使用工作流程尋找腳本

範例 11：使用萬用字元尋找腳本

參數

-AllowPrerelease

-AllVersions

-Command

-Credential

-Filter

-IncludeDependencies

-Includes

-MaximumVersion

-MinimumVersion

-Name

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Tag

輸入

輸出

備註

相關連結

意見反應

其他資源