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

通过