Find-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
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
此命令會在 LocalRepo 1 存放庫中尋找標記 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[]
輸出
PSRepositoryItemInfo
備註
重要
從 2020 年 4 月起,PowerShell 資源庫已不再支援傳輸層安全性 (TLS) 1.0 和 1.1 版。 如果您不是使用 TLS 1.2 或更高版本,您在嘗試存取 PowerShell 資源庫時將會收到錯誤。 使用下列命令來確保您使用的是 TLS 1.2:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
如需詳細資訊,請參閱 PowerShell 部落格中的公告 \(英文\)。