Get-DscResource
コンピューターに存在する Desired State Configuration (DSC) リソースを取得します。
構文
Default (既定)
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
このコマンドはユーザー リソースを取得し、パイプライン演算子を使用してユーザー リソースのすべてのプロパティを返します。
例 7: 指定したバージョンの指定したモジュールからすべてのリソースを取得する
Get-DscResource -Module @{ModuleName='xHyper-V';RequiredVersion='3.0.0.0'}
このコマンドは、バージョン 3.0.0.0 の xHyper-V モジュールからすべてのリソースを取得します。
パラメーター
-Module
DSC リソースを表示するモジュールの名前または完全修飾名を指定します。
パラメーターのプロパティ
| 型: | Object |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Name
表示する DSC リソースの名前の配列を指定します。
パラメーターのプロパティ
| 型: | String[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Syntax
指定した DSC リソースの構文ビューがコマンドレットから返されることを示します。 返される構文は、PowerShell スクリプトでリソースを使用する方法を示しています。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。
