Find-DscResource
DSC(Desired State Configuration) 리소스를 찾습니다.
Syntax
Find-DscResource
[[-Name] <String[]>]
[-ModuleName <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-AllVersions]
[-AllowPrerelease]
[-Tag <String[]>]
[-Filter <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-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 PSGalleryFind-DscResource 에서는 Name 매개 변수를 사용하여 지정된 DSC 리소스 배열을 찾습니다.
예제 3: DSC 리소스 찾기 및 설치
Find-DscResource 는 DSC 리소스를 찾고 설치할 파이프라인 아래로 개체를 보냅니다.
설치 후 를 사용하여 Get-InstalledModule 결과를 확인합니다.
동일한 모듈의 여러 리소스를 파이프라인 Install-Module아래로 보낼 수 있습니다.
Install-Module 는 모듈을 한 번만 설치하려고 시도합니다.
Find-DscResource -Name xWebsite | Install-ModuleFind-DscResource 에서는 Name 매개 변수를 사용하여 xWebsite라는 리소스를 찾습니다. 개체가 파이프라인 아래로 cmdlet으로 Install-Module 전송됩니다. 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 PSGalleryFind-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매개 변수
-AllowPrerelease
결과에 시험판으로 표시된 리소스를 포함합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
AllVersions 매개 변수는 DSC 리소스의 사용 가능한 각 버전을 표시합니다. MinimumVersion, MaximumVersion 또는 RequiredVersion 매개 변수에는 AllVersions 매개 변수를 사용할 수 없습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
PackageManagement 공급자의 검색 구문을 기반으로 리소스를 찾습니다. 예를 들어 ModuleName 및 Description 속성 내에서 검색할 단어를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
결과에 포함할 리소스의 최대 버전을 지정합니다. MaximumVersion 및 RequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
결과에 포함할 리소스의 최소 버전을 지정합니다. MinimumVersion 및 RequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
DSC 리소스가 포함된 모듈을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
리소스의 이름을 지정합니다. 기본값은 모든 리소스입니다. 쉼표로 리소스 이름 배열을 구분합니다.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
인터넷 리소스에 대한 직접 연결이 아닌 요청에 대한 프록시 서버를 지정합니다.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Proxy 매개 변수에 지정된 프록시 서버를 사용할 수 있는 권한이 있는 사용자 계정을 지정합니다.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
리소스를 검색할 리포지토리를 지정합니다. 쉼표로 리포지토리 이름 배열을 구분합니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
결과에 포함할 모듈의 정확한 버전 번호를 지정합니다. RequiredVersion 및 MinimumVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
리포지토리에서 모듈을 분류하는 태그를 지정합니다. 쉼표를 사용하여 태그 배열을 구분합니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
출력
PSGetDscResourceInfo
Find-DscResource 는 PSGetDscResourceInfo 개체를 반환합니다.
참고
중요
2020년 4월부터 PowerShell 갤러리는 더 이상 TLS(전송 계층 보안) 버전 1.0 및 1.1을 지원하지 않습니다. TLS 1.2 이상을 사용하지 않을 경우 PowerShell 갤러리에 액세스하려고 하면 오류가 표시됩니다. 다음 명령을 사용하여 TLS 1.2를 사용하는지 확인합니다.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
자세한 내용은 PowerShell 블로그의 공지를 참조하세요.
관련 링크
PowerShellGet