Find-DscResource
DSC(필요한 상태 구성) 리소스를 찾습니다.
구문
All
Find-DscResource
[[-Name] <String[]>]
[-ModuleName <String>]
[-MinimumVersion <Version>]
[-RequiredVersion <Version>]
[-AllVersions]
[-Tag <String[]>]
[-Filter <String>]
[-Repository <String[]>]
[<CommonParameters>]
Description
cmdlet은 Find-DscResource 등록된 리포지토리를 검색하여 모듈에 포함된 DSC 리소스를 찾습니다. 기본적으로 Find-DscResource 등록된 모든 리포지토리를 검색합니다.
찾 Find-DscResource은 각 모듈에 대해 PSGetDscResourceInfo 개체가 반환됩니다.
PSGetDscResourceInfo 개체는 파이프라인을 cmdlet으로 Install-Module 보낼 수 있습니다.
Install-Module 는 모듈을 설치합니다.
예제
예제 1: 모든 DSC 리소스 찾기
Find-DscResource 는 등록된 리포지토리에서 DSC 리소스를 반환합니다. 특정 리포지토리를 검색하려면 리포지토리 매개 변수를 사용합니다.
Find-DscResource
Name Version ModuleName Repository
---- ------- ---------- ----------
Carbon_Privilege 2.8.1 Carbon PSGallery
Carbon_ScheduledTask 2.8.1 Carbon PSGallery
Carbon_Service 2.8.1 Carbon PSGallery
PackageManagement 1.4 PackageManagement PSGallery
PackageManagementSource 1.4 PackageManagement PSGallery
PSModule 2.1.4 PowerShellGet PSGallery
PSRepository 2.1.4 PowerShellGet PSGallery
xArchive 8.7.0.0 xPSDesiredStateConfiguration PSGallery
xDSCWebService 8.7.0.0 xPSDesiredStateConfiguration PSGallery
xEnvironment 8.7.0.0 xPSDesiredStateConfiguration PSGallery
예제 2: 이름으로 DSC 리소스 찾기
Find-DscResource 는 이름으로 DSC 리소스를 찾습니다. 쉼표로 리소스 이름 배열을 구분합니다.
Find-DscResource -Name xWebsite, xWebApplication, xWebSiteDefaults
Name Version ModuleName Repository
---- ------- ---------- ----------
xWebApplication 2.6.0.0 xWebAdministration PSGallery
xWebsite 2.6.0.0 xWebAdministration PSGallery
xWebSiteDefaults 2.6.0.0 xWebAdministration PSGallery
Find-DscResource 는 Name 매개 변수를 사용하여 지정된 DSC 리소스 배열을 찾습니다.
예제 3: DSC 리소스 찾기 및 설치
Find-DscResource 는 DSC 리소스를 찾고 설치할 파이프라인 아래로 개체를 보냅니다.
설치 후 결과를 보는 데 사용합니다 Get-InstalledModule .
동일한 모듈의 여러 리소스를 파이프라인 Install-Module아래로 보낼 수 있습니다.
Install-Module 는 모듈을 한 번만 설치하려고 시도합니다.
Find-DscResource -Name xWebsite | Install-Module
Find-DscResource 에서는 Name 매개 변수를 사용하여 xWebsite라는 리소스를 찾습니다. 개체가 파이프라인 아래로 Install-Module cmdlet으로 전송됩니다.
Install-Module 는 리소스에 대한 xWebAdministration 모듈을 설치합니다.
예제 4: 모듈에서 모든 DSC 리소스 찾기
Find-DscResource 는 지정된 모듈에 포함된 모든 DSC 리소스를 찾습니다. 기본적으로 현재 버전이 표시됩니다. 다른 버전을 표시하려면 AllVersions 또는 RequiredVersions 매개 변수를 사용합니다.
Find-DscResource -ModuleName xWebAdministration
Name Version ModuleName Repository
---- ------- ---------- ----------
WebApplicationHandler 2.6.0.0 xWebAdministration PSGallery
xIisFeatureDelegation 2.6.0.0 xWebAdministration PSGallery
xIisHandler 2.6.0.0 xWebAdministration PSGallery
xIisLogging 2.6.0.0 xWebAdministration PSGallery
Find-DscResource 에서는 ModuleName 매개 변수를 사용하여 xWebAdministration 을 지정하고 모듈에 포함된 DSC 리소스를 찾습니다. 각 리소스의 현재 버전이 표시됩니다.
예제 5: 태그 및 필수 버전별로 DSC 리소스 찾기
DSC 리소스는 Tag 및 RequiredVersion 매개 변수를 사용하여 배치할 수 있습니다. 태그 는 리포지토리에 지정된 태그를 포함하는 모든 리소스의 현재 버전을 표시합니다. RequiredVersion 에는 ModuleName 매개 변수가 필요하며 Name 매개 변수는 선택 사항입니다. Name 및 ModuleName 매개 변수는 출력을 제한합니다. AllVersions 매개 변수를 사용하여 DSC 리소스의 사용 가능한 버전을 표시합니다.
Find-DscResource -ModuleName xWebAdministration -Tag DSC -RequiredVersion 1.20
Name Version ModuleName Repository
---- ------- ---------- ----------
xIisFeatureDelegation 1.20.0.0 xWebAdministration PSGallery
xIisHandler 1.20.0.0 xWebAdministration PSGallery
xIisLogging 1.20.0.0 xWebAdministration PSGallery
xIisMimeTypeMapping 1.20.0.0 xWebAdministration PSGallery
예제 6: 필터를 사용하여 리소스 찾기
Find-DscResource 는 모든 리소스를 찾고 Filter 매개 변수를 사용하여 도메인별로 결과를 지정합니다.
Filter 매개 변수는 개체의 설명 또는 모듈 이름에서 필터 값을 찾습니다. cmdlet을 Select-Object 사용하여 개체의 속성을 봅니다.
Find-DscResource -Filter Domain
Name Version ModuleName Repository
---- ------- ---------- ---------
xComputer 4.1.0.0 xComputerManagement PSGallery
Computer 6.4.0.0 ComputerManagementDsc PSGallery
xDSCDomainjoin 1.1 xDSCDomainjoin PSGallery
xDisk 1.0 xDisk PSGallery
xDSCFirewall 1.6.21 xDSCFirewall PSGallery
dmAwsTagInstance 1.0.1 domainAwsDSCResources PSGallery
매개 변수
-AllVersions
AllVersions 매개 변수는 DSC 리소스의 사용 가능한 각 버전을 표시합니다. MinimumVersion, MaximumVersion 또는 RequiredVersion 매개 변수에는 AllVersions 매개 변수를 사용할 수 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Filter
PackageManagement 공급자의 검색 구문을 기반으로 리소스를 찾습니다. 예를 들어 ModuleName 및 Description 속성 내에서 검색할 단어를 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-MinimumVersion
결과에 포함할 리소스의 최소 버전을 지정합니다. MinimumVersion 및 RequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.
매개 변수 속성
| 형식: | Version |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | 버전 |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ModuleName
DSC 리소스를 포함하는 모듈을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Name
리소스의 이름을 지정합니다. 기본값은 모든 리소스입니다. 쉼표로 리소스 이름 배열을 구분합니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Repository
리소스를 검색할 리포지토리를 지정합니다. 쉼표로 리포지토리 이름 배열을 구분합니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RequiredVersion
결과에 포함할 모듈의 정확한 버전 번호를 지정합니다. RequiredVersion 및 MinimumVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.
매개 변수 속성
| 형식: | Version |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Tag
리포지토리에서 모듈을 분류하는 태그를 지정합니다. 쉼표를 사용하여 태그 배열을 구분합니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
출력
PSGetDscResourceInfo
Find-DscResource
는 PSGetDscResourceInfo 개체를 반환합니다.