Find-RoleCapability
모듈에서 역할 기능을 찾습니다.
구문
All
Find-RoleCapability
[[-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-RoleCapability 등록된 리포지토리를 검색하여 PowerShell 역할 기능 및 모듈을 찾습니다.
찾 Find-RoleCapability은 각 역할 기능에 대해 PSGetRoleCapabilityInfo 개체가 반환됩니다.
PSGetRoleCapabilityInfo 개체는 파이프라인을 또는 Install-Module cmdlet으로 Save-Module 보낼 수 있습니다.
PowerShell 역할 기능은 JEA(Just Enough Administration) 엔드포인트에서 사용자가 사용할 수 있는 명령 및 애플리케이션을 정의합니다. 역할 기능은 확장이 있는 파일에 .psrc 의해 정의됩니다.
예제
예제 1: 역할 기능 찾기
Find-RoleCapability 는 등록된 각 리포지토리에서 역할 기능을 찾습니다. 특정 리포지토리를 검색하려면 리포지토리 매개 변수를 사용합니다.
Find-RoleCapability
Name Version ModuleName Repository
---- ------- ---------- ----------
General-Lev1 1.0 JeaExamples PSGallery
General-Lev2 1.0 JeaExamples PSGallery
IIS-Lev1 1.0 JeaExamples PSGallery
IIS-Lev2 1.0 JeaExamples PSGallery
예제 2: 이름으로 역할 기능 찾기
Find-RoleCapability 는 이름별로 역할 기능을 찾습니다. 쉼표로 이름 배열을 구분합니다.
Find-RoleCapability -Name General-Lev1, IIS-Lev2
Name Version ModuleName Repository
---- ------- ---------- ----------
General-Lev1 1.0 JeaExamples PSGallery
IIS-Lev2 1.0 JeaExamples PSGallery
예제 3: 역할 기능의 모듈 찾기 및 저장
cmdlet은 Find-RoleCapability 역할 기능을 찾아서 파이프라인 아래로 개체를 보냅니다.
Save-Module 는 역할 기능의 모듈을 파일 시스템에 저장합니다.
Get-ChildItem 는 모듈 디렉터리의 내용을 표시합니다.
PS> Find-RoleCapability -Name General-Lev1 | Save-Module -Path C:\Test\Modules
PS> Get-ChildItem -Path C:\Test\Modules\JeaExamples\1.0\
Directory: C:\Test\Modules\JeaExamples\1.0
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 6/4/2019 16:37 RoleCapabilities
-a---- 2/5/2019 18:46 1702 CreateRegisterPSSC.ps1
-a---- 2/5/2019 18:46 7656 JeaExamples.psd1
-a---- 10/1/2018 08:16 595 JeaExamples.psm1
Find-RoleCapability 는 Name 매개 변수를 사용하여 General-Lev1 역할 기능을 지정합니다.
개체가 파이프라인 아래로 전송됩니다.
Save-Module 는 파일 시스템 위치에 대한 Path 매개 변수를 사용하여 모듈을 저장합니다. 모듈을 저장 Get-ChildItem 한 후 모듈의 경로를 지정하고 JeaExamples 모듈의 디렉터리의 내용을 표시합니다.
예제 4: 역할 기능의 모듈 찾기 및 설치
Find-RoleCapability 는 모듈을 찾고 개체를 파이프라인 아래로 보냅니다.
Install-Module 는 모듈을 설치합니다. 설치 후 결과를 확인하는 데 사용합니다 Get-InstalledModule .
Find-RoleCapability -Name General-Lev1 | Install-Module -Verbose
VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'JeaExamples'.
VERBOSE: InstallPackageLocal' - name='JeaExamples', version='1.0',
VERBOSE: Validating the 'JeaExamples' module contents
VERBOSE: Test-ModuleManifest successfully validated the module manifest file
VERBOSE: Module 'JeaExamples' was installed successfully to path
Get-InstalledModule
Find-RoleCapability 는 Name 매개 변수를 사용하여 General-Lev1 역할 기능을 지정합니다.
개체가 파이프라인 아래로 전송됩니다.
Install-Module 에서는 Verbose 매개 변수를 사용하여 설치하는 동안 상태 메시지를 표시합니다. 설치가 완료되면 출력에서 Get-InstalledModuleJeaExamples 모듈이 설치되었음을 확인합니다.
매개 변수
-AllowPrerelease
결과에 시험판으로 표시된 리소스를 포함합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-AllVersions
이 cmdlet은 모듈의 모든 버전을 가져옵니다. 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 |
-MaximumVersion
결과에 포함할 모듈의 최대 버전을 지정합니다. MaximumVersion 및 RequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-MinimumVersion
결과에 포함할 모듈의 최소 버전을 지정합니다. MinimumVersion 및 RequiredVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ModuleName
역할 기능을 검색할 모듈의 이름을 지정합니다. 기본값은 모든 모듈입니다.
매개 변수 속성
| 형식: | 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 |
-Proxy
인터넷 리소스에 대한 직접 연결이 아닌 요청에 대한 프록시 서버를 지정합니다.
매개 변수 속성
| 형식: | Uri |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-ProxyCredential
프록시 매개 변수에 지정된 프록시 서버를 사용할 수 있는 권한이 있는 사용자 계정을 지정합니다.
매개 변수 속성
| 형식: | PSCredential |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Repository
역할 기능을 검색할 리포지토리를 지정합니다. 쉼표로 리포지토리 이름 배열을 구분합니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-RequiredVersion
결과에 포함할 모듈의 정확한 버전 번호를 지정합니다. RequiredVersion 및 MinimumVersion 매개 변수는 동일한 명령에서 사용할 수 없습니다.
매개 변수 속성
| 형식: | String |
| 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를 참조하세요.
입력
Uri
PSCredential
출력
PSGetRoleCapabilityInfo
cmdlet은 Find-RoleCapabilityPSGetRoleCapabilityInfo 개체를 반환합니다.
참고
중요합니다
2020년 4월부터 PowerShell 갤러리는 더 이상 TLS(전송 계층 보안) 버전 1.0 및 1.1을 지원하지 않습니다. TLS 1.2 이상을 사용하지 않는 경우 PowerShell 갤러리에 액세스하려고 할 때 오류가 발생합니다. 다음 명령을 사용하여 TLS 1.2를 사용하고 있는지 확인합니다.
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
자세한 내용은 PowerShell 블로그의 공지 참조하세요.
