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 cmdlet 搜索已注册的存储库以查找模块中包含的 DSC 资源。 默认情况下 Find-DscResource ，搜索所有已注册的存储库。
这是 Microsoft.PowerShell.PSResourceGet 中 cmdlet 的代理 cmdletFind-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 PSGallery
Find-DscResource 使用 Name 参数查找指定的 DSC 资源数组。
示例 2：查找 DSC 资源并安装它
Find-DscResource 找到 DSC 资源，并将对象发送到要安装的管道。
安装后，用于 Get-InstalledModule 查看结果。
可以将同一模块中的多个资源发送到管道 Install-Module。
Install-Module 尝试仅安装模块一次。
Find-DscResource -Name xWebsite | Install-Module
Find-DscResource 使用 Name 参数查找名为 xWebsite 的资源。 该对象将管道向下发送到 Install-Module cmdlet。
Install-Module 安装资源的 xWebAdministration 模块。
参数
-AllowPrerelease
在结果中包含标记为预发行版的资源。
代理 cmdlet 将此参数映射到 预发行版 参数 Find-PSResource。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-AllVersions
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
| 类型: | SwitchParameter |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Filter
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-MaximumVersion
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-MinimumVersion
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-ModuleName
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Name
指定资源的名称。 默认值为所有资源。 使用逗号分隔资源名称数组。
代理 cmdlet 将此参数映射到的 Find-PSResourceDscResourceName 参数。
| 类型: | String[] |
| Position: | 0 |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Proxy
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
| 类型: | Uri |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-ProxyCredential
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
| 类型: | PSCredential |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | True |
| 接受通配符: | False |
-Repository
指定要搜索资源的存储库。 使用逗号分隔存储库名称数组。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-RequiredVersion
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
| 类型: | String |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | False |
-Tag
代理 cmdlet 忽略此参数，因为 DscResourceNameParameterSet 不支持 Find-PSResource此参数。
| 类型: | String[] |
| Position: | Named |
| 默认值: | None |
| 必需: | False |
| 接受管道输入: | False |
| 接受通配符: | 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
