Get-DscResource

获取计算机上存在的 Desired State Configuration (DSC) 资源。

语法

Default (默认值)

Get-DscResource
    [[-Name] <String[]>]
    [[-Module] <Object>]
    [-Syntax]
    [<CommonParameters>]

说明

Get-DscResource cmdlet 检索计算机上存在的 PowerShell DSC 资源。 此 cmdlet 仅发现 PSModulePath 中安装的资源。 它显示有关由用户创建的内置提供程序和自定义提供程序的详细信息。 此 cmdlet 还显示有关复合资源的详细信息,这些配置是打包为模块或在会话中的运行时创建的其他配置。

示例

示例 1:获取本地计算机上的所有资源

Get-DscResource

此命令获取本地计算机上的所有资源。

示例 2:通过指定名称获取资源

Get-DscResource -Name "WindowsFeature"

此命令获取 WindowsFeature 资源。

示例 3:从模块获取所有资源

Get-DscResource -Module "xHyper-V"

此命令从 xHyper-V 模块获取所有资源。

示例 4:使用通配符获取资源

Get-DscResource -Name P*,r*

此命令获取与 Name 参数指定的通配符模式匹配的所有资源。

示例 5:获取资源语法

Get-DscResource -Name "WindowsFeature" -Syntax

此命令获取 WindowsFeature 资源,并显示资源的语法。

示例 6:获取资源的所有属性

Get-DscResource -Name "User" | Select-Object -ExpandProperty Properties

此命令获取 User 资源,然后使用管道运算符返回 User 资源的所有属性。

示例 7:从具有指定版本的指定模块获取所有资源

Get-DscResource -Module @{ModuleName='xHyper-V';RequiredVersion='3.0.0.0'}

此命令从版本 3.0.0.0.0 的 xHyper-V 模块获取所有资源。

参数

-Module

指定要为其查看 DSC 资源的模块的名称或完全限定名称。

参数属性

类型:Object
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Name

指定要查看的 DSC 资源的名称数组。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:0
必需:False
来自管道的值:True
来自管道的值(按属性名称):True
来自剩余参数的值:False

-Syntax

指示 cmdlet 返回指定 DSC 资源的语法视图。 返回的语法演示如何在 PowerShell 脚本中使用资源。

参数属性

类型:SwitchParameter
默认值: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

输入

String

Object

输出

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo

String