Get-DscResource

  • リファレンス
モジュール:
PSDesiredStateConfiguration

コンピューターに存在Desired State Configuration (DSC) リソースを取得します。

構文

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

説明

コマンドレットは Get-DscResource 、コンピューターに存在する PowerShell DSC リソースを取得します。 このコマンドレットは、PSModulePath にインストールされているリソースのみを検出します。 ユーザーによって作成された組み込みプロバイダーとカスタム プロバイダーに関する詳細が表示されます。 このコマンドレットでは、複合リソースの詳細も表示されます。これは、モジュールとしてパッケージ化されるか、セッションで実行時に作成されるその他の構成です。

例

例 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

コマンドレットが、指定した 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[]