Udostępnij za pośrednictwem

Get-DscResource

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Pobiera zasoby Desired State Configuration (DSC) obecne na komputerze.

Składnia

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

Opis

Polecenie Get-DscResource cmdlet pobiera zasoby DSC programu PowerShell na komputerze. To polecenie cmdlet odnajduje tylko zasoby zainstalowane w programie PSModulePath. Zawiera szczegółowe informacje o wbudowanych i niestandardowych dostawcach, które są tworzone przez użytkownika. To polecenie cmdlet zawiera również szczegółowe informacje o zasobach złożonych, które są innymi konfiguracjami spakowanym jako moduł lub utworzone w czasie wykonywania w sesji.

Przykłady

Przykład 1. Pobieranie wszystkich zasobów na komputerze lokalnym

Get-DscResource

To polecenie pobiera wszystkie zasoby na komputerze lokalnym.

Przykład 2. Pobieranie zasobu przez określenie nazwy

Get-DscResource -Name "WindowsFeature"

To polecenie pobiera zasób WindowsFeature.

Przykład 3. Pobieranie wszystkich zasobów z modułu

Get-DscResource -Module "xHyper-V"

To polecenie pobiera wszystkie zasoby z modułu xHyper-V.

Przykład 4. Pobieranie zasobu przy użyciu symboli wieloznacznych

Get-DscResource -Name P*,r*

To polecenie pobiera wszystkie zasoby zgodne ze wzorcem z symbolami wieloznacznymi określonymi przez parametr Name .

Przykład 5. Pobieranie składni zasobu

Get-DscResource -Name "WindowsFeature" -Syntax

To polecenie pobiera zasób WindowsFeature i wyświetla składnię zasobu.

Przykład 6. Pobieranie wszystkich właściwości zasobu

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

To polecenie pobiera zasób Użytkownik, a następnie używa operatora potoku, aby zwrócić wszystkie właściwości zasobu Użytkownik.

Przykład 7: Pobieranie wszystkich zasobów z określonego modułu z określoną wersją

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

To polecenie pobiera wszystkie zasoby z modułu xHyper-V w wersji 3.0.0.0.

Parametry

-Module

Określa nazwę lub w pełni kwalifikowaną nazwę modułu, dla którego ma być wyświetlany zasób DSC.

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

-Name

Określa tablicę nazw zasobu DSC do wyświetlenia.

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

-Syntax

Wskazuje, że polecenie cmdlet zwraca widok składni dla określonych zasobów DSC. Zwrócona składnia pokazuje, jak używać zasobów w skryscie programu PowerShell.

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

Dane wejściowe

String[]

Object

Dane wyjściowe

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]