Get-DscResource
Ruft die DSC-Ressourcen (Desired State Configuration) auf dem Computer ab.
Syntax
Default (Standardwert)
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.
Parametereigenschaften
| Typ: | Object |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 1 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | False |
-Name
Gibt ein Array von Namen der anzuzeigenden DSC-Ressource an.
Parametereigenschaften
| Typ: | String[] |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | 0 |
| Obligatorisch.: | False |
| Wert aus Pipeline: | True |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | True |
| Wert aus verbleibenden Argumenten: | 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.
Parametereigenschaften
| Typ: | SwitchParameter |
| Standardwert: | None |
| Unterstützt Platzhalter: | False |
| Nicht anzeigen: | False |
Parametersätze
(All)
| Position: | Named |
| Obligatorisch.: | False |
| Wert aus Pipeline: | False |
| Wert aus Pipeline nach dem Eigenschaftsnamen: | False |
| Wert aus verbleibenden Argumenten: | False |
CommonParameters
Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.
