Delen via

Get-DscResource

  • Referentie
Module:
PSDesiredStateConfiguration

Hiermee haalt u Desired State Configuration (DSC)-resources op die aanwezig zijn op de computer.

Syntax

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

Description

De Get-DscResource cmdlet haalt de PowerShell DSC-resources op die aanwezig zijn op de computer. Met deze cmdlet worden alleen de resources gedetecteerd die zijn geïnstalleerd in het PSModulePath. Hier ziet u de details over ingebouwde en aangepaste providers, die door de gebruiker worden gemaakt. Deze cmdlet toont ook details over samengestelde resources. Dit zijn andere configuraties die zijn verpakt als module of die tijdens runtime in de sessie worden gemaakt.

Voorbeelden

Voorbeeld 1: Alle resources op de lokale computer ophalen

Get-DscResource

Met deze opdracht haalt u alle resources op de lokale computer op.

Voorbeeld 2: een resource ophalen door de naam op te geven

Get-DscResource -Name "WindowsFeature"

Met deze opdracht haalt u de resource WindowsFeature op.

Voorbeeld 3: alle resources ophalen uit een module

Get-DscResource -Module "xHyper-V"

Met deze opdracht worden alle resources uit de xHyper-V-module opgehaald.

Voorbeeld 4: een resource ophalen met jokertekens

Get-DscResource -Name P*,r*

Met deze opdracht haalt u alle resources op die overeenkomen met het jokertekenpatroon dat is opgegeven door de parameter Name .

Voorbeeld 5: Een resourcesyntaxis ophalen

Get-DscResource -Name "WindowsFeature" -Syntax

Met deze opdracht wordt de resource WindowsFeature ophaalt en wordt de syntaxis voor de resource weergegeven.

Voorbeeld 6: alle eigenschappen voor een resource ophalen

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

Met deze opdracht wordt de resource Gebruiker ophaalt en vervolgens de pijplijnoperator gebruikt om alle eigenschappen voor de resource Gebruiker te retourneren.

Voorbeeld 7: alle resources ophalen uit een opgegeven module met een opgegeven versie

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

Met deze opdracht worden alle resources opgehaald uit de xHyper-V-module met versie 3.0.0.0.

Parameters

-Module

Hiermee geeft u de naam of volledig gekwalificeerde naam van de module waarvoor de DSC-resource te bekijken.

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

-Name

Hiermee geeft u een matrix met namen van de DSC-resource om weer te geven.

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

-Syntax

Geeft aan dat de cmdlet de syntaxisweergave van de opgegeven DSC-resources retourneert. De geretourneerde syntaxis laat zien hoe u de resources in een PowerShell-script gebruikt.

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

Invoerwaarden

String[]

Object

Uitvoerwaarden

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]