Freigeben über

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 PowerShell DSC-Ressourcen ab, die auf dem Computer vorhanden sind. 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 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 Angabe 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*

Dieser Befehl ruft alle Ressourcen ab, die dem durch den Name-Parameter angegebenen Wildcardmuster 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'}

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.

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:True

-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[]

Hinweise

  • Get-DscResource findet klassenbasierte DSC-Ressourcen in PowerShell-Versionen unter 7.0 nicht.