Get-DscResource
コンピューターに存在する 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
このコマンドはユーザー リソースを取得し、パイプライン演算子を使用してユーザー リソースのすべてのプロパティを返します。
例 7: 指定したバージョンの指定したモジュールからすべてのリソースを取得する
Get-DscResource -Module @{ModuleName='xHyper-V';RequiredVersion='3.0.0.0'}
このコマンドは、バージョン 3.0.0.0 の xHyper-V モジュールからすべてのリソースを取得します。
パラメーター
-Module
DSC リソースを表示するモジュールの名前または完全修飾名を指定します。
型: | Object |
配置: | 1 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Name
表示する DSC リソースの名前の配列を指定します。
型: | String[] |
配置: | 0 |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Syntax
指定した DSC リソースの構文ビューがコマンドレットから返されることを示します。 返される構文は、PowerShell スクリプトでリソースを使用する方法を示しています。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
String[]
出力
Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]
string[]