次の方法で共有

Find-Script

  • リファレンス
モジュール:
PowerShellGet

スクリプトを検索します。

構文

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 respository のバージョン 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

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

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-AllVersions

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

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Command

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

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Filter

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-IncludeDependencies

この操作は 、Name パラメーターで指定されたスクリプトに依存するすべてのスクリプトを取得することを示します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Includes

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

型:String[]
指定可能な値:Function, Workflow
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-MaximumVersion

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-MinimumVersion

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

検索するスクリプトの名前の配列を指定します。

型:String[]
配置:0
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:True

-Proxy

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

型:Uri
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ProxyCredential

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

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Repository

Register-PSRepositoryを実行して登録されたリポジトリのフレンドリ名を指定します。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RequiredVersion

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Tag

タグの配列を指定します。

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る: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