Get-DscResource

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

语法

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

说明

cmdlet Get-DscResource 检索计算机上存在的 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 的 xHyper-V 模块获取所有资源。

参数

-Module

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

Type:Object
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

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

-Syntax

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

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

输入

String[]

Object

输出

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]