Get-DscResource
Hämtar DSC-resurser (Desired State Configuration) som finns på datorn.
Syntax
Default (Standard)
Get-DscResource
[[-Name] <String[]>]
[[-Module] <Object>]
[-Syntax]
[<CommonParameters>]
Description
Cmdleten Get-DscResource hämtar PowerShell DSC-resurserna 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 Name.
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 för vilken DSC-resursen ska visas.
Parameteregenskaper
| Typ: | Object |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 1 |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | False |
-Name
Anger en matris med namn på den DSC-resurs som ska visas.
Parameteregenskaper
| Typ: | String[] |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | 0 |
| Obligatorisk: | False |
| Värde från pipeline: | True |
| Värde från pipeline efter egenskapsnamn: | True |
| Värde från återstående argument: | 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.
Parameteregenskaper
| Typ: | SwitchParameter |
| Standardvärde: | None |
| Stöder jokertecken: | False |
| DontShow: | False |
Parameteruppsättningar
(All)
| Position: | Named |
| Obligatorisk: | False |
| Värde från pipeline: | False |
| Värde från pipeline efter egenskapsnamn: | False |
| Värde från återstående argument: | False |
CommonParameters
Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.
