Freigeben über

Get-DscResource

  • Referenz
Modul:
PSDesiredStateConfiguration

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

Syntax

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

Beschreibung

Mit dem Cmdlet Get-DscResource werden die powerShell DSC-Ressourcen abgerufen, die auf dem Computer vorhanden sind. Dieses Cmdlet ermittelt nur die ressourcen, die in PSModulePath installiert sind. Es zeigt die Details zu integrierten und benutzerdefinierten Anbietern, die vom Benutzer erstellt werden. Dieses Cmdlet enthält auch Details zu zusammengesetzten Ressourcen, bei denen es sich um andere Konfigurationen handelt, die als Modul verpackt 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"

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

Beispiel 4: Abrufen einer Ressource mithilfe von Wildcardzeichen

Get-DscResource -Name P*,r*

Dieser Befehl ruft alle Ressourcen ab, die mit dem durch den parameter Name angegebenen Wildcardmuster übereinstimmen.

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 an.

Beispiel 6: Abrufen aller Eigenschaften für eine Ressource

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

Dieser Befehl ruft die Benutzerressource ab und verwendet dann den Pipelineoperator, um alle Eigenschaften für die Benutzerressource 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'}

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

Parameter

-Module

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

Typ:Object
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

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

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren: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.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

String[]

Object

Ausgaben

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]