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 cmdlet 搜索已注册的存储库以查找模块中包含的 DSC 资源。默认情况下，Find-DscResource 搜索所有已注册的存储库。

对于 Find-DscResource找到的每个模块，将返回 PSGetDscResourceInfo 对象。 PSGetDscResourceInfo 对象可将管道向下发送到 Install-Module cmdlet。 Install-Module 安装模块。

示例

示例 1：查找所有 DSC 资源

Find-DscResource 从已注册的存储库返回 DSC 资源。若要搜索特定存储库，请使用 存储库 参数。

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 尝试仅安装模块一次。

Find-DscResource -Name xWebsite | Install-Module

使用 Name 参数查找名为 xWebsite的资源。该对象将管道向下发送到 Install-Module cmdlet。 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 参数通过域指定结果。 Filter 参数在对象的说明或模块名称中查找筛选器值。使用 Select-Object cmdlet 查看对象的属性。

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
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Filter

根据 PackageManagement 提供程序的搜索语法查找资源。例如，指定要在 ModuleName 中搜索的字词，Description 属性。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-MinimumVersion

指定要包含在结果中的资源的最低版本。 MinimumVersion 和 RequiredVersion 参数不能在同一命令中使用。

类型:	Version
别名:	Version
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ModuleName

指定包含 DSC 资源的模块。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Name

指定资源的名称。默认值为所有资源。使用逗号分隔资源名称数组。

类型:	String[]
Position:	0
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Repository

指定要搜索资源的存储库。使用逗号分隔存储库名称数组。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequiredVersion

指定要包含在结果中的模块的确切版本号。 RequiredVersion 和 MinimumVersion 参数不能在同一命令中使用。

类型:	Version
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Tag

指定对存储库中的模块进行分类的标记。使用逗号分隔标记数组。

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

PSGetDscResourceInfo

Find-DscResource 返回 PSGetDscResourceInfo 对象。

通过