Add-VivaModuleFeaturePolicy
이 cmdlet은 Exchange Online PowerShell 모듈 v3.2.0 이상에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.
참고: 이 cmdlet은 현재 닫힌 프라이빗 미리 보기에 있는 기능의 일부입니다. organization 프라이빗 미리 보기의 멤버가 아니면 cmdlet이 작동하지 않습니다.
Add-VivaModuleFeaturePolicy cmdlet을 사용하여 Viva의 특정 기능에 대한 새 액세스 정책을 추가합니다. 정책의 특성은 cmdlet의 다양한 매개 변수를 사용하여 정의됩니다. 정책은 특정 사용자, 그룹 또는 전체 테넌트에서 지정된 기능에 대한 액세스를 제한하거나 부여하는 데 사용됩니다. 특정 사용자 또는 그룹에 대한 가장 제한적인 정책은 기능 사용 여부를 결정할 때 우선적으로 적용됩니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Add-VivaModuleFeaturePolicy
-FeatureId <String>
-IsFeatureEnabled <Boolean>
-ModuleId <String>
-Name <String>
[-Confirm]
[-GroupIds <String[]>]
[-UserIds <String[]>]
[-Everyone]
[-ResultSize <Unlimited>]
[-WhatIf]
[<CommonParameters>] Description
Add-VivaModuleFeaturePolicy cmdlet을 사용하여 Viva의 특정 기능에 대한 새 액세스 정책을 추가합니다.
인증하려면 Connect-ExchangeOnline cmdlet을 사용해야 합니다.
이 cmdlet에는 .NET Framework 4.7.2 이상이 필요합니다.
현재 이 cmdlet을 실행하려면 전역 관리자 역할의 멤버여야 합니다.
Azure Active Directory의 관리자 역할 권한에 대한 자세한 내용은 역할 템플릿 ID를 참조하세요.
예제
예 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다음은 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 -UserIds user1@contoso.com,user2@contoso.com다음은 Viva Insights 리플렉션 기능에 대한 정책을 추가하는 예제입니다. 정책은 지정된 사용자 및 그룹 구성원에 대한 기능을 사용하지 않도록 설정합니다.
매개 변수
-Confirm
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 기본 제공 일시 중지가 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분의 다른 cmdlet(예: New-* 및 Set-* cmdlet)에는 기본 제공 일시 중지가 없습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Everyone
모든 사용자 스위치는 정책이 organization 모든 사용자에게 적용되도록 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
GroupIds 또는 UserIds 매개 변수와 함께 이 스위치를 사용하지 마세요.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-FeatureId
FeatureId 매개 변수는 정책을 추가할 Viva 모듈의 기능을 지정합니다.
기능 액세스 제어를 지원하는 Viva 모듈의 기능에 대한 세부 정보를 보려면 Get-VivaModuleFeature cmdlet을 사용합니다. FeatureId 값은 cmdlet의 출력에 반환됩니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-GroupIds
GroupIds 매개 변수는 정책이 적용되는 그룹의 SMTP 주소(이메일 주소)를 지정합니다. 메일 사용이 가능한 AAD 그룹이 지원됩니다. Update
최대 20명의 총 사용자 또는 그룹(사용자 20명, 그룹 없음, 사용자 10명 및 그룹 10개 등)을 지정할 수 있습니다.
정책이 organization 모든 사용자에게 적용되도록 하려면 모두 스위치를 사용합니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IsFeatureEnabled
IsFeatureEnabled 매개 변수는 정책에서 기능을 사용할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 이 기능은 정책에 의해 활성화됩니다.
- $false: 이 기능은 정책에서 사용하도록 설정되지 않았습니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ModuleId
ModuleId 매개 변수는 기능 정책을 추가하려는 Viva 모듈을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Name
Name 매개 변수는 정책의 이름을 지정합니다. 최대 길이는 256자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
유효한 문자는 영어 문자, 숫자, 쉼표, 마침표 및 공백입니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ResultSize
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| Type: | Unlimited |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UserIds
UserIds 매개 변수는 정책이 적용되는 사용자의 UPN(사용자 계정 이름)을 지정합니다. Update
최대 20명의 총 사용자 또는 그룹(사용자 20명, 그룹 없음, 사용자 10명 및 그룹 10개 등)을 지정할 수 있습니다.
정책이 organization 모든 사용자에게 적용되도록 하려면 모두 스위치를 사용합니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-WhatIf
Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |