Get-DscResource

컴퓨터에 있는 DSC(Desired State Configuration) 리소스를 가져옵니다.

Syntax

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

Description

cmdlet은 Get-DscResource 컴퓨터에 있는 PowerShell DSC 리소스를 검색합니다. 이 cmdlet은 PSModulePath에 설치된 리소스만 검색합니다. 사용자가 만든 기본 제공 및 사용자 지정 공급자에 대한 세부 정보를 보여 줍니다. 또한 이 cmdlet은 모듈로 패키지되거나 세션에서 런타임에 생성되는 다른 구성인 복합 리소스에 대한 세부 정보도 보여 줍니다.

예제

예제 1: 로컬 컴퓨터의 모든 리소스 가져오기

Get-DscResource

이 명령은 로컬 컴퓨터의 모든 리소스를 가져옵니다.

예제 2: 이름을 지정하여 리소스 가져오기

Get-DscResource -Name "WindowsFeature"

이 명령은 WindowsFeature 리소스를 가져옵니다.

예제 3: 모듈에서 모든 리소스 가져오기

Get-DscResource -Module "xHyper-V"

이 명령은 xHyper-V 모듈에서 모든 리소스를 가져옵니다.

예제 4: 와일드카드 문자를 사용하여 리소스 가져오기

Get-DscResource -Name P*,r*

이 명령은 Name 매개 변수로 지정된 와일드카드 패턴과 일치하는 모든 리소스를 가져옵니다.

예제 5: 리소스 구문 가져오기

Get-DscResource -Name "WindowsFeature" -Syntax

이 명령은 WindowsFeature 리소스를 가져오고 리소스에 대한 구문을 보여 줍니다.

예제 6: 리소스에 대한 모든 속성 가져오기

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

이 명령은 사용자 리소스를 가져온 다음 파이프라인 연산자를 사용하여 사용자 리소스의 모든 속성을 반환합니다.

예제 7: 지정된 버전을 사용하여 지정된 모듈에서 모든 리소스 가져오기

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

이 명령은 버전 3.0.0.0이 있는 xHyper-V 모듈에서 모든 리소스를 가져옵니다.

매개 변수

-Module

DSC 리소스를 볼 모듈의 이름 또는 정규화된 이름을 지정합니다.

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

-Name

볼 DSC 리소스의 이름 배열을 지정합니다.

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

-Syntax

cmdlet이 지정된 DSC 리소스의 구문 뷰를 반환한다는 것을 나타냅니다. 반환된 구문은 PowerShell 스크립트에서 리소스를 사용하는 방법을 보여 줍니다.

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

입력

String[]

Object

출력

Microsoft.PowerShell.DesiredStateConfiguration.DscResourceInfo[]

string[]

참고

  • Get-DscResource 에서는 7.0 미만의 PowerShell 버전에서 클래스 기반 DSC 리소스를 찾을 수 없습니다.