Get-DscResource
Získá prostředky DSC (Desired State Configuration) přítomné v počítači.
Syntax
Default (Výchozí)
Get-DscResource
[[-Name] <String[]>]
[[-Module] <Object>]
[-Syntax]
[<CommonParameters>]
Description
Rutina Get-DscResource načte prostředky PowerShell DSC, které jsou přítomné na počítači. Tato rutina zjistí pouze prostředky nainstalované v psModulePath. Zobrazuje podrobnosti o předdefinovaných a vlastních zprostředkovatelích, které uživatel vytvořil. Tato rutina také zobrazuje podrobnosti o složených prostředcích, což jsou další konfigurace zabalené jako modul nebo vytvořené za běhu v relaci.
Příklady
Příklad 1: Získání všech prostředků na místním počítači
Get-DscResource
Tento příkaz získá všechny prostředky na místním počítači.
Příklad 2: Získání prostředku zadáním názvu
Get-DscResource -Name "WindowsFeature"
Tento příkaz získá prostředek WindowsFeature.
Příklad 3: Získání všech prostředků z modulu
Get-DscResource -Module "xHyper-V"
Tento příkaz získá všechny prostředky z modulu xHyper-V.
Příklad 4: Získání prostředku pomocí zástupných znaků
Get-DscResource -Name P*,r*
Tento příkaz získá všechny prostředky, které odpovídají vzoru se zástupným znakem zadaným parametrem Name.
Příklad 5: Získání syntaxe prostředku
Get-DscResource -Name "WindowsFeature" -Syntax
Tento příkaz získá prostředek WindowsFeature a zobrazí syntaxi prostředku.
Příklad 6: Získání všech vlastností prostředku
Get-DscResource -Name "User" | Select-Object -ExpandProperty Properties
Tento příkaz získá prostředek Uživatele a potom pomocí operátoru kanálu vrátí všechny vlastnosti prostředku uživatele.
Příklad 7: Získání všech prostředků ze zadaného modulu se zadanou verzí
Get-DscResource -Module @{ModuleName='xHyper-V';RequiredVersion='3.0.0.0'}
Tento příkaz získá všechny prostředky z modulu xHyper-V s verzí 3.0.0.0.
Parametry
-Module
Určuje název nebo plně kvalifikovaný název modulu, pro který se má zobrazit prostředek DSC.
Vlastnosti parametru
| Typ: | Object |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje pole názvů prostředku DSC, který se má zobrazit.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | True |
| Hodnota z kanálu podle názvu vlastnosti: | True |
| Hodnota ze zbývajících argumentů: | False |
-Syntax
Označuje, že rutina vrátí zobrazení syntaxe zadaných prostředků DSC. Vrácená syntaxe ukazuje, jak používat prostředky ve skriptu PowerShellu.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
