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 PSGalleryFind-DscResource は Name パラメーターを使用して、指定された DSC リソースの配列を検索します。
例 2: DSC リソースを見つけてインストールする
Find-DscResource は DSC リソースを検索し、インストールするパイプラインの下にオブジェクトを送信します。
インストール後、 を使用 Get-InstalledModule して結果を表示します。
同じモジュールの複数のリソースをパイプラインから に Install-Module送信できます。
Install-Module では、モジュールのインストールが 1 回だけ試行されます。
Find-DscResource -Name xWebsite | Install-ModuleFind-DscResourceは Name パラメーターを使用して、xWebsite という名前のリソースを検索します。 オブジェクトは、パイプラインから コマンドレットに Install-Module 送信されます。 Install-Module は、リソースの xWebAdministration モジュールをインストールします。
パラメーター
-AllowPrerelease
結果にプレリリースとしてマークされたリソースが含まれます。
プロキシ コマンドレットは、このパラメーターを の Prerelease パラメーターにマップします Find-PSResource。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
プロキシ コマンドレットは、 の DscResourceNameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
プロキシ コマンドレットは、 の DscResourceNameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
プロキシ コマンドレットは、 の DscResourceNameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
プロキシ コマンドレットは、 の DscResourceNameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
プロキシ コマンドレットは、 の DscResourceNameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
リソースの名前を指定します。 既定値はすべてのリソースです。 リソース名の配列を区切るには、コンマを使用します。
プロキシ コマンドレットは、このパラメーターを の DscResourceName パラメーターにマップします Find-PSResource。
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
プロキシ コマンドレットは、 の DscResourceNameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
プロキシ コマンドレットは、 の DscResourceNameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
リソースを検索するリポジトリを指定します。 リポジトリ名の配列を区切るには、コンマを使用します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
プロキシ コマンドレットは、 の DscResourceNameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
プロキシ コマンドレットは、 の DscResourceNameParameterSetFind-PSResourceでサポートされていないため、このパラメーターを無視します。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
関連リンク
PSResourceGet