Get-VivaModuleFeaturePolicy
이 cmdlet은 Exchange Online PowerShell 모듈 버전 3.2.0 이상에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.
Get-VivaModuleFeaturePolicy cmdlet을 사용하여 Viva Viva 모듈에서 지정된 기능에 대한 액세스 정책을 볼 수 있습니다. 정책은 특정 사용자, 그룹 또는 전체 테넌트에서 지정된 기능에 대한 액세스를 제한하거나 부여하는 데 사용됩니다. 이 cmdlet은 정책의 식별자, 이름 및 생성 날짜를 포함하여 정책에 대한 세부 정보를 제공합니다. cmdlet은 MemberIds를 기반으로 정책을 필터링하여 관리자가 특정 사용자 또는 그룹과 관련된 정책을 볼 수 있도록 할 수 있습니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
FeaturePolicy
Get-VivaModuleFeaturePolicy
[[-PolicyId] <String>]
-FeatureId <String>
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
FeaturePolicyWithMembers
Get-VivaModuleFeaturePolicy
[[-FeatureId] <String>]
[[-MemberIds] <String[]>]
-ModuleId <String>
[-ResultSize <Unlimited>]
[<CommonParameters>]
Description
Get-VivaModuleFeaturePolicy cmdlet을 사용하여 Viva Viva 모듈에서 지정된 기능에 대한 액세스 정책을 볼 수 있습니다.
Viva Viva 모듈에서 지정된 기능에 대한 모든 정책을 볼 수 있습니다. 특정 정책을 보려면 PolicyId 매개 변수를 포함할 수 있습니다.
cmdlet은 MemberIds를 기반으로 정책을 필터링하여 관리자가 특정 사용자 또는 그룹과 관련된 정책을 볼 수 있도록 할 수 있습니다.
인증하려면 Connect-ExchangeOnline cmdlet을 사용해야 합니다.
이 cmdlet에는 .NET Framework 4.7.2 이상이 필요합니다.
현재 이 cmdlet을 실행하려면 전역 관리자 역할의 멤버이거나 기능 수준에서 할당된 역할이어야 합니다.
기능 수준에서 할당된 역할에 대한 자세한 내용은 기능 액세스 관리에 사용할 수 있는 기능을 참조하세요.
Microsoft Entra ID의 관리자 역할 권한에 대한 자세한 내용은 역할 템플릿 ID를 참조하세요.
중요
Microsoft는 최소 권한 원칙을 강력히 옹호합니다. 계정에 작업을 수행하는 데 필요한 최소 권한만 할당하면 보안 위험을 줄이고 organization 전반적인 보호를 강화하는 데 도움이 됩니다. 전역 관리자는 일반적으로 긴급 시나리오로 제한하거나 다른 역할을 사용할 수 없는 경우 매우 권한 있는 역할입니다.
예제
예 1
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection
이 예제에서는 Viva Insights 리플렉션 기능에 대해 추가된 모든 정책에 대한 세부 정보를 반환합니다.
예 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
이 예제에서는 Viva Insights 리플렉션 기능에 대해 추가된 특정 정책에 대한 세부 정보를 반환합니다.
예 3
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com
이 예제에서는 전자 메일user1@contoso.com을 사용하여 사용자에게 적용되는 Viva Insights 리플렉션 기능에 대한 정책에 대한 세부 정보를 반환합니다.
예 4
Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com
이 예제에서는 전자 메일이 있는 사용자 및 메일 user1@contoso.comgroup1@contoso.com이 있는 그룹에 적용되는 모든 Viva 모듈의 모든 기능에 대한 정책에 대한 세부 정보를 반환합니다.
매개 변수
-FeatureId
적용 가능: Exchange Online
FeatureId 매개 변수는 정책을 보려는 Viva 모듈의 기능을 지정합니다.
기능 액세스 제어를 지원하는 Viva 모듈의 기능에 대한 세부 정보를 보려면 Get-VivaModuleFeature cmdlet을 참조하세요. Get-VivaModuleFeature cmdlet에서 제공하는 세부 정보에는 기능 식별자가 포함됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
FeaturePolicy
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
FeaturePolicyWithMembers
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-MemberIds
적용 가능: Exchange Online
참고: 이 매개 변수는 모듈 버전 3.8.1-Preview1 이상에서 사용할 수 있습니다.
MemberIds 매개 변수는 Viva 모듈에서 기능에 대한 정책을 보려는 특정 사용자 또는 그룹을 지정합니다.
최대 3개의 멤버 ID를 제공할 수 있습니다. * 문자를 사용하여 모든 모듈 또는 기능을 지정합니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
FeaturePolicyWithMembers
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ModuleId
적용 가능: Exchange Online
ModuleId 매개 변수는 보려는 기능 정책의 Viva 모듈을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-PolicyId
적용 가능: Exchange Online
PolicyId 매개 변수는 보려는 Viva 모듈의 기능에 대한 특정 정책을 지정합니다.
Viva 모듈의 기능에 대한 모든 정책에 대한 세부 정보를 보려면 PolicyId 매개 변수 없이 이 cmdlet을 실행합니다. 이러한 세부 정보에는 Viva 모듈의 기능에 대한 모든 정책의 식별자가 포함됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
FeaturePolicy
| Position: | Positional |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ResultSize
적용 가능: Exchange Online
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
매개 변수 속성
| 형식: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
| 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를 참조하세요.