Get-DscResource

  • Reference
Modul:
PSDesiredStateConfiguration

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

Syntax

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

Description

Rutina Get-DscResource načte prostředky PowerShell DSC, které jsou v počítači. Tato rutina zjistí pouze prostředky nainstalované v cestě PSModulePath. Zobrazuje podrobnosti o předdefinovaných a vlastních poskytovatelích vytvořených uživatelem. Tato rutina také zobrazuje podrobnosti o složených prostředcích, což jsou další konfigurace, které jsou zabalené jako modul nebo vytvořené za běhu v relaci.

Příklady

Příklad 1: Získání všech prostředků v místním počítači

Get-DscResource

Tento příkaz získá všechny prostředky v 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 zástupných znaků určenému 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í jeho syntaxi.

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 pak 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 verze 3.0.0.0.

Parametry

-Module

Určuje název nebo plně kvalifikovaný název modulu, pro který chcete zobrazit prostředek DSC.

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

-Name

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

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

-Syntax

Označuje, že rutina vrací zobrazení syntaxe zadaných prostředků DSC. Vrácená syntaxe ukazuje, jak používat prostředky ve skriptu PowerShellu.

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

Vstupy

String[]

Object

Výstupy

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]