Skip to content

Commit 5b845ba

Browse files
Update Remove-VivaModuleFeaturePolicy.md
1 parent 0b55ee9 commit 5b845ba

File tree

1 file changed

+24
-7
lines changed

1 file changed

+24
-7
lines changed

exchange/exchange-ps/exchange/Remove-VivaModuleFeaturePolicy.md

Lines changed: 24 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -15,40 +15,46 @@ ms.reviewer:
1515
## SYNOPSIS
1616
This cmdlet is available only in the Exchange Online PowerShell module v3.2.0 or later. For more information, see [About the Exchange Online PowerShell module](https://aka.ms/exov3-module).
1717

18-
Use the Remove-VivaModuleFeaturePolicy cmdlet to delete an access policy for a feature in a Viva module. Once you delete a policy, the policy is permanently deleted. You cannot undo the deletion.
18+
**Note**: While we are adding support for category policies in the Exchange Online PowerShell module v3.5.0-Preview1 or later, we have not yet released any categories in Viva. We will update when there are categories available.
19+
20+
Use the Remove-VivaModuleFeaturePolicy cmdlet to delete an access policy for a feature in a Viva module or a category in Viva. Once you delete a policy, the policy is permanently deleted. You cannot undo the deletion.
1921

2022
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
2123

2224
## SYNTAX
2325

2426
### FeaturePolicy
2527
```
26-
Remove-VivaModuleFeaturePolicy -ModuleId <String> -FeatureId <String> -PolicyId <String>
28+
Remove-VivaModuleFeaturePolicy -FeatureId <String> -ModuleId <String> -PolicyId <String>
2729
[-Confirm]
28-
[-ProgressAction <ActionPreference>]
2930
[-ResultSize <Unlimited>]
3031
[-WhatIf]
3132
[<CommonParameters>]
3233
```
3334

3435
### CategoryPolicy
36+
**Note**: While we are adding support for category policies in the Exchange Online PowerShell module v3.5.0-Preview1 or later, we have not yet released any categories in Viva. We will update when there are categories available.
37+
3538
```
3639
Remove-VivaModuleFeaturePolicy -CategoryId <String> -PolicyId <String>
3740
[-Confirm]
38-
[-ProgressAction <ActionPreference>]
3941
[-ResultSize <Unlimited>]
4042
[-WhatIf]
4143
[<CommonParameters>]
4244
```
4345

4446
## DESCRIPTION
45-
Use the Remove-VivaModuleFeaturePolicy cmdlet to delete an access policy for a feature in a Viva module.
47+
Use the Remove-VivaModuleFeaturePolicy cmdlet to delete an access policy for a feature in a Viva module or a category in Viva.
48+
49+
**Note**: While we are adding support for category policies in the Exchange Online PowerShell module v3.5.0-Preview1 or later, we have not yet released any categories in Viva. We will update when there are categories available.
4650

4751
You need to use the Connect-ExchangeOnline cmdlet to authenticate.
4852

4953
This cmdlet requires the .NET Framework 4.7.2 or later.
5054

51-
Currently, you need to be a member of the Global administrators role to run this cmdlet.
55+
Currently, you need to be a member of the Global administrators role or the roles that have been permissioned at the feature level to run this cmdlet.
56+
57+
To learn more about permissioned roles at the feature level, see [Features Available for Feature Access Management](https://learn.microsoft.com/en-us/viva/feature-access-management#features-available-for-feature-access-management).
5258

5359
To learn more about administrator role permissions in Microsoft Entra ID, see [Role template IDs](https://learn.microsoft.com/entra/identity/role-based-access-control/permissions-reference#role-template-ids).
5460

@@ -61,10 +67,21 @@ Remove-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Pol
6167

6268
This example deletes the specified policy for the Reflection feature in Viva Insights.
6369

70+
### Example 2
71+
```powershell
72+
Remove-VivaModuleFeaturePolicy -CategoryId <category_id> -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da032w
73+
```
74+
75+
This example deletes the specified policy for the <category_id> category in Viva.
76+
6477
## PARAMETERS
6578

6679
### -CategoryId
67-
{{ Fill CategoryId Description }}
80+
**Note**: While we are adding support for category policies in the Exchange Online PowerShell module v3.5.0-Preview1 or later, we have not yet released any categories in Viva. We will update when there are categories available.
81+
82+
The CategoryId parameter specifies the category that you want to remove the policy from.
83+
84+
To view details about the categories that support feature access controls, use the Get-VivaFeatureCategory cmdlet. The CategoryId value is returned in the output of the cmdlet.
6885

6986
```yaml
7087
Type: String

0 commit comments

Comments
 (0)