共用方式為

Get-DscResource

  • 參考
模組:
PSDesiredStateConfiguration

取得電腦上存在的DESIRED STATE CONFIGURATION (DSC) 資源。

Syntax

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

Description

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

此命令會取得使用者資源，然後使用管線運算子傳回使用者資源的所有屬性。

範例 7：從具有指定版本的指定模組取得所有資源

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

此命令會從 xHyper-V 模組取得 3.0.0.0 版的所有資源。

參數

-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 資源。