Find-DscResource

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 はすべての登録済みリポジトリを検索します。

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

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

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 リソースの配列を検索します。

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

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

Find-DscResource -Name xWebsite | Install-Module

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

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 リソースを検索します。 各リソースの現在のバージョンが表示されます。

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

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

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

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