Find-DscResource
查找 Desired State Configuration （DSC） 资源。
语法
All
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 cmdlet 搜索已注册的存储库以查找模块中包含的 DSC 资源。 默认情况下，Find-DscResource 搜索所有已注册的存储库。
这是 Find-PSResource 中 cmdlet 的代理 cmdlet。 有关详细信息，请参阅 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 尝试仅安装模块一次。
Find-DscResource -Name xWebsite | Install-Module
Install-Module cmdlet。
Install-Module 安装资源的 xWebAdministration 模块。
参数
-AllowPrerelease
在结果中包含标记为预发行版的资源。
代理 cmdlet 将此参数映射到 预发行版 参数 Find-PSResource。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-AllVersions
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Filter
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MaximumVersion
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-MinimumVersion
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ModuleName
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Name
指定资源的名称。 默认值为所有资源。 使用逗号分隔资源名称数组。
代理 cmdlet 将此参数映射到的 Find-PSResource 参数。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Proxy
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
参数属性
| 类型: | Uri |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-ProxyCredential
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
参数属性
| 类型: | PSCredential |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | True |
| 来自剩余参数的值: | False |
-Repository
指定要搜索资源的存储库。 使用逗号分隔存储库名称数组。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-RequiredVersion
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Tag
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输出
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
