Find-DscResource
Desired State Configuration (DSC) リソースを検索します。
構文
Find-DscResource
[[-Name] <String[]>]
[-ModuleName <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-AllVersions]
[-AllowPrerelease]
[-Tag <String[]>]
[-Filter <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Repository <String[]>]
[<CommonParameters>] 説明
Find-DscResource コマンドレットは、登録済みのリポジトリを検索して、モジュールに含まれる DSC リソースを検索します。 既定では、 Find-DscResource はすべての登録済みリポジトリを検索します。
これは、Microsoft.PowerShell.PSResourceGet のFind-PSResource コマンドレットのプロキシ コマンドレットです。 詳細については、「 Find-PSResource」を参照してください。
例
例 1: 名前で DSC リソースを検索する
Find-DscResource は DSC リソースを名前で検索します。 リソース名の配列を区切るには、コンマを使用します。
Find-DscResource -Name xWebsite, xWebApplication, xWebSiteDefaults
Name Version ModuleName Repository
---- ------- ---------- ----------
xWebApplication 2.6.0.0 xWebAdministration PSGallery
xWebsite 2.6.0.0 xWebAdministration PSGallery
xWebSiteDefaults 2.6.0.0 xWebAdministration PSGallery
Find-DscResource は 、Name パラメーターを使用して、DSC リソースの指定された配列を検索します。
例 2: DSC リソースを検索してインストールする
Find-DscResource は DSC リソースを検索し、インストールするパイプラインの下にオブジェクトを送信します。
インストール後、 Get-InstalledModule を使用して結果を表示します。
同じモジュールの複数のリソースをパイプラインから Install-Moduleに送信できます。
Install-Module では、モジュールのインストールが 1 回だけ試行されます。
Find-DscResource -Name xWebsite | Install-Module
Find-DscResource は、 Name パラメーターを使用して xWebsite という名前のリソースを検索します。 オブジェクトは、パイプラインから Install-Module コマンドレットに送信されます。
Install-Module は、リソースの xWebAdministration モジュールをインストールします。
パラメーター
-AllowPrerelease
結果にプレリリースとしてマークされたリソースが含まれます。
プロキシ コマンドレットは、このパラメーターを Find-PSResource のプレリリース パラメーターにマップします。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AllVersions
プロキシ コマンドレットは、Find-PSResourceの DscResourceNameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Filter
プロキシ コマンドレットは、Find-PSResourceの DscResourceNameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MaximumVersion
プロキシ コマンドレットは、Find-PSResourceの DscResourceNameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MinimumVersion
プロキシ コマンドレットは、Find-PSResourceの DscResourceNameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ModuleName
プロキシ コマンドレットは、Find-PSResourceの DscResourceNameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
リソースの名前を指定します。 既定値は、すべてのリソースです。 リソース名の配列を区切るには、コンマを使用します。
プロキシ コマンドレットは、このパラメーターを Find-PSResource の DscResourceName パラメーターにマップします。
| 型: | String[] |
| 配置: | 0 |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Proxy
プロキシ コマンドレットは、Find-PSResourceの DscResourceNameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | Uri |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ProxyCredential
プロキシ コマンドレットは、Find-PSResourceの DscResourceNameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | PSCredential |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Repository
リソースを検索するリポジトリを指定します。 リポジトリ名の配列を区切るには、コンマを使用します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RequiredVersion
プロキシ コマンドレットは、Find-PSResourceの DscResourceNameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Tag
プロキシ コマンドレットは、Find-PSResourceの DscResourceNameParameterSet でサポートされていないため、このパラメーターを無視します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
出力
PSGetDscResourceInfo
Find-DscResource
は PSGetDscResourceInfo オブジェクトを返します。
メモ
PowerShell ギャラリーでは、トランスポート層セキュリティ (TLS) バージョン 1.0 と 1.1 はサポートされなくなりました。 TLS 1.2 以降を使用する必要があります。 TLS 1.2 を使用していることを確認するには、次のコマンドを使用します。
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
