Get-DscResource

  • Referenz
Modul:
PSDesiredStateConfiguration

Ruft Desired State Configuration (DSC)-Ressourcen ab, die auf dem Computer vorhanden sind.

Syntax

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

Beschreibung

Das Get-DscResource Cmdlet ruft die auf dem Computer vorhandenen PowerShell DSC-Ressourcen ab. Dieses Cmdlet ermittelt nur die im PSModulePath installierten Ressourcen. Es werden die Details zu integrierten und benutzerdefinierten Anbietern angezeigt, die vom Benutzer erstellt werden. Dieses Cmdlet zeigt auch Details zu zusammengesetzten Ressourcen an, bei denen es sich um andere Konfigurationen handelt, die als Modul gepackt oder zur Laufzeit in der Sitzung erstellt werden.

Beispiele

Beispiel 1: Abrufen aller Ressourcen auf dem lokalen Computer

Get-DscResource

Dieser Befehl ruft alle Ressourcen auf dem lokalen Computer ab.

Beispiel 2: Abrufen einer Ressource durch Angeben des Namens

Get-DscResource -Name "WindowsFeature"

Dieser Befehl ruft die WindowsFeature-Ressource ab.

Beispiel 3: Abrufen aller Ressourcen aus einem Modul

Get-DscResource -Module "xHyper-V"

Mit diesem Befehl werden alle Ressourcen aus dem xHyper-V-Modul abgerufen.

Beispiel 4: Abrufen einer Ressource mithilfe von Wildcardzeichen

Get-DscResource -Name P*,r*

Mit diesem Befehl werden alle Ressourcen abgerufen, die dem durch den Name-Parameter angegebenen Feldhaltermuster entsprechen.

Beispiel 5: Abrufen einer Ressourcensyntax

Get-DscResource -Name "WindowsFeature" -Syntax

Dieser Befehl ruft die WindowsFeature-Ressource ab und zeigt die Syntax für die Ressource.

Beispiel 6: Abrufen aller Eigenschaften für eine Ressource

Get-DscResource -Name "User" | Select-Object -ExpandProperty Properties

Dieser Befehl ruft die User-Ressource ab und verwendet dann den Pipeline-Operator, um alle Eigenschaften für die User-Ressource zurückzugeben.

Beispiel 7: Abrufen aller Ressourcen aus einem angegebenen Modul mit einer angegebenen Version

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

Dieser Befehl ruft alle Ressourcen aus dem xHyper-V-Modul mit Version 3.0.0.0 ab.

Parameter

-Module

Gibt den Namen oder den vollqualifizierten Namen des Moduls an, für das die DSC-Ressource angezeigt werden soll.

Type:Object
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Gibt ein Array von Namen der anzuzeigenden DSC-Ressource an.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Syntax

Gibt an, dass das Cmdlet die Syntaxansicht der angegebenen DSC-Ressourcen zurückgibt. Die zurückgegebene Syntax zeigt, wie die Ressourcen in einem PowerShell-Skript verwendet werden.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String[]

Object

Ausgaben

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]