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

説明

コマンドレットは Find-Script 、登録済みリポジトリで指定されたスクリプトを検索します。

これは、Microsoft.PowerShell.PSResourceGet のコマンドレットの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

このコマンドは、タグ Tag1 を持つスクリプトを LocalRepo1 リポジトリで検索します

例 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

プレリリースとしてマークされた結果スクリプトにが含まれます。

プロキシ コマンドレットは、このパラメーターを の Prerelease パラメーターにマップします Find-PSResource

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

-AllVersions

この操作によってすべてのスクリプト バージョンが検索されることを示します。

プロキシ コマンドレットは、 を呼び出すFind-PSResource前に、このパラメーターを に-Version *変換します。

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

-Command

プロキシ コマンドレットは、 の 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

プロキシ コマンドレットは、 の 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

プロキシ コマンドレットは、 の NameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。

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

-MaximumVersion

プロキシ コマンドレットは、このパラメーターの値を使用して、 の Version パラメーターで使用する NuGet バージョン検索文字列を作成します Find-PSResource

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

-MinimumVersion

プロキシ コマンドレットは、このパラメーターの値を使用して、 の Version パラメーターで使用する NuGet バージョン検索文字列を作成します Find-PSResource

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

プロキシ コマンドレットは、 の NameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。

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

-ProxyCredential

プロキシ コマンドレットは、 の 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

プロキシ コマンドレットは、このパラメーターの値を使用して、 の Version パラメーターで使用する NuGet バージョン検索文字列を作成します Find-PSResource

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