Get-VivaModuleFeaturePolicy
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.
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.
For information about the parameter sets in the Syntax section below, see Exchange cmdlet syntax.
Syntax
Get-VivaModuleFeaturePolicy
-FeatureId <String>
-ModuleId <String>
[[-PolicyId] <String>]
[-ResultSize <Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32]>]
[<CommonParameters>]
Description
Use the Get-VivaModuleFeaturePolicy cmdlet to view the access policies for a specified feature in a Viva 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 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.
To learn more about administrator role permissions in Microsoft Entra ID, see Role template IDs.
Examples
Example 1
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection
This example returns details about all the policies added for the Reflection feature in Viva Insights.
Example 2
Get-VivaModuleFeaturePolicy -ModuleId VivaInsights -FeatureId Reflection -PolicyId 3db38dfa-02a3-4039-b33a-42b0b3da029b
This example returns details about a specific policy added for the Reflection feature in Viva Insights.
Parameters
-FeatureId
The FeatureId parameter specifies the feature in the Viva module that you want to view the policies for.
To view details about the features in a Viva module that support feature access controls, refer to the Get-VivaModuleFeature cmdlet. The details provided by the Get-VivaModuleFeature cmdlet include the feature identifier.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ModuleId
The ModuleId parameter specifies the Viva module of the feature policies that you want to view.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-PolicyId
The PolicyId parameter specifies the specific policy for the feature in the Viva module 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.
Type: | String |
Position: | Positional |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
-ResultSize
This parameter is reserved for internal Microsoft use.
Type: | Microsoft.Exchange.Management.RestApiClient.Unlimited`1[System.UInt32] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online |
Related Links
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för