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 등록된 모든 리포지토리를 검색합니다.
Microsoft.PowerShell.PSResourceGet의 Find-PSResource cmdlet에 대한 프록시 cmdlet입니다. 자세한 내용은 Find-PSResource를 참조하세요.
예제
예제 1: 이름으로 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 리소스 배열을 찾습니다.
예제 2: 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 모듈을 설치합니다.
매개 변수
-AllowPrerelease
결과에 시험판으로 표시된 리소스를 포함합니다.
프록시 cmdlet은 이 매개 변수를 의 시험판 매개 변수에 Find-PSResource매핑합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllVersions
프록시 cmdlet은 의 DscResourceNameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Filter
프록시 cmdlet은 의 DscResourceNameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumVersion
프록시 cmdlet은 의 DscResourceNameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MinimumVersion
프록시 cmdlet은 의 DscResourceNameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ModuleName
프록시 cmdlet은 의 DscResourceNameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
리소스의 이름을 지정합니다. 기본값은 모든 리소스입니다. 쉼표로 리소스 이름 배열을 구분합니다.
프록시 cmdlet은 이 매개 변수를 의 Find-PSResourceDscResourceName 매개 변수에 매핑합니다.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
프록시 cmdlet은 의 DscResourceNameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
프록시 cmdlet은 의 DscResourceNameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.
| 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
프록시 cmdlet은 의 DscResourceNameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Tag
프록시 cmdlet은 의 DscResourceNameParameterSetFind-PSResource에서 지원되지 않으므로 이 매개 변수를 무시합니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
출력
PSGetDscResourceInfo
Find-DscResource는 PSGetDscResourceInfo 개체를 반환합니다.
참고
PowerShell 갤러리 더 이상 TLS(전송 계층 보안) 버전 1.0 및 1.1을 지원하지 않습니다. TLS 1.2 이상을 사용해야 합니다. 다음 명령을 사용하여 TLS 1.2를 사용하는지 확인합니다.
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12
관련 링크
PSResourceGet