Merge pull request #11676 from YanyuZhongZyy/patch-9

Update Get-VivaModuleFeaturePolicy.md for VFAM feature category preview release

Author: chrisda

exchange/exchange-ps/exchange/Get-VivaModuleFeaturePolicy.md

@@ -15,17 +15,18 @@ ms.reviewer:
 ## SYNOPSIS
 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).
 
-Use the Get-VivaModuleFeaturePolicy cmdlet to view the access policies for a specified feature in a Viva module. Policies are used to restrict or grant access to the specified feature for specific users, groups, or the entire tenant. This cmdlet provides details about the policies, including the policy's identifier, name, and creation date.
+**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.
+
+Use the Get-VivaModuleFeaturePolicy cmdlet to view the access policies for a specified feature in a Viva module or category in Viva. Policies are used to restrict or grant access to the specified feature or category for specific users, groups, or the entire tenant. This cmdlet provides details about the policies, including the policy's identifier, name, and creation date.
 
 For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
 
 ## SYNTAX
 
 ### FeaturePolicy
 ```
-Get-VivaModuleFeaturePolicy -ModuleId <String> -FeatureId <String>
+Get-VivaModuleFeaturePolicy -FeatureId <String> -ModuleId <String>
  [[-PolicyId] <String>]
- [-ProgressAction <ActionPreference>]
  [-ResultSize <Unlimited>]
  [<CommonParameters>]
 ```
@@ -34,21 +35,24 @@ Get-VivaModuleFeaturePolicy -ModuleId <String> -FeatureId <String>
 ```
 Get-VivaModuleFeaturePolicy -CategoryId <String>
  [[-PolicyId] <String>]
- [-ProgressAction <ActionPreference>]
  [-ResultSize <Unlimited>]
  [<CommonParameters>]
 ```
 
 ## DESCRIPTION
-Use the Get-VivaModuleFeaturePolicy cmdlet to view the access policies for a specified feature in a Viva module.
+Use the Get-VivaModuleFeaturePolicy cmdlet to view the access policies for a specified feature in a Viva module or a category in Viva.
+
+Support for categories is available in version 3.5.0-Preview1 or later of the module.
 
-You can view all policies for a specified feature in a Viva module. To view a specific policy, you can include the PolicyId parameter.
+You can view all policies for a specified feature in a Viva module or a category in Viva. To view a specific policy, you can include the PolicyId parameter.
 
 You need to use the Connect-ExchangeOnline cmdlet to authenticate.
 
 This cmdlet requires the .NET Framework 4.7.2 or later.
 
-Currently, you need to be a member of the Global administrators role to run this cmdlet.
+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.
+
+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).
 
 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).
 
@@ -68,12 +72,30 @@ Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -Policy
 
 This example returns details about a specific policy added for the Reflection feature in Viva Insights.
 
+### Example 3
+```powershell
+Get-VivaModuleFeaturePolicy -CategoryId <category_id>
+```
+
+This example returns details about all the policies added for the `<category_id>` category in Viva.
+
+### Example 4
+```powershell
+Get-VivaModuleFeaturePolicy -CategoryId <category_id> -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
+```
+
+This example returns details about a specific policy added for the `<category_id>` category in Viva.
+
 ## PARAMETERS
 
 ### -CategoryId
-**Note**: This parameter is available only in the Exchange Online PowerShell module v3.5.0-Preview??? or later.
+This parameter is available in version 3.5.0-Preview1 or later of the module.
+
+**Note**: Currently, no categories are available in Viva. We'll update the documentation when categories are available.
+
+The CategoryId parameter specifies the category that you want to view the policies for.
 
-{{ Fill CategoryId Description }}
+To view details about the categories in Viva that support feature access controls, refer to the Get-VivaFeatureCategory cmdlet. The details provided by the Get-VivaFeatureCategory cmdlet include the category identifier.
 
 ```yaml
 Type: String
@@ -123,9 +145,9 @@ Accept wildcard characters: False
 ```
 
 ### -PolicyId
-The PolicyId parameter specifies the specific policy for the feature in the Viva module that you want to view.
+The PolicyId parameter specifies the specific policy for the feature in the Viva module or the category that you want to view.
 
-To view details about all policies for a feature in a Viva module, run this cmdlet without the PolicyId parameter. These details include the identifiers of all the policies for a feature in a Viva module.
+To view details about all policies for a feature in a Viva module or a category, run this cmdlet without the PolicyId parameter. These details include the identifiers of all the policies for a feature in a Viva module or a category.
 
 ```yaml
 Type: String
@@ -140,24 +162,6 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
-### -ProgressAction
-**Note**: This parameter is available only in the Exchange Online PowerShell module v3.5.0-Preview??? or later.
-
-{{ Fill ProgressAction Description }}
-
-```yaml
-Type: ActionPreference
-Parameter Sets: (All)
-Aliases: proga
-Applicable: Exchange Online
-
-Required: False
-Position: Named
-Default value: None
-Accept pipeline input: False
-Accept wildcard characters: False
-```
-
 ### -ResultSize
 This parameter is reserved for internal Microsoft use.