次の方法で共有

Find-DscResource

モジュール:
PowershellGet

Desired State Configuration (DSC) リソースを検索します。

構文

Find-DscResource
    [[-Name] <String[]>]
    [-ModuleName <String>]
    [-MinimumVersion <Version>]
    [-RequiredVersion <Version>]
    [-AllVersions]
    [-Tag <String[]>]
    [-Filter <String>]
    [-Repository <String[]>]
    [<CommonParameters>]

説明

Find-DscResource コマンドレットは、登録済みのリポジトリを検索して、モジュールに含まれる DSC リソースを検索します。 既定では、Find-DscResource はすべての登録済みリポジトリを検索します。

Find-DscResourceによって検出されたモジュールごとに、PSGetDscResourceInfo オブジェクトが返されます。 PSGetDscResourceInfo オブジェクト 、パイプラインを コマンドレットに送信できます。 Install-Module モジュールをインストールします。

例

例 1: すべての DSC リソースを検索する

Find-DscResource は、登録済みリポジトリから DSC リソースを返します。 特定のリポジトリを検索するには、Repository パラメーターを使用します。

Find-DscResource

Name                           Version    ModuleName                     Repository
----                           -------    ----------                     ----------
Carbon_Privilege               2.8.1      Carbon                         PSGallery
Carbon_ScheduledTask           2.8.1      Carbon                         PSGallery
Carbon_Service                 2.8.1      Carbon                         PSGallery
PackageManagement              1.4        PackageManagement              PSGallery
PackageManagementSource        1.4        PackageManagement              PSGallery
PSModule                       2.1.4      PowerShellGet                  PSGallery
PSRepository                   2.1.4      PowerShellGet                  PSGallery
xArchive                       8.7.0.0    xPSDesiredStateConfiguration   PSGallery
xDSCWebService                 8.7.0.0    xPSDesiredStateConfiguration   PSGallery
xEnvironment                   8.7.0.0    xPSDesiredStateConfiguration   PSGallery

例 2: 名前で 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 リソースの配列を検索します。

例 3: DSC リソースを見つけてインストールする

Find-DscResource DSC リソースを検索し、インストールするパイプラインの下にオブジェクトを送信します。 インストール後、Get-InstalledModule を使用して結果を表示します。

同じモジュールの複数のリソースをパイプラインから Install-Moduleに送信できます。 Install-Module は、モジュールのインストールを 1 回だけ試行します。

Find-DscResource -Name xWebsite | Install-Module

では、Name パラメーターを使用して、xWebsiteという名前 リソースを検索します。 オブジェクトは、パイプラインから Install-Module コマンドレットに送信されます。 Install-Module は、リソースの xWebAdministration モジュールをインストールします。

例 4: モジュール内のすべての DSC リソースを検索する

Find-DscResource は、指定したモジュールに含まれるすべての DSC リソースを検索します。 既定では、現在のバージョンが表示されます。 他のバージョンを表示するには、AllVersions または requiredVersions パラメーター 使用します。

Find-DscResource -ModuleName xWebAdministration

Name                                Version    ModuleName              Repository
----                                -------    ----------              ----------
WebApplicationHandler               2.6.0.0    xWebAdministration      PSGallery
xIisFeatureDelegation               2.6.0.0    xWebAdministration      PSGallery
xIisHandler                         2.6.0.0    xWebAdministration      PSGallery
xIisLogging                         2.6.0.0    xWebAdministration      PSGallery

Find-DscResource では、ModuleName パラメーターを使用して、xWebAdministration を指定し、モジュールに含まれている DSC リソースを検索します。 各リソースの現在のバージョンが表示されます。

例 5: タグと必要なバージョンで DSC リソースを検索する

DSC リソースは、タグ パラメーターと RequiredVersionを使用して配置できます。 タグ には、リポジトリ内の指定したタグを含むすべてのリソースの現在のバージョンが表示されます。 RequiredVersion には、ModuleName パラメーターが必要であり、Name パラメーターは省略可能です。 Name パラメーターと ModuleName パラメーターによって出力が制限されます。 AllVersions パラメーターを使用して、DSC リソースの使用可能なバージョンを表示します。

Find-DscResource -ModuleName xWebAdministration -Tag DSC -RequiredVersion 1.20

Name                    Version    ModuleName             Repository
----                    -------    ----------             ----------
xIisFeatureDelegation   1.20.0.0   xWebAdministration     PSGallery
xIisHandler             1.20.0.0   xWebAdministration     PSGallery
xIisLogging             1.20.0.0   xWebAdministration     PSGallery
xIisMimeTypeMapping     1.20.0.0   xWebAdministration     PSGallery

例 6: フィルターを使用してリソースを検索する

Find-DscResource は、すべてのリソースを検索し、Filter パラメーターを使用して、Domainで結果を指定します。 Filter パラメーターは、オブジェクトの説明またはモジュール名でフィルター値を検索します。 Select-Object コマンドレットを使用して、オブジェクトのプロパティを表示します。

Find-DscResource -Filter Domain

Name                    Version    ModuleName                 Repository
----                    -------    ----------                 ---------
xComputer               4.1.0.0    xComputerManagement        PSGallery
Computer                6.4.0.0    ComputerManagementDsc      PSGallery
xDSCDomainjoin          1.1        xDSCDomainjoin             PSGallery
xDisk                   1.0        xDisk                      PSGallery
xDSCFirewall            1.6.21     xDSCFirewall               PSGallery
dmAwsTagInstance        1.0.1      domainAwsDSCResources      PSGallery

パラメーター

-AllVersions

AllVersions パラメーターには、DSC リソースの使用可能な各バージョンが表示されます。 AllVersions パラメーターは、MinimumVersion、MaximumVersion、または RequiredVersion パラメーター 使用できません。

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

-Filter

PackageManagement プロバイダーの検索構文に基づいてリソースを検索します。 たとえば、ModuleName 内で検索する単語と Description プロパティを指定します。

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

-MinimumVersion

結果に含めるリソースの最小バージョンを指定します。 MinimumVersion と RequiredVersion パラメーターは、同じコマンドでは使用できません。

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

-ModuleName

DSC リソースを含むモジュールを指定します。

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

-Name

リソースの名前を指定します。 既定値は、すべてのリソースです。 リソース名の配列を区切るには、コンマを使用します。

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

-Repository

リソースを検索するリポジトリを指定します。 リポジトリ名の配列を区切るには、コンマを使用します。

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

-RequiredVersion

結果に含めるモジュールの正確なバージョン番号を指定します。 RequiredVersion パラメーターと MinimumVersion パラメーターは、同じコマンドでは使用できません。

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

-Tag

リポジトリ内のモジュールを分類するタグを指定します。 タグの配列を区切るには、コンマを使用します。

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

出力

PSGetDscResourceInfo

Find-DscResource は、PSGetDscResourceInfo オブジェクトを返します。