다음을 통해 공유

Add-VivaModuleFeaturePolicy

  • 참조
모듈:
ExchangePowerShell
적용 대상:
Exchange Online

이 cmdlet은 Exchange Online PowerShell 모듈 v3.2.0 이상에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.

참고: 범주에 대한 지원은 모듈 버전 3.5.0-Preview2 이상에서 사용할 수 있지만 Viva 현재 사용할 수 있는 범주는 없습니다. 범주를 사용할 수 있는 경우 설명서를 업데이트합니다.

Add-VivaModuleFeaturePolicy cmdlet을 사용하여 특정 기능 또는 Viva 범주에 대한 새 액세스 정책을 추가합니다. 정책의 특성은 cmdlet 매개 변수를 사용하여 정의됩니다. 정책은 특정 사용자, 그룹 또는 전체 테넌트에서 지정된 기능 또는 범주에 대한 액세스를 제한하거나 부여하는 데 사용됩니다.

  • 기능/범주당 최대 10의 정책을 할당할 수 있습니다. 기능/범주당 하나의 추가 정책을 전체 테넌트에 할당할 수 있습니다.
  • 특정 사용자 또는 그룹에 할당된 정책은 기능/범주를 사용할 수 있는지 여부를 결정할 때 전체 테넌트에게 할당된 정책보다 우선합니다. 사용자에게 기능/범주에 대해 할당된 여러 정책(그룹의 사용자 또는 구성원으로 직접)이 할당된 경우 가장 제한적인 정책이 적용됩니다.
  • 범주 정책에서 범주를 사용하지 않도록 설정하면 기능 수준에서 설정된 정책에 관계없이 범주 아래의 모든 기능이 비활성화됩니다.
  • 범주 정책 수준이 아닌 기능 정책 수준에서만 사용자 컨트롤을 업데이트할 수 있습니다.
  • 일부 기능은 특정 사용자 또는 그룹이 아닌 전체 테넌트에서 적용되는 정책만 지원합니다. Get-VivaModuleFeature cmdlet을 사용하여 기능에 대해 지원되는 정책 범위를 참조할 수 있습니다.

일부 기능에는 사용자 컨트롤에 대한 옵션(사용자 옵트아웃)이 포함됩니다. 정책을 설정하려는 기능에 대해 사용자 컨트롤을 사용할 수 있는지 확인하려면 기능 설명서를 참조하세요.

아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.

구문

Add-VivaModuleFeaturePolicy
   -FeatureId <String>
   -IsFeatureEnabled <Boolean>
   -ModuleId <String>
   -Name <String>
   [-Confirm]
   [-Everyone]
   [-GroupIds <String[]>]
   [-IsUserControlEnabled <Boolean>]
   [-ResultSize <Unlimited>]
   [-UserIds <String[]>]
   [-WhatIf]
   [<CommonParameters>]
Add-VivaModuleFeaturePolicy
   -CategoryId <String>
   -IsCategoryEnabled <Boolean>
   -Name <String>
   [-Confirm]
   [-Everyone]
   [-GroupIds <String[]>]
   [-ResultSize <Unlimited>]
   [-UserIds <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

Add-VivaModuleFeaturePolicy cmdlet을 사용하여 Viva 특정 기능 또는 범주에 대한 새 액세스 정책을 추가합니다.

범주에 대한 지원은 모듈 버전 3.5.0-Preview2 이상에서 사용할 수 있습니다.

인증하려면 Connect-ExchangeOnline cmdlet을 사용해야 합니다.

이 cmdlet에는 .NET Framework 4.7.2 이상이 필요합니다.

현재 이 cmdlet을 실행하려면 전역 관리자 역할의 멤버이거나 기능 수준에서 할당된 역할이어야 합니다.

기능 수준에서 할당된 역할에 대한 자세한 내용은 기능 액세스 관리에 사용할 수 있는 기능을 참조하세요.

Microsoft Entra ID 관리자 역할 권한에 대한 자세한 내용은 역할 템플릿 ID를 참조하세요.

중요

사용 권한이 가장 적은 역할을 사용하는 것이 좋습니다. 사용 권한이 낮은 계정을 사용하면 organization 대한 보안을 개선하는 데 도움이 됩니다. 전역 관리자는 기존 역할을 사용할 수 없는 경우 긴급 시나리오로 제한해야 하는 매우 권한이 높은 역할입니다.

예제

예 1

Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name DisableFeatureForAll -IsFeatureEnabled $false -Everyone

다음은 Viva Insights 리플렉션 기능에 대한 정책을 추가하는 예제입니다. 정책은 organization 모든 사용자에 대해 기능을 사용하지 않도록 설정합니다.

예 2

Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3

다음은 Viva Insights 리플렉션 기능에 대한 정책을 추가하는 예제입니다. 정책은 지정된 그룹의 모든 사용자에 대해 기능을 사용하지 않도록 설정합니다.

예 3

Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name MultipleUsers -IsFeatureEnabled $false -UserIds user1@contoso.com,user2@contoso.com

다음은 Viva Insights 리플렉션 기능에 대한 정책을 추가하는 예제입니다. 정책은 지정된 사용자에 대한 기능을 사용하지 않도록 설정합니다.

예 4

Add-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Name UsersAndGroups -IsFeatureEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.com

다음은 Viva Insights 리플렉션 기능에 대한 정책을 추가하는 예제입니다. 정책은 지정된 사용자 및 그룹 구성원에 대한 기능을 사용하지 않도록 설정합니다.

예 5

Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name DisableCategoryForAll -IsCategoryEnabled $false -Everyone

이 예제에서는 Viva 범주에 <category_id> 대한 정책을 추가합니다. 정책은 organization 모든 사용자에 대해 범주(범주 아래의 모든 기능)를 사용하지 않도록 설정합니다.

예 6

Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3

이 예제에서는 Viva 범주에 <category_id> 대한 정책을 추가합니다. 정책은 지정된 그룹의 모든 사용자에 대해 범주(범주 아래의 모든 기능)를 사용하지 않도록 설정합니다.

예 7

Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name MultipleUsers -IsCategoryEnabled $false -UserIds user1@contoso.com,user2@contoso.com

이 예제에서는 Viva 범주에 <category_id> 대한 정책을 추가합니다. 정책은 지정된 사용자에 대해 범주(범주 아래의 모든 기능)를 사용하지 않도록 설정합니다.

예 8

Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name UsersAndGroups -IsCategoryEnabled $false -GroupIds group1@contoso.com,group2@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com,user2@contoso.com

이 예제에서는 Viva 범주에 <category_id> 대한 정책을 추가합니다. 정책은 지정된 사용자 및 그룹 구성원에 대해 범주(범주 아래의 모든 기능)를 사용하지 않도록 설정합니다.

예제 9

Add-VivaModuleFeaturePolicy -CategoryId <category_id> -Name "Disable Category For All" -IsCategoryEnabled $false -Everyone

다음은 정책 이름이 공백인 <category_id> Viva 범주에 대한 정책을 추가하는 예제입니다. 정책은 organization 모든 사용자에 대해 범주(범주 아래의 모든 기능)를 사용하지 않도록 설정합니다.

매개 변수

-CategoryId

이 매개 변수는 모듈 버전 3.5.0-Preview2 이상에서 사용할 수 있습니다.

참고: 현재 Viva 사용할 수 있는 범주는 없습니다. 범주를 사용할 수 있는 경우 설명서를 업데이트합니다.

CategoryId 매개 변수는 정책을 추가할 Viva 범주를 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-Confirm

Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.

  • 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문 -Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다.
  • 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.

이 cmdlet에는 기본 제공 일시 중지가 있으므로 을 사용하여 -Confirm:$false 확인을 건너뜁니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-Everyone

모든 사용자 스위치는 정책이 organization 모든 사용자에게 적용되도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

GroupIds 또는 UserIds 매개 변수와 함께 이 스위치를 사용하지 마세요.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-FeatureId

FeatureId 매개 변수는 정책을 추가할 Viva 모듈의 기능을 지정합니다.

기능 액세스 제어를 지원하는 Viva 모듈의 기능에 대한 세부 정보를 보려면 Get-VivaModuleFeature cmdlet을 사용합니다. FeatureId 값은 cmdlet의 출력에 반환됩니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-GroupIds

GroupIds 매개 변수는 업데이트된 정책이 적용되는 그룹의 이메일 주소 또는 GUID(보안 그룹 개체 ID)를 지정합니다. 메일 사용 및 비메일 사용 Microsoft Entra 그룹이 모두 지원됩니다. Update

최대 20명의 총 사용자 또는 그룹(사용자 20명, 그룹 없음, 사용자 10명 및 그룹 10개 등)을 지정할 수 있습니다.

정책이 organization 모든 사용자에게 적용되도록 하려면 모두 스위치를 사용합니다.

참고: 모듈의 v3.5.1-Preview2 이상에서 이 매개 변수는 GUID(보안 그룹 개체 ID)를 지원합니다. 이전 버전의 모듈에서는 이 매개 변수에 대한 이메일 주소만 허용합니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-IsCategoryEnabled

이 매개 변수는 모듈 버전 3.5.0-Preview2 이상에서 사용할 수 있습니다.

참고: 현재 Viva 사용할 수 있는 범주는 없습니다. 범주를 사용할 수 있는 경우 설명서를 업데이트합니다.

IsCategoryEnabled 매개 변수는 정책에서 범주를 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 범주는 정책에 의해 활성화됩니다.
  • $false: 정책에서 범주를 사용할 수 없습니다.
형식:Boolean
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-IsFeatureEnabled

IsFeatureEnabled 매개 변수는 정책에서 기능을 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 이 기능은 정책에 의해 활성화됩니다.
  • $false: 이 기능은 정책에서 사용하도록 설정되지 않았습니다.
형식:Boolean
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-IsUserControlEnabled

이 매개 변수는 모듈 버전 3.3.0 이상에서 사용할 수 있습니다.

IsUserControlEnabled 매개 변수는 정책에서 사용자 컨트롤을 사용하도록 설정할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.

  • $true: 사용자 컨트롤은 정책에 의해 활성화됩니다. 사용자는 기능을 옵트아웃할 수 있습니다.
  • $false: 사용자 컨트롤은 정책에 의해 사용하도록 설정되지 않습니다. 사용자는 이 기능을 선택할 수 없습니다.

관리자가 정책에 따라 사용자 컨트롤을 사용하도록 설정하고 사용하지 않도록 설정할 수 있는 기능만 이 매개 변수를 사용할 수 있습니다. 이 기능이 사용자 컨트롤을 전환하는 관리자를 지원하지 않는 경우 기본값이 적용됩니다. 자세한 내용은 기능 설명서를 참조하세요.

형식:Boolean
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-ModuleId

ModuleId 매개 변수는 기능 정책을 추가할 Viva 모듈을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-Name

Name 매개 변수는 정책의 이름을 지정합니다. 최대 길이는 256자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.

유효한 문자는 영어 문자, 숫자, 쉼표, 마침표 및 공백입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-ResultSize

이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.

형식:Unlimited
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-UserIds

UserIds 매개 변수는 정책이 적용되는 사용자의 UPN(사용자 계정 이름)을 지정합니다. Update

최대 20명의 총 사용자 또는 그룹(사용자 20명, 그룹 없음, 사용자 10명 및 그룹 10개 등)을 지정할 수 있습니다.

정책이 organization 모든 사용자에게 적용되도록 하려면 모두 스위치를 사용합니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online

-WhatIf

Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False
적용 대상:Exchange Online