通过

Find-DscResource

  • 参考
模块:
PowerShellGet

查找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>]

说明

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

这是 Microsoft.PowerShell.PSResourceGet 中 cmdlet 的代理 Find-PSResource 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

Find-DscResource 使用 Name 参数查找名为 xWebsite 的资源。 对象在管道中向下发送到 Install-Module cmdlet。 Install-Module 安装资源的 xWebAdministration 模块。

参数

-AllowPrerelease

在结果中包含标记为预发行的资源。

代理 cmdlet 将此参数映射到 的Find-PSResource预发布参数。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllVersions

代理 cmdlet 忽略此参数，因为 的 DscResourceNameParameterSetFind-PSResource不支持此参数。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Filter

代理 cmdlet 忽略此参数，因为 的 DscResourceNameParameterSetFind-PSResource不支持此参数。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaximumVersion

代理 cmdlet 忽略此参数，因为 的 DscResourceNameParameterSetFind-PSResource不支持此参数。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MinimumVersion

代理 cmdlet 忽略此参数，因为 的 DscResourceNameParameterSetFind-PSResource不支持此参数。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ModuleName

代理 cmdlet 忽略此参数，因为 的 DscResourceNameParameterSetFind-PSResource不支持此参数。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

代理 cmdlet 将此参数映射到 的 Find-PSResourceDscResourceName 参数。

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Proxy

代理 cmdlet 忽略此参数，因为 的 DscResourceNameParameterSetFind-PSResource不支持此参数。

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ProxyCredential

代理 cmdlet 忽略此参数，因为 的 DscResourceNameParameterSetFind-PSResource不支持此参数。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Repository

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

代理 cmdlet 忽略此参数，因为 的 DscResourceNameParameterSetFind-PSResource不支持此参数。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tag

代理 cmdlet 忽略此参数，因为 的 DscResourceNameParameterSetFind-PSResource不支持此参数。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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