Skip to content

Commit 029c931

Browse files
authored
Merge pull request #11677 from YanyuZhongZyy/patch-10
Update Remove-VivaModuleFeaturePolicy.md for VFAM feature category preview release
2 parents dbb4a6c + b95e24b commit 029c931

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,17 +15,18 @@ 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**: Support for categories is available in version 3.5.0-Preview1 or later of the module, but no categories are currently available in Viva. We'll update the documentation when categories are 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>]
@@ -35,20 +36,23 @@ Remove-VivaModuleFeaturePolicy -ModuleId <String> -FeatureId <String> -PolicyId
3536
```
3637
Remove-VivaModuleFeaturePolicy -CategoryId <String> -PolicyId <String>
3738
[-Confirm]
38-
[-ProgressAction <ActionPreference>]
3939
[-ResultSize <Unlimited>]
4040
[-WhatIf]
4141
[<CommonParameters>]
4242
```
4343

4444
## DESCRIPTION
45-
Use the Remove-VivaModuleFeaturePolicy cmdlet to delete an access policy for a feature in a Viva module.
45+
Use the Remove-VivaModuleFeaturePolicy cmdlet to delete an access policy for a feature in a Viva module or a category in Viva.
46+
47+
Support for categories is available in version 3.5.0-Preview1 or later of the module.
4648

4749
You need to use the Connect-ExchangeOnline cmdlet to authenticate.
4850

4951
This cmdlet requires the .NET Framework 4.7.2 or later.
5052

51-
Currently, you need to be a member of the Global administrators role to run this cmdlet.
53+
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.
54+
55+
To learn more about permissioned roles at the feature level, see [Features Available for Feature Access Management](https://learn.microsoft.com/viva/feature-access-management#features-available-for-feature-access-management).
5256

5357
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).
5458

@@ -61,10 +65,23 @@ Remove-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Pol
6165

6266
This example deletes the specified policy for the Reflection feature in Viva Insights.
6367

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

6677
### -CategoryId
67-
{{ Fill CategoryId Description }}
78+
This parameter is available in version 3.5.0-Preview1 or later of the module.
79+
80+
**Note**: Currently, no categories are available in Viva. We'll update the documentation when categories are 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)