Skip to content

Commit 38de793

Browse files
committed
Review comments addressal
1 parent 72e4b64 commit 38de793

File tree

2 files changed

+22
-83
lines changed

2 files changed

+22
-83
lines changed

sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedAccessForSitesInsights.md

Lines changed: 16 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ manager:
1515

1616
## SYNOPSIS
1717

18-
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 policy when no report ID is present and to view or download the report if report ID is present.
18+
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.
1919

2020
## SYNTAX
2121

@@ -29,76 +29,21 @@ Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy [-ReportId <Guid
2929

3030
## DESCRIPTION
3131

32-
If this cmdlet is executed with `-RACProtectedSites` as parameter, it displays the status of all active and completed reports with the following properties:
32+
If this cmdlet is executed with `-RACProtectedSites` as parameter, it displays the status of all the active and completed reports.
3333

34-
| Property | Description |
35-
|:---------------------|:------------------------------------------------------------|
36-
| Id | The unique Id of the report. |
37-
| CreatedDateTimeInUtc | The date and time the report creation was triggered in UTC. |
38-
| Status | The status of the report. |
34+
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.
3935

40-
If this cmdlet is executed with `-RACProtectedSites` `-ReportId` as parameter, top 100 sites with highest page views that are protected by Restrcited access control will be displayed with the following properties:
36+
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.
4137

42-
| Property | Description |
43-
|:-----------------------------|:--------------------------------------------------------------|
44-
| SiteName | The name of the SharePoint site. |
45-
| SiteType | The type of the SharePoint site. |
46-
| SiteURL | The URL of the SharePoint site. |
47-
| SiteSensitivity | The sensitivity label of the SharePoint site. |
48-
| PrimaryAdmin | Primary admin of the SharePoint Site |
49-
| BlockDownloadPolicy | Boolean status of Block download policy on the site. |
50-
| ConditionalAccessPolicy | Authentication context set for the Conditional access policy |
51-
| RestrictedAccessControlGroups| Entra Groups configured during policy configuration |
38+
If this cmdlet is executed with `-ActionsBlockedByPolicy` as parameter, it displays the status of all active and completed reports.
39+
40+
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.
5241

53-
If this cmdlet is executed with `-RACProtectedSites` `-ReportId` `-InsightsSummary` as parameter, count of sites protected with restricted access control compared to total number of sites will be displayed.
42+
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.
5443

55-
If this cmdlet is executed with `-ActionsBlockedByPolicy` as parameter, it displays the status of all active and completed reports with the following properties:
44+
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.
5645

57-
| Property | Description |
58-
|:---------------------|:------------------------------------------------------------|
59-
| Id | The unique Id of the report. |
60-
| CreatedDateTimeInUtc | The date and time the report creation was triggered in UTC. |
61-
| Status | The status of the report. |
62-
63-
If this cmdlet is executed with `-ActionsBlockedByPolicy` `-ReportId` `-Content TopSites` as parameter, top 100 sites with highest access denials by Restricted access control will be displayed with the following properties:
64-
65-
| Property | Description |
66-
|:-----------------------------|:--------------------------------------------------------------|
67-
| SiteName | The name of the SharePoint site. |
68-
| SiteURL | The URL of the SharePoint site. |
69-
| SiteSensitivity | The sensitivity label of the SharePoint site. |
70-
| SiteType | The type of the SharePoint site. |
71-
| AccessDenialsCount | Total number of access denials on the site. |
72-
| UniqueUsersBlocked | Count of Unique users denied access on the site. |
73-
74-
If this cmdlet is executed with `-ActionsBlockedByPolicy` `-ReportId` `-Content TopUsers` as parameter, top 10 users with highest access denials by Restricted access control will be displayed with the following properties:
75-
76-
| Property | Description |
77-
|:-----------------------------|:--------------------------------------------------------------|
78-
| UserEmail | Email id of the blocked user. |
79-
| AccessDenialsCount | Total number of access denials faced by the user. |
80-
81-
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 with the following properties:
82-
83-
| Property | Description |
84-
|:-----------------------------|:--------------------------------------------------------------|
85-
| AccessDenialDateTimeInUtc | The timestamp of access denial. |
86-
| SiteName | The name of the SharePoint site. |
87-
| SiteURL | The URL of the SharePoint site. |
88-
| SiteType | The type of the SharePoint site. |
89-
| SiteOwnerName | Primary Owner of the SharePoint site. |
90-
| UserEmail | Email ID of the denied user. |
91-
| RestrictedAccessControlGroups| Entra Groups configured during policy configuration |
92-
| SiteSensitivity | The sensitivity label of the SharePoint site. |
93-
94-
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 with the following properties:
95-
96-
| Property | Description |
97-
|:-----------------------------|:--------------------------------------------------------------|
98-
| SiteType | The type of the SharePoint site. |
99-
| AccessDenialsCount | Total number of access denials on the site type. |
100-
| UniqueUsersBlockedCount | Count of Unique users denied access on the site type. |
101-
| SiteTypePercentage | Relative percentage of access denials by the site type. |
46+
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.
10247

10348
> [!NOTE]
10449
> All reports adhere to any retention timeline as per [Data Access Governance](/sharepoint/data-access-governance-reports).
@@ -111,29 +56,29 @@ If this cmdlet is executed with `-ActionsBlockedByPolicy` `-ReportId` `-Content
11156
Get-SPORestrictedAccessForSitesInsights -RACProtectedSites
11257
```
11358

114-
Example 1 enables administrator to view the status of all active and completed reports on list of sites protected with restricted access control policy.
59+
Example 1 enables administrator to view the status of all active and completed reports on list of sites protected with restricted access control.
11560

11661
### -----------------------EXAMPLE 2-----------------------------
11762

11863
```powershell
11964
Get-SPORestrictedAccessForSitesInsights –RACProtectedSites -ReportId 9d946216-afe7-49f5-8267-7b662435c70b
12065
```
12166

122-
Example 2 enables administrator to view the list of sites protected with restricted access control policy report with ReportId: `9d946216-afe7-49f5-8267-7b662435c70b`
67+
Example 2 enables administrator to view the report containing list of sites protected with restricted access control with ReportId: `9d946216-afe7-49f5-8267-7b662435c70b`
12368

12469
### -----------------------EXAMPLE 3-----------------------------
12570

12671
```powershell
12772
Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy -ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Content TopSites
12873
```
12974

130-
Example 3 enables administrator to view the top sites with access denials due to restricted access control policy report of ReportId: `9d946216-afe7-49f5-8267-7b662435c70b`.
75+
Example 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`.
13176

13277
## PARAMETERS
13378

13479
### -RACProtectedSites
13580

136-
It is an optional parameter, and it specifies the type of the report to be viewed or downloaded.
81+
It is an optional parameter, and it specifies the type of report to be viewed or downloaded.
13782

13883
```yaml
13984
Type: SwitchParameter
@@ -150,7 +95,7 @@ Accept wildcard characters: False
15095
15196
### -ActionsBlockedByPolicy
15297
153-
It is an optional parameter, and it specifies the type of the report to be viewed or downloaded.
98+
It is an optional parameter, and it specifies the type of report to be viewed or downloaded.
15499
155100
```yaml
156101
Type: SwitchParameter
@@ -201,7 +146,7 @@ Accept wildcard characters: False
201146
202147
### -Content
203148
204-
It is an optional parameter, and it specifies the sub-type of the report to be viewed or downloaded.
149+
It is an optional parameter, and it specifies the subtype of the report to be viewed or downloaded.
205150
206151
```yaml
207152
Type: ContentType

sharepoint/sharepoint-ps/sharepoint-online/Start-SPORestrictedAccessForSitesInsights.md

Lines changed: 6 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ manager:
1515

1616
## SYNOPSIS
1717

18-
This cmdlet enables administrator to trigger the build of a new Restricted Access Control insights report for the data from last 28 days.
18+
This cmdlet enables administrator to trigger the build of a new restricted access control insights report for the data from last 28 days.
1919

2020
## SYNTAX
2121

@@ -29,13 +29,7 @@ Start-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy [-Force <Switc
2929

3030
## DESCRIPTION
3131

32-
After this cmdlet is executed, the Restricted Access Control insights report generation request for the requested sub type gets queued in the pipeline and the below metadata is displayed with the following properties:
33-
34-
| Property | Description |
35-
|:---------------------|:------------------------------------------------------------|
36-
| Id | The unique Id of the report. |
37-
| CreatedDateTimeInUtc | The date and time the report creation was triggered in UTC. |
38-
| Status | The status of the report. |
32+
After this cmdlet is executed, the restricted access control insights report generation request is initiated for the requested report subtype. |
3933

4034
## EXAMPLES
4135

@@ -45,21 +39,21 @@ After this cmdlet is executed, the Restricted Access Control insights report gen
4539
Start-SPORestrictedAccessForSitesInsights -RACProtectedSites
4640
```
4741

48-
Example 1 generates the Restricted access control policy report which contains insights about the list of sites protected with the policy.
42+
Example 1 generates the restricted access control report which contains insights about the list of sites protected with the policy.
4943

5044
### -----------------------EXAMPLE 2-----------------------------
5145

5246
```powershell
5347
Start-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy
5448
```
5549

56-
Example 2 generates the Restricted access control policy report which contains insights about access denials by the policy.
50+
Example 2 generates the restricted access control report which contains insights about access denials by the policy.
5751

5852
## PARAMETERS
5953

6054
### -RACProtectedSites
6155

62-
It is an optional parameter, and it specifies the type of the report generation to be triggered.
56+
It is an optional parameter, and it specifies the type of report generation to be triggered.
6357

6458
```yaml
6559
Type: SwitchParameter
@@ -76,7 +70,7 @@ Accept wildcard characters: False
7670
7771
### -ActionsBlockedByPolicy
7872
79-
It is an optional parameter, and it specifies the type of the report generation to be triggered.
73+
It is an optional parameter, and it specifies the type of report generation to be triggered.
8074
8175
```yaml
8276
Type: SwitchParameter

0 commit comments

Comments
 (0)