From 9af308ab64e5d95114941449dc29c82b5be61b80 Mon Sep 17 00:00:00 2001 From: bowerke <142449097+bowerke@users.noreply.github.com> Date: Mon, 5 May 2025 11:15:52 -0400 Subject: [PATCH 1/2] Update Get-VivaModuleFeaturePolicy.md Updating Get-VivaModuleFeaturePolicy to support FeaturePolicyWithMembers added syntax block, examples, and additional information in description --- .../exchange/Get-VivaModuleFeaturePolicy.md | 78 ++++++++++++++++++- 1 file changed, 74 insertions(+), 4 deletions(-) diff --git a/exchange/exchange-ps/exchange/Get-VivaModuleFeaturePolicy.md b/exchange/exchange-ps/exchange/Get-VivaModuleFeaturePolicy.md index f72e51b51b..a5e4058c10 100644 --- a/exchange/exchange-ps/exchange/Get-VivaModuleFeaturePolicy.md +++ b/exchange/exchange-ps/exchange/Get-VivaModuleFeaturePolicy.md @@ -15,11 +15,13 @@ 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 in Viva. 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. +Use the Get-VivaModuleFeaturePolicy cmdlet to view the access policies for a specified feature in a Viva module in Viva. 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. The cmdlet can filter policies based on MemberIds, allowing administrators to view policies specific to certain users or groups. 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 -FeatureId -ModuleId [[-PolicyId] ] @@ -27,11 +29,22 @@ Get-VivaModuleFeaturePolicy -FeatureId -ModuleId [] ``` +### FeaturePolicyWithMembers +``` +Get-VivaModuleFeaturePolicy -ModuleId + [[-FeatureId] ] + [[-MemberIds] ] + [-ResultSize ] + [] +``` + ## DESCRIPTION Use the Get-VivaModuleFeaturePolicy cmdlet to view the access policies for a specified feature in a Viva module in Viva. You can view all policies for a specified feature in a Viva module in Viva. To view a specific policy, you can include the PolicyId parameter. +The cmdlet can filter policies based on MemberIds, allowing administrators to view policies specific to certain users or groups. + You need to use the Connect-ExchangeOnline cmdlet to authenticate. This cmdlet requires the .NET Framework 4.7.2 or later. @@ -61,6 +74,20 @@ 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 -ModuleId VivaInsights -FeatureId Reflection -MemberIds user1@contoso.com +``` + +This example returns details about the policies for the Reflection feature in Viva Insights that apply to the user with the email user1@contoso.com. + +### Example 4 +```powershell +Get-VivaModuleFeaturePolicy -ModuleId * -FeatureId * -MemberIds user1@contoso.com,group1@contoso.com +``` + +This example returns details about the policies for all features across all Viva modules that apply to the user with the email user1@contoso.com and the group with the email group1@contoso.com. + ## PARAMETERS ### -FeatureId @@ -70,7 +97,7 @@ To view details about the features in a Viva module that support feature access ```yaml Type: String -Parameter Sets: (All) +Parameter Sets: FeaturePolicy Aliases: Applicable: Exchange Online @@ -80,13 +107,25 @@ Default value: None Accept pipeline input: False Accept wildcard characters: False ``` +```yaml +Type: String +Parameter Sets: FeaturePolicyWithMembers +Aliases: +Applicable: Exchange Online + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: True +``` ### -ModuleId The ModuleId parameter specifies the Viva module of the feature policies that you want to view. ```yaml Type: String -Parameter Sets: (All) +Parameter Sets: FeaturePolicy Aliases: Applicable: Exchange Online @@ -96,6 +135,18 @@ Default value: None Accept pipeline input: False Accept wildcard characters: False ``` +```yaml +Type: String +Parameter Sets: FeaturePolicyWithMembers +Aliases: +Applicable: Exchange Online + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: True +``` ### -PolicyId The PolicyId parameter specifies the specific policy for the feature in the Viva module that you want to view. @@ -104,7 +155,7 @@ To view details about all policies for a feature in a Viva module, run this cmdl ```yaml Type: String -Parameter Sets: (All) +Parameter Sets: FeaturePolicy Aliases: Applicable: Exchange Online @@ -115,6 +166,25 @@ Accept pipeline input: False Accept wildcard characters: False ``` + +### -MemberIds +The MemberIds parameter specifies the specific users or groups for which you want to view the policies for the feature in the Viva module. + +You can provide up to 3 member IDs. The * character can be used to specify all modules or features. + +```yaml +Type: String[] +Parameter Sets: FeaturePolicyWithMembers +Aliases: +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. From dab72156fc77f7bd50e0bc715ea205d350de7aae Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Mon, 5 May 2025 08:34:15 -0700 Subject: [PATCH 2/2] Update Get-VivaModuleFeaturePolicy.md --- .../exchange/Get-VivaModuleFeaturePolicy.md | 29 +++++-------------- 1 file changed, 7 insertions(+), 22 deletions(-) diff --git a/exchange/exchange-ps/exchange/Get-VivaModuleFeaturePolicy.md b/exchange/exchange-ps/exchange/Get-VivaModuleFeaturePolicy.md index a5e4058c10..1e4a57e8a1 100644 --- a/exchange/exchange-ps/exchange/Get-VivaModuleFeaturePolicy.md +++ b/exchange/exchange-ps/exchange/Get-VivaModuleFeaturePolicy.md @@ -15,7 +15,7 @@ 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 in Viva. 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. The cmdlet can filter policies based on MemberIds, allowing administrators to view policies specific to certain users or groups. +Use the Get-VivaModuleFeaturePolicy cmdlet to view the access policies for a specified feature in a Viva module in Viva. 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. The cmdlet can filter policies based on MemberIds, allowing admins to view policies specific to certain users or groups. For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax). @@ -23,17 +23,14 @@ For information about the parameter sets in the Syntax section below, see [Excha ### FeaturePolicy ``` -Get-VivaModuleFeaturePolicy -FeatureId -ModuleId - [[-PolicyId] ] +Get-VivaModuleFeaturePolicy -FeatureId -ModuleId [[-PolicyId] ] [-ResultSize ] [] ``` ### FeaturePolicyWithMembers ``` -Get-VivaModuleFeaturePolicy -ModuleId - [[-FeatureId] ] - [[-MemberIds] ] +Get-VivaModuleFeaturePolicy -ModuleId [[-FeatureId] ] [[-MemberIds] ] [-ResultSize ] [] ``` @@ -43,7 +40,7 @@ Use the Get-VivaModuleFeaturePolicy cmdlet to view the access policies for a spe You can view all policies for a specified feature in a Viva module in Viva. To view a specific policy, you can include the PolicyId parameter. -The cmdlet can filter policies based on MemberIds, allowing administrators to view policies specific to certain users or groups. +The cmdlet can filter policies based on MemberIds, allowing admins to view policies specific to certain users or groups. You need to use the Connect-ExchangeOnline cmdlet to authenticate. @@ -107,6 +104,7 @@ Default value: None Accept pipeline input: False Accept wildcard characters: False ``` + ```yaml Type: String Parameter Sets: FeaturePolicyWithMembers @@ -125,7 +123,7 @@ The ModuleId parameter specifies the Viva module of the feature policies that yo ```yaml Type: String -Parameter Sets: FeaturePolicy +Parameter Sets: (All) Aliases: Applicable: Exchange Online @@ -135,18 +133,6 @@ Default value: None Accept pipeline input: False Accept wildcard characters: False ``` -```yaml -Type: String -Parameter Sets: FeaturePolicyWithMembers -Aliases: -Applicable: Exchange Online - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: True -``` ### -PolicyId The PolicyId parameter specifies the specific policy for the feature in the Viva module that you want to view. @@ -166,11 +152,10 @@ Accept pipeline input: False Accept wildcard characters: False ``` - ### -MemberIds The MemberIds parameter specifies the specific users or groups for which you want to view the policies for the feature in the Viva module. -You can provide up to 3 member IDs. The * character can be used to specify all modules or features. +You can provide up to three member IDs. Use the \* character to specify all modules or features. ```yaml Type: String[]