Udostępnij za pośrednictwem

Get-DscResource

  • Odwołanie
Moduł:
PSDesiredStateConfiguration

Pobiera zasoby konfiguracji żądanego stanu (DSC) obecne na komputerze.

Składnia

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

Opis

Polecenie cmdlet Get-DscResource 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 utworzonymi 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 symboli wieloznacznych określonych 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.

Typ:Object
Position:1
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

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

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:True

-Syntax

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

Typ:SwitchParameter
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String[]

Object

Dane wyjściowe

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]

Uwagi

  • Get-DscResource nie znajduje zasobów DSC opartych na klasie w programie PowerShell w wersjach poniżej 7.0.