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
以下のコマンドは、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[]
出力
Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]
string[]