Sdílet prostřednictvím

Get-DscResource

  • Reference
Modul:
PSDesiredStateConfiguration

Získá prostředky DSC (Desired State Configuration) přítomné v počítači.

Syntaxe

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.

Typ:Object
Position:1
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje pole názvů prostředku DSC, který se má zobrazit.

Typ:String[]
Position:0
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky: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.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

String[]

Výstupy

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]