Get-VivaModuleFeatureEnablement
이 cmdlet은 Exchange Online PowerShell 모듈 버전 3.2.0 이상에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.
Get-VivaModuleFeatureEnablement cmdlet을 사용하여 특정 사용자 또는 그룹에 대해 Viva 모듈의 기능을 사용할 수 있는지 여부를 확인합니다. 기능 사용 여부를 기능의 "사용 상태"라고 합니다. 이 cmdlet에서 반환된 사용 상태는 관리자가 설정한 액세스 정책을 기반으로 합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Get-VivaModuleFeatureEnablement
-FeatureId <String>
-Identity <String>
-ModuleId <String>
[-Detailed]
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Get-VivaModuleFeatureEnablement cmdlet을 사용하여 특정 사용자 또는 그룹에 대해 Viva 모듈의 기능을 사용할 수 있는지 여부를 확인합니다.
인증하려면 Connect-ExchangeOnline cmdlet을 사용해야 합니다.
이 cmdlet에는 .NET Framework 4.7.2 이상이 필요합니다.
현재 이 cmdlet을 실행하려면 전역 관리자 역할의 멤버여야 합니다.
Microsoft Entra ID 관리자 역할 권한에 대한 자세한 내용은 역할 템플릿 ID를 참조하세요.
중요
Microsoft는 최소 권한 원칙을 강력히 옹호합니다. 계정에 작업을 수행하는 데 필요한 최소 권한만 할당하면 보안 위험을 줄이고 organization 전반적인 보호를 강화하는 데 도움이 됩니다. 전역 관리자는 일반적으로 긴급 시나리오로 제한하거나 다른 역할을 사용할 수 없는 경우 매우 권한 있는 역할입니다.
예제
예 1
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com
이 예제에서는 사용자의 Viva Insights에서 리플렉션 기능의 사용 상태를 반환합니다 user@contoso.com .
예 2
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity group@contoso.com
이 예제에서는 그룹의 Viva Insights에서 리플렉션 기능의 사용 상태를 반환합니다 group@contoso.com .
예 3
Get-VivaModuleFeatureEnablement -ModuleId VivaInsights -FeatureId Reflection -Identity user@contoso.com -Detailed
이 예제에서는 사용자의 Viva Insights에서 리플렉션 기능의 사용 상태를 반환합니다 user@contoso.com . 기능의 사용 상태를 구동하는 정책에 대한 추가 정보를 제공하도록 응답이 향상되었습니다.
매개 변수
-Detailed
적용 가능: Exchange Online
참고: 이 매개 변수는 모듈 버전 3.8.1-Preview1 이상에서 사용할 수 있습니다.
세부 정보 스위치는 보다 포괄적인 정보를 제공하여 명령의 출력을 향상시킵니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치는 관련 정책 및 효율성을 포함하여 자세한 인사이트를 반환합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-FeatureId
적용 가능: Exchange Online
FeatureId 매개 변수는 Viva 모듈의 기능을 지정합니다.
기능 액세스 제어를 지원하는 Viva 모듈의 기능에 대한 세부 정보를 보려면 Get-VivaModuleFeature cmdlet을 참조하세요. Get-VivaModuleFeature cmdlet에서 제공하는 세부 정보에는 기능 식별자가 포함됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Identity
적용 가능: Exchange Online
Identity 매개 변수는 사용자의 UPN(사용자 계정 이름) 또는 기능 사용 상태 보려는 그룹의 SMTP 주소(이메일 주소)를 지정합니다.
메일 사용 Microsoft Entra 그룹이 지원됩니다.
주의: identity 매개 변수의 값 $null 또는 존재하지 않는 값은 Identity 매개 변수 없이 Get- 명령을 실행한 것처럼 모든 개체를 반환합니다. Identity 매개 변수에 대한 값 목록이 정확하고 존재하지 않는 $null 값이 포함되어 있지 않은지 확인합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ModuleId
적용 가능: Exchange Online
ModuleId 매개 변수는 Viva 모듈을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ResultSize
적용 가능: Exchange Online
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | Unlimited |
| 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를 참조하세요.