Get-SPORestrictedAccessForSitesInsights
This cmdlet enables the administrator to check status of all active and available reports about insights on sites protected and access denials by restricted access control.
Syntax
Get-SPORestrictedAccessForSitesInsights
-ActionsBlockedByPolicy
[-ReportId <Guid>]
[-Content <ContentType>]
[-Action <ActionType>] Description
If this cmdlet is executed with -RACProtectedSites as parameter, it displays the status of all the active and completed reports.
If this cmdlet is executed with -RACProtectedSites -ReportId as parameter, top 100 sites with the highest page views that are protected by restricted access control will be displayed.
If this cmdlet is executed with -RACProtectedSites -ReportId -InsightsSummary as parameter, the count of sites protected with restricted access control compared to total number of sites will be displayed.
If this cmdlet is executed with -ActionsBlockedByPolicy as parameter, it displays the status of all active and completed reports.
If this cmdlet is executed with -ActionsBlockedByPolicy -ReportId -Content TopSites as parameter, top 100 sites with the highest access denials by restricted access control will be displayed.
If this cmdlet is executed with -ActionsBlockedByPolicy -ReportId -Content TopUsers as parameter, top 10 users with the highest access denials by restricted access control will be displayed.
If this cmdlet is executed with -ActionsBlockedByPolicy -ReportId -Content AllDenials as parameter, most recent 100 access denials by restricted access control in the last 28 days will be displayed.
If this cmdlet is executed with -ActionsBlockedByPolicy -ReportId -Content SiteDistribution as parameter, distribution of access denials by restricted access control on different site types will be displayed.
Note
All reports adhere to any retention timeline as per Data Access Governance.
Examples
-----------------------EXAMPLE 1-----------------------------
Get-SPORestrictedAccessForSitesInsights -RACProtectedSitesExample 1 enables administrator to view the status of all active and completed reports on list of sites protected with restricted access control.
-----------------------EXAMPLE 2-----------------------------
Get-SPORestrictedAccessForSitesInsights -RACProtectedSites -ReportId 9d946216-afe7-49f5-8267-7b662435c70bExample 2 enables administrator to view the report containing list of sites protected with restricted access control with ReportId: 9d946216-afe7-49f5-8267-7b662435c70b
-----------------------EXAMPLE 3-----------------------------
Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy -ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Content TopSitesExample 3 enables administrator to view the report containing top sites with access denials due to restricted access control with ReportId: 9d946216-afe7-49f5-8267-7b662435c70b.
Parameters
-Action
It is an optional parameter, and it specifies whether to view or download a specific report.
| Type: | ActionType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-ActionsBlockedByPolicy
It is an optional parameter, and it specifies the type of report to be viewed or downloaded.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-Content
It is an optional parameter, and it specifies the subtype of the report to be viewed or downloaded.
| Type: | ContentType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-InsightsSummary
It is an optional parameter, and it specifies the subtype of the report to be viewed or downloaded.
| Type: | Bool |
| Position: | Named |
| Default value: | True |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-RACProtectedSites
It is an optional parameter, and it specifies the type of report to be viewed or downloaded.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |
-ReportId
It is an optional parameter, and it specifies the unique Id of the report to be viewed or downloaded.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Online |