Get-DscResource

  • 参考
模块:
PSDesiredStateConfiguration

获取计算机上存在的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:True

-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[]

备注

  • Get-DscResource 在低于 7.0 的 PowerShell 版本中找不到基于类的 DSC 资源。