Skip to content

Commit

Permalink
Documentation for the new private preview feature
Browse files Browse the repository at this point in the history
  • Loading branch information
pvrk committed Jan 9, 2025
1 parent 08f3059 commit e04ec35
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 3 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ Specifies the entity that could cause oversharing and hence tracked by these rep
Type: ReportEntityEnum
Parameter Sets: GetAllReportsParameterSet
Aliases:
Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers
Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers, PermissionsReport (Preview)

Required: True
Position: Named
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -69,6 +69,18 @@ Start-SPODataAccessGovernanceInsight
[<CommonParameters>]
```

### UserPermissionsParameterSet

```
Start-SPODataAccessGovernanceInsight
-ReportEntity <ReportEntityEnum>
-Workload <WorkloadEnum>
-ReportType <ReportTypeEnum>
-Name <String>
-UserIDList <System.Collections.Generic.List`1[System.Guid]>
[<CommonParameters>]
```

## DESCRIPTION

This cmdlet is used to generate DAG reports which deal with potential oversharing of sensitive data. These reports are present in Sharepoint admin center. Reports are currently available for the following scenarios:
Expand All @@ -77,6 +89,7 @@ This cmdlet is used to generate DAG reports which deal with potential oversharin
- Content shared with Everyone except external users (EEEU) in last 28 days.
- List of sites having labelled files, as of report generation time.
- List of sites having 'too-many-users', as of report generation time, to setup an oversharing baseline.
- List of sites with direct or indirect permissions to given users. *(Private Preview)*

## EXAMPLES

Expand Down Expand Up @@ -179,7 +192,7 @@ Specifies the entity that could cause oversharing and hence tracked by these rep
Type: ReportEntityEnum
Parameter Sets: (All)
Aliases:
Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers
Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers, PermissionsReport (Preview)

Required: True
Position: Named
Expand Down Expand Up @@ -227,7 +240,7 @@ Specifies the template of the site. Relevant in case a report should be generate
```yaml
Type: System.Collections.Generic.List`1[Microsoft.Online.SharePoint.TenantAdministration.TemplateEnum]
Parameter Sets: EEEUParameterSet, SitePermissionsParameterSet
Parameter Sets: EEEUParameterSet, SitePermissionsParameterSet, UserPermissionsParameterSet
Aliases:
Accepted values: AllSites, ClassicSites, CommunicationSites, TeamSites, OtherSites

Expand Down Expand Up @@ -255,6 +268,22 @@ Accept pipeline input: False
Accept wildcard characters: False
```
### -UserIDList
Specifies the AAD/Entra object IDs of the users for whom permissions report should be generated. Can be fetched using the ```Get-MgUser``` command from Microsoft Graph PowerShell.

```yaml
Type: System.Collections.Generic.List`1[System.Guid]
Parameter Sets: UserPermissionsParameterSet
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```
### CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).
Expand Down

0 comments on commit e04ec35

Please sign in to comment.