Update-VivaModuleFeaturePolicy
이 cmdlet은 Exchange Online PowerShell 모듈 버전 3.2.0 이상에서만 사용할 수 있습니다. 자세한 내용은 Exchange Online PowerShell 모듈 정보를 참조하세요.
Update-VivaModuleFeaturePolicy cmdlet을 사용하여 Viva Viva 모듈의 기능에 대한 액세스 정책을 업데이트합니다.
- 기능에 대한 전체 테넌트 정책이 이미 있는 경우 특정 사용자 또는 그룹에 대한 정책을 업데이트하여 전체 테넌트가 포함되도록 할 수 없습니다. 테넌트 전체 정책이 하나만 지원됩니다.
- 특정 사용자 또는 그룹에 할당된 정책은 기능 사용 여부를 결정할 때 전체 테넌트에게 할당된 정책보다 우선합니다. 사용자에게 기능에 대해 할당된 여러 정책(그룹의 사용자 또는 구성원으로 직접)이 있는 경우 가장 제한적인 정책이 적용됩니다.
- 일부 기능은 특정 사용자 또는 그룹이 아닌 전체 테넌트에서 적용되는 정책만 지원합니다. Get-VivaModuleFeature cmdlet을 사용하여 기능에 대해 지원되는 정책 범위를 참조할 수 있습니다.
일부 기능에는 사용자 컨트롤에 대한 옵션(사용자 옵트아웃)이 포함됩니다. 정책을 설정하려는 기능에 대해 사용자 컨트롤을 사용할 수 있는지 확인하려면 기능 설명서를 참조하세요.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
구문
Default (기본값)
Update-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
-PolicyId <String>
[-Confirm]
[-Everyone <Boolean>]
[-IsFeatureEnabled <Boolean>]
[-IsUserControlEnabled <Boolean>]
[-IsUserOptedInByDefault <Boolean>]
[-GroupIds <String[]>]
[-Name <String>]
[-ResultSize <Unlimited>]
[-UserIds <String[]>]
[-WhatIf]
[<CommonParameters>]
Description
Update-VivaModuleFeaturePolicy cmdlet을 사용하여 Viva Viva 모듈의 기능에 대한 액세스 정책을 업데이트합니다.
이 cmdlet은 지정한 정책의 특성을 업데이트합니다. 이러한 특성은 다음과 같습니다.
- 정책 이름(이름 매개 변수)입니다.
- 정책에서 기능을 사용할 수 있는지 여부(IsFeatureEnabled 매개 변수).
- 정책에서 사용자 컨트롤을 사용할 수 있는지 여부(IsUserControlEnabled 매개 변수, 기능 정책에만 적용 가능).
- 정책이 적용되는 사람(UserIds 및 GroupIds 매개 변수 또는 Everyone 매개 변수).
이러한 특성을 서로 독립적으로 업데이트할 수 있습니다. 예를 들어 Name 매개 변수를 지정하지만 IsFeatureEnabled 매개 변수를 지정하지 않으면 정책 이름이 업데이트되지만 정책에서 기능을 사용할 수 있는지 여부는 변경되지 않습니다.
중요: UserIds 및/또는 GroupIds 매개 변수 또는 Everyone 매개 변수에 대해 지정한 값은 기존 사용자 또는 그룹을 덮어씁니다 . 기존 사용자 및 그룹을 유지하려면 기존 사용자 또는 그룹 및 추가하려는 추가 사용자 또는 그룹을 지정해야 합니다. 명령에 기존 사용자 또는 그룹을 포함하지 않는 것은 정책에서 해당 특정 사용자 또는 그룹을 효과적으로 제거합니다. 자세한 내용은 예제를 참조하세요.
인증하려면 Connect-ExchangeOnline cmdlet을 사용해야 합니다.
이 cmdlet에는 .NET Framework 4.7.2 이상이 필요합니다.
현재 이 cmdlet을 실행하려면 전역 관리자 역할의 멤버이거나 기능 수준에서 할당된 역할이어야 합니다.
기능 수준에서 할당된 역할에 대한 자세한 내용은 기능 액세스 관리에 사용할 수 있는 기능을 참조하세요.
Microsoft Entra ID의 관리자 역할 권한에 대한 자세한 내용은 역할 템플릿 ID를 참조하세요.
중요
Microsoft는 최소 권한 원칙을 강력히 옹호합니다. 계정에 작업을 수행하는 데 필요한 최소 권한만 할당하면 보안 위험을 줄이고 organization 전반적인 보호를 강화하는 데 도움이 됩니다. 전역 관리자는 일반적으로 긴급 시나리오로 제한하거나 다른 역할을 사용할 수 없는 경우 매우 권한 있는 역할입니다.
예제
예 1
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b1 -Name NewPolicyName -IsFeatureEnabled $false
다음은 지정한 정책의 이름을 업데이트하고 정책에서 기능을 사용하도록 설정하지 않도록 하는 예제입니다.
예 2
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -GroupIds group1@contoso.com,group2@contoso.com
이 예제에서는 지정된 정책이 적용되는 사용자를 업데이트합니다. 이제 정책은 지정된 그룹에 만 적용되며, 적용하는 데 사용되는 정책의 사용자 및 그룹을 덮어씁니다.
예 3
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -UserIds user1@contoso.com,user2@contoso.com
이 예제에서는 지정된 정책이 적용되는 사용자를 업데이트합니다. 이제 정책은 지정된 사용자에게 만 적용되며, 적용하는 데 사용되는 정책의 사용자 및 그룹을 덮어씁니다.
예 4
Update-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -Name NewPolicyName -IsFeatureEnabled $true -GroupIds group1@contoso.com,57680382-61a5-4378-85ad-f72095d4e9c3 -UserIds user1@contoso.com
다음은 지정한 정책의 이름을 업데이트하고, 정책에서 기능을 사용하도록 설정하고, 정책이 적용되는 사용자를 업데이트하는 예제입니다. 이제 정책은 지정된 사용자 및 그룹에 만 적용되며, 적용하는 데 사용되는 사용자 및 그룹을 덮어씁니다.
예 5
Update-VivaModuleFeaturePolicy -ModuleId PeopleSkills -FeatureId ShowAISkills -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b -IsFeatureEnabled $true -IsUserControlEnabled $true -IsUserOptedInByDefault $false
다음은 Viva Skills의 ShowAISkills 기능에 대한 정책을 업데이트하는 예제입니다. 이 정책은 이전에 정책에 추가된 사용자에 대해 기능을 사용하도록 설정하고, 사용자 컨트롤을 허용하며, 기본적으로 사용자를 옵트아웃합니다(일시 사용 안 함 정책).
매개 변수
-Confirm
적용 가능: Exchange Online
Confirm 스위치는 확인 메시지를 표시할지 여부를 지정합니다. 진행하기 전에 cmdlet이 확인을 요구하는지에 따라 이 스위치가 cmdlet에 미치는 영향이 달라집니다.
- 파괴적인 cmdlet(예: Remove-* cmdlet)에는 계속하기 전에 명령을 강제로 승인하도록 하는 일시 중지 기능이 기본 제공되어 있습니다. 이러한 cmdlet의 경우 정확한 구문
-Confirm:$false를 사용하여 확인 메시지를 건너뛸 수 있습니다. - 대부분 다른 cmdlets에는 (예:, New-* and Set-* cmdlets) 중단 기능이 기본 제공되지 않습니다. 이러한 cmdlet의 경우 값 없이 스위치를 지정하면 계속하기 전에 명령을 강제로 확인하도록 하는 일시 중지가 추가됩니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
| 별칭: | cf(cf) |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Everyone
적용 가능: Exchange Online
Everyone 매개 변수는 업데이트된 정책이 organization 모든 사용자에게 적용되도록 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 정책은 모든 사용자에게 적용됩니다. 이 매개 변수에 대한 유일한 유용한 값입니다.
- $false: 이 값을 사용하지 마세요.
정책이 적용되는 사용자를 업데이트하지 않으려면 이 매개 변수를 사용하지 마세요.
GroupIds 또는 UserIds 매개 변수에는 이 매개 변수를 사용하지 마세요.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-FeatureId
적용 가능: Exchange Online
FeatureId 매개 변수는 업데이트하려는 정책의 Viva 모듈에 있는 기능을 지정합니다.
기능 액세스 제어를 지원하는 Viva 모듈의 기능에 대한 세부 정보를 보려면 Get-VivaModuleFeature cmdlet을 사용합니다. FeatureId 값은 cmdlet의 출력에 반환됩니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-GroupIds
적용 가능: Exchange Online
GroupIds 매개 변수는 업데이트된 정책이 적용되는 그룹의 이메일 주소 또는 GUID(보안 그룹 개체 ID)를 지정합니다. 메일 사용 및 비메일 사용 Microsoft Entra 그룹이 모두 지원됩니다. Update
정책이 적용되는 사용자를 업데이트하지 않으려면 이 매개 변수를 사용하지 마세요.
이 매개 변수 또는 UserIds 매개 변수에 대해 지정한 값은 기존 그룹을 대체합니다. 기존 그룹을 유지하려면 지정한 새 사용자 또는 그룹과 함께 해당 그룹을 포함합니다.
최대 20명의 총 사용자 또는 그룹(사용자 20명, 그룹 없음, 사용자 10명 및 그룹 10개 등)을 지정할 수 있습니다.
업데이트된 정책이 organization 모든 사용자에게 적용되도록 하려면 값이 $true Everyone 매개 변수를 사용합니다.
참고: 모듈의 v3.5.1-Preview2 이상에서 이 매개 변수는 GUID(보안 그룹 개체 ID)를 지원합니다. 이전 버전의 모듈에서는 이 매개 변수에 대한 이메일 주소만 허용합니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IsFeatureEnabled
적용 가능: Exchange Online
IsFeatureEnabled 매개 변수는 업데이트된 정책에서 기능을 사용할 수 있는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 이 기능은 정책에 의해 활성화됩니다.
- $false: 이 기능은 정책에서 사용하도록 설정되지 않았습니다.
정책에서 기능을 사용하도록 설정했는지 여부를 업데이트하지 않으려면 이 매개 변수를 사용하지 마세요.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IsUserControlEnabled
적용 가능: Exchange Online
참고: 이 매개 변수는 모듈 버전 3.3.0-Preview1 이상에서 사용할 수 있습니다. 이 기능이 옵트아웃에 대한 사용자 컨트롤을 지원하는 경우 정책을 만들 때 IsUserControlEnabled 매개 변수를 설정해야 합니다. 그렇지 않으면 정책에 대한 사용자 컨트롤은 기능에 대한 기본 상태를 사용합니다.
IsUserControlEnabled 매개 변수는 정책에서 사용자 컨트롤을 사용하도록 설정할지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 사용자 컨트롤은 정책에 의해 활성화됩니다. 사용자는 기능을 옵트아웃할 수 있습니다.
- $false: 사용자 컨트롤은 정책에 의해 사용하도록 설정되지 않습니다. 사용자는 이 기능을 선택할 수 없습니다.
관리자가 정책에 따라 사용자 컨트롤을 사용하도록 설정하고 사용하지 않도록 설정할 수 있는 기능만 이 매개 변수를 사용할 수 있습니다. 이 기능이 사용자 컨트롤을 전환하는 관리자를 지원하지 않는 경우 기본값이 적용됩니다. 자세한 내용은 기능 설명서를 참조하세요.
정책에서 사용자 컨트롤을 사용할 수 있는지 여부를 업데이트하지 않으려면 이 매개 변수를 사용하지 마세요.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IsUserOptedInByDefault
적용 가능: Exchange Online
참고: 이 매개 변수는 모듈 버전 3.8.0-Preview2 이상에서 사용할 수 있습니다.
IsUserOptedInByDefault 매개 변수는 사용자가 기본적으로 정책에 의해 옵트인되는지 여부를 지정합니다. 유효한 값은 다음과 같습니다.
- $true: 사용자가 기본 설정을 설정하지 않은 경우 기본적으로 사용자는 정책에 의해 옵트인됩니다.
- $false: 사용자가 기본 설정을 설정하지 않은 경우 기본적으로 사용자는 정책에 의해 옵트아웃됩니다.
이 매개 변수는 선택 사항이며 기능 메타데이터에 설정된 기본 사용자 옵트인 값을 재정의하는 데 사용할 수 있습니다.
이 매개 변수는 IsUserControlEnabled 매개 변수가 $true 설정된 경우에만 설정할 수 있습니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| 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 |
-Name
적용 가능: Exchange Online
Name 매개 변수는 정책의 업데이트된 이름을 지정합니다. 최대 길이는 256자입니다. 값에 공백이 포함되어 있으면 값을 큰따옴표(")로 묶습니다.
유효한 문자는 영어 문자, 숫자, 쉼표, 마침표 및 공백입니다.
정책 이름을 업데이트하지 않으려면 이 매개 변수를 사용하지 마세요.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-PolicyId
적용 가능: Exchange Online
PolicyId 매개 변수는 업데이트하려는 Viva 모듈의 기능에 대한 정책을 지정합니다.
Viva 모듈에서 기능에 대한 정책에 대한 세부 정보를 보려면 Get-VivaModuleFeaturePolicy cmdlet을 사용합니다. PolicyId 값은 cmdlet의 출력에 반환됩니다.
매개 변수 속성
| 형식: | 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 |
-UserIds
적용 가능: Exchange Online
UserIds 매개 변수는 업데이트된 정책이 적용되는 사용자의 UPN(사용자 계정 이름)을 지정합니다. Update
정책이 적용되는 사용자를 업데이트하지 않으려면 이 매개 변수를 사용하지 마세요.
이 매개 변수 또는 GroupIds 매개 변수에 대해 지정한 값은 기존 사용자를 대체합니다. 기존 사용자를 유지하려면 지정한 새 사용자 또는 그룹과 함께 포함합니다.
최대 20명의 총 사용자 또는 그룹(사용자 20명, 그룹 없음, 사용자 10명 및 그룹 10개 등)을 지정할 수 있습니다.
업데이트된 정책이 organization 모든 사용자에게 적용되도록 하려면 값이 $true Everyone 매개 변수를 사용합니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-WhatIf
적용 가능: Exchange Online
Whatif 스위치는 해당 명령의 동작을 시뮬레이션합니다. 이 스위치를 사용하면 변경 내용을 실제로 적용하지 않고 발생할 변경 내용을 확인할 수 있습니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| 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를 참조하세요.