Find-DscResource

모듈:

PowerShellGet

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    PSGallery

Find-DscResource 는 Name 매개 변수를 사용하여 지정된 DSC 리소스 배열을 찾습니다.

예제 2: DSC 리소스 찾기 및 설치

Find-DscResource 는 DSC 리소스를 찾고 설치할 파이프라인 아래로 개체를 보냅니다. 설치 후 를 사용하여 Get-InstalledModule 결과를 확인합니다.

동일한 모듈의 여러 리소스를 파이프라인 Install-Module으로 보낼 수 있습니다. Install-Module 는 모듈을 한 번만 설치하려고 시도합니다.

Find-DscResource -Name xWebsite | Install-Module

Find-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

관련 링크

• Get-InstalledModule
• Install-Module
• Register-PSRepository
• Select-Object
• Uninstall-Module