Dela via


Get-DscResource

Hämtar Desired State Configuration (DSC)-resurser som finns på datorn.

Syntax

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

Description

Cmdleten Get-DscResource hämtar De PowerShell DSC-resurser som finns på datorn. Den här cmdleten identifierar endast de resurser som är installerade i PSModulePath. Den visar information om inbyggda och anpassade leverantörer, som skapas av användaren. Den här cmdleten visar också information om sammansatta resurser, som är andra konfigurationer som paketeras som modul eller skapas vid körning i sessionen.

Exempel

Exempel 1: Hämta alla resurser på den lokala datorn

Get-DscResource

Det här kommandot hämtar alla resurser på den lokala datorn.

Exempel 2: Hämta en resurs genom att ange namnet

Get-DscResource -Name "WindowsFeature"

Det här kommandot hämtar WindowsFeature-resursen.

Exempel 3: Hämta alla resurser från en modul

Get-DscResource -Module "xHyper-V"

Det här kommandot hämtar alla resurser från xHyper-V-modulen.

Exempel 4: Hämta en resurs med jokertecken

Get-DscResource -Name P*,r*

Det här kommandot hämtar alla resurser som matchar jokerteckenmönstret som anges av parametern Namn .

Exempel 5: Hämta en resurssyntax

Get-DscResource -Name "WindowsFeature" -Syntax

Det här kommandot hämtar WindowsFeature-resursen och visar syntaxen för resursen.

Exempel 6: Hämta alla egenskaper för en resurs

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

Det här kommandot hämtar användarresursen och använder sedan pipelineoperatorn för att returnera alla egenskaper för användarresursen.

Exempel 7: Hämta alla resurser från en angiven modul med en angiven version

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

Det här kommandot hämtar alla resurser från xHyper-V-modulen med version 3.0.0.0.

Parametrar

-Module

Anger namnet eller det fullständigt kvalificerade namnet på modulen som DSC-resursen ska visas för.

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

-Name

Anger en matris med namn på DSC-resursen som ska visas.

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

-Syntax

Anger att cmdleten returnerar syntaxvyn för de angivna DSC-resurserna. Den returnerade syntaxen visar hur du använder resurserna i ett PowerShell-skript.

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

Indata

String[]

Object

Utdata

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]