diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 2f937b9d8..9fcc5157d 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -5,21 +5,6 @@ "redirect_url": "/powershell/module/sharepoint-online", "redirect_document_id": false }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Export-SPODataAccessGovernanceInsight.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Get-SPODataAccessGovernanceInsight.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Get-SPOSiteReview.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, { "source_path": "sharepoint/virtual-folder/sharepoint-online/Get-SPOTenantRestrictedSearchAllowedList.md", "redirect_url": "/powershell/module/sharepoint-online", @@ -30,11 +15,6 @@ "redirect_url": "/powershell/module/sharepoint-online", "redirect_document_id": false }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, { "source_path": "sharepoint/virtual-folder/sharepoint-online/Remove-SPOTenantRestrictedSearchAllowedList.md", "redirect_url": "/powershell/module/sharepoint-online", @@ -44,16 +24,6 @@ "source_path": "sharepoint/virtual-folder/sharepoint-online/Set-SPOTenantRestrictedSearchMode.md", "redirect_url": "/powershell/module/sharepoint-online", "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Start-SPODataAccessGovernanceInsight.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Start-SPOSiteReview.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - } + } ] } diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md new file mode 100644 index 000000000..39134b1c1 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -0,0 +1,82 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/export-spodataaccessgovernanceinsight +applicable: SharePoint Online +title: Export-SPODataAccessGovernanceInsight +schema: 2.0.0 +author: pvrk +ms.author: pullabhk +manager: +ms.reviewer: +--- + +# Export-SPODataAccessGovernanceInsight + +## SYNOPSIS + +This cmdlet downloads the Data Access Governance (DAG) reports to the current working directory. + +## SYNTAX + +``` +Export-SPODataAccessGovernanceInsight -ReportID [] +``` + +## DESCRIPTION + +This cmdlet exports or downloads the DAG report, specified by the `ReportID`, to the current working directory. The `ReportID` is shown in the output of the [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) command. It can also be fetched from the output of the [Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) command. + +## EXAMPLES + +### Example 1 + +```powershell +Export-SPODataAccessGovernanceInsight -ReportID 28f4c550-215a-472b-a123-c11e5fa8804c +``` + +The above example downloads the report of the given ID to the current working directory. + +## PARAMETERS + +### -ReportID + +Specifies the ID of the DAG report to be downloaded. + +```yaml +Type: Guid +Parameter Sets: (All) +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES + +## RELATED LINKS + +[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) + +[Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) + +[Start-SPOSiteReview](./Start-SPOSiteReview.md) + +[Get-SPOSiteReview](./Get-SPOSiteReview.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md index d7610ec52..06db8f673 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md @@ -31,7 +31,7 @@ If the promo status is enabled, the return value is `True`, otherwise the return ### Example 1 ```powershell -Get-SPOCopilotPromoOptInStatusEnabled +Get-SPOCopilotPromoOptInStatus ``` Example 1 returns the value of the Opt-In promo status. diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md new file mode 100644 index 000000000..e9fda4b93 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -0,0 +1,138 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-spodataaccessgovernanceinsight +applicable: SharePoint Online +title: Get-SPODataAccessGovernanceInsight +schema: 2.0.0 +author: pvrk +ms.author: pullabhk +manager: +ms.reviewer: +--- + +# Get-SPODataAccessGovernanceInsight + +## SYNOPSIS + +Lists various 'Data Access Governance' (DAG) reports in SharePoint admin center. + +## SYNTAX + +### GetAllReportsParameterSet +``` +Get-SPODataAccessGovernanceInsight -ReportEntity [-WorkLoad ] [-ReportType ] [] +``` + +### GetReportParameterSet +``` +Get-SPODataAccessGovernanceInsight -ReportID [] +``` + +## DESCRIPTION + +This cmdlet fetches details of various DAG reports available in SharePoint admin center. + +## EXAMPLES + +### Example 1 + +```powershell +Get-SPODataAccessGovernanceInsight -ReportEntity EveryoneExceptExternalUsersForItems +``` + +The above cmdlet fetches all DAG reports about 'Everyone except external users' attached to an item i.e., to a file, folder, or list in the last 28 days. The output consists of important parameters such as Status, ReportID, number of sites in the report and other user provided values during report generation. + +## PARAMETERS + +### -ReportEntity + +Specifies the entity that could cause oversharing and hence tracked by these reports. + +```yaml +Type: ReportEntityEnum +Parameter Sets: GetAllReportsParameterSet +Aliases: +Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ReportID + +Specifies the ID of the particular report to be fetched. + +```yaml +Type: Guid +Parameter Sets: GetReportParameterSet +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ReportType + +Specifies the time period of data of the reports to be fetched. A 'Snapshot' report will have the latest data as of the report generation time. A 'RecentActivity' report will be based on data in the last 28 days. + +```yaml +Type: ReportTypeEnum +Parameter Sets: GetAllReportsParameterSet +Aliases: +Accepted values: Snapshot, RecentActivity + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WorkLoad + +Specifies the datasource of the reports to be fetched i.e., reports for SharePoint sites or for OneDrive accounts. + +```yaml +Type: WorkloadEnum +Parameter Sets: GetAllReportsParameterSet +Aliases: +Accepted values: SharePoint, OneDriveForBusiness + +Required: False +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES + +## RELATED LINKS + +[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) + +[Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) + +[Start-SPOSiteReview](./Start-SPOSiteReview.md) + +[Get-SPOSiteReview](./Get-SPOSiteReview.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md new file mode 100644 index 000000000..779f44aa5 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md @@ -0,0 +1,126 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-spositereview +applicable: SharePoint Online +title: Get-SPOSiteReview +schema: 2.0.0 +author: pvrk +ms.author: pullabhk +manager: +ms.reviewer: +--- + +# Get-SPOSiteReview + +## SYNOPSIS +Track all site access reviews initiated from Data Access Governance (DAG) reports. + +## SYNTAX + +``` +Get-SPOSiteReview [-SiteReviewID ] [-Status ] [-ReportEntity ] [-SiteID ] [] +``` + +## DESCRIPTION +This cmdlet fetches details of a particular access review or a group of access reviews as per the filtering criteria. + +## EXAMPLES + +### Example 1 +```powershell +Get-SPOSiteReview -ReportEntity PermissionedUsers +``` + +The above cmdlet retrieves all site access reviews raised under all 'Permissioned user' snapshot reports. + +## PARAMETERS + +### -ReportEntity +Specifies the entity that could cause oversharing and hence tracked by these reports. + +```yaml +Type: SiteAccessReportEntityEnum +Parameter Sets: (All) +Aliases: +Accepted values: All, SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -SiteID +Specifies the ID of the site for which access reviews were initiated. + +```yaml +Type: Guid +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -SiteReviewID +Specifies the ID of the particular access review. + +```yaml +Type: Guid +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Status +Specifies the current status of the site access review. + +```yaml +Type: SiteReviewStatus +Parameter Sets: (All) +Aliases: +Accepted values: All, Pending, Failed, Completed + +Required: False +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES + +## RELATED LINKS + +[Site access review for DAG reports](/sharepoint/site-access-review) + +[Start-SPOSiteReview](./Start-SPOSiteReview.md) + +[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) + +[Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) + +[Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md new file mode 100644 index 000000000..69d60e9af --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -0,0 +1,112 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/remove-spodataaccessgovernanceinsight +applicable: SharePoint Online +title: Remove-SPODataAccessGovernanceInsight +schema: 2.0.0 +author: pvrk +ms.author: pullabhk +manager: +ms.reviewer: +--- + +# Remove-SPODataAccessGovernanceInsight + +## SYNOPSIS + +This cmdlet deletes the given Data Access Governance (DAG) report. + +## SYNTAX + +``` +Remove-SPODataAccessGovernanceInsight -ReportID [-WhatIf] [-Confirm] [] +``` + +## DESCRIPTION + +This command deletes the DAG report, specified by the given `ReportID`. The `ReportID` is shown in the output of the [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) command. It can also be fetched from the output of the [Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) command. + +## EXAMPLES + +### Example 1 + +```powershell +Remove-SPODataAccessGovernanceInsight -ReportID 28f4c550-215a-472b-a123-c11e5fa8804c +``` + +This command deletes the report of the given ID "28f4c550-215a-472b-a123-c11e5fa8804c". + +## PARAMETERS + +### -Confirm +Prompts you for confirmation before running the cmdlet. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ReportID + +Specifies the ID of the DAG report to be removed or deleted. + +```yaml +Type: Guid +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +Shows what would happen if the cmdlet runs. +The cmdlet is not run. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi + +Required: False +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES + +## RELATED LINKS + +[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) + +[Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) + +[Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) + +[Start-SPOSiteReview](./Start-SPOSiteReview.md) + +[Get-SPOSiteReview](./Get-SPOSiteReview.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md index 65f5aad5e..cdbab776f 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md @@ -29,12 +29,12 @@ This cmdlet sets the Opt-In Copilot promo status for the tenant to `True` or `Fa ### Example 1 ```powershell -Set-SPOCopilotPromoOptInStatusSetSuccessfully -SPOCopilotPromoOptInStatusEnabled $true +Set-SPOCopilotPromoOptInStatus -IsCopilotPromoStatusEnabled $true ``` Example 1 sets the Opt-In Copilot promo status for the tenant to `True`. -### Parameter: +## PARAMETERS ### -IsCopilotPromoStatusEnabled diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md index ea19d7fa2..b65e601ec 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md @@ -55,7 +55,8 @@ Set-SPOTenant [-SocialBarOnSitePagesDisabled ] [-DefaultLinkPermission ] [-DefaultSharingLinkType ] - [-DisabledWebPartIds ] + [-DisabledWebPartIds [Guid[]]] + [-DisabledAdaptiveCardExtensionIds [Guid[]]] [-DisallowInfectedFileDownload ] [-DisableAddShortcutsToOneDrive ] [-EnableGuestSignInAcceleration ] @@ -363,6 +364,13 @@ Set-SPOTenant –WhoCanShareAnonymousAllowList @() This example empties the WhoCanShareAnonymousAllowList. Similar code works for the WhoCanShareAuthenticatedGuestAllowList. +### EXAMPLE 21 +```powershell +Set-SPOTenant -DisabledAdaptiveCardExtensionIds 0d2d0fd0-9489-47ef-acfb-90edca009cba +``` + +This example disables the Power Apps Adaptive Card Extension. + ## PARAMETERS ### -ApplyAppEnforcedRestrictionsToAdHocRecipients @@ -1094,6 +1102,30 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -DisabledAdaptiveCardExtensionIds + +Allows administrators to prevent certain Adaptive Card Extensions from being added to pages or rendering on pages on which they were previously added. Currently, only the following Adaptive Card Extensions can be disabled in such a manner: + +| Adaptive Card Extension Name | GUID | +|---|---| +| Power Apps | 0d2d0fd0-9489-47ef-acfb-90edca009cba | + +To disable a specific Adaptive Card Extension, you need to enter its GUID as the parameter. To view a list of disabled Adaptive Card Extensions, use [Get-SPOTenant](Get-SPOTenant.md) to get `DisabledAdaptiveCardExtensionIds`. + +To re-enable some disabled Adaptive Card Extensions, use the `Set-SPOTenant` with the `-DisabledAdaptiveCardExtensionIds` parameter and corresponding GUIDs that you still want to keep disabling. To re-enable all disabled Adaptive Card Extensions, use `Set-SPOTenant -DisabledAdaptiveCardExtensionIds @()`. + +```yaml +Type: Guid[] +Parameter Sets: (All) +Aliases: +Applicable: SharePoint Online +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -DisallowInfectedFileDownload Prevents the Download button from being displayed on the Virus Found warning page. diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md new file mode 100644 index 000000000..6f5ea22c2 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -0,0 +1,285 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/start-spodataaccessgovernanceinsight +applicable: SharePoint Online +title: Start-SPODataAccessGovernanceInsight +schema: 2.0.0 +author: pvrk +ms.author: pullabhk +manager: +ms.reviewer: +--- + +# Start-SPODataAccessGovernanceInsight + +## SYNOPSIS + +This cmdlet generates Data Access Governance (DAG) reports meant to provide insights into potential oversharing of sensitive data in SharePoint and/or OneDrive for Business. SharePoint Advanced Management (SAM) license is required to run these reports. + +## SYNTAX + +### EEEUParameterSet + +``` +Start-SPODataAccessGovernanceInsight +-ReportEntity +-Workload +-ReportType +-Name +[-Template ] +[-Privacy ] +[-SiteSensitivityLabelGUID ] +[] +``` + +### SharingLinkParameterSet + +``` +Start-SPODataAccessGovernanceInsight +-ReportEntity +-Workload +-ReportType [] +``` + +### LabelParameterSet + +``` +Start-SPODataAccessGovernanceInsight +-ReportEntity +-Workload +-ReportType +[-FileSensitivityLabelName ] +-FileSensitivityLabelGUID +[] +``` + +### SitePermissionsParameterSet + +``` +Start-SPODataAccessGovernanceInsight +-ReportEntity +-Workload +-ReportType +-Name +[-Template ] +[-Privacy ] +[-SiteSensitivityLabelGUID ] +-CountOfUsersMoreThan +[] +``` + +## 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: + +- Sharing links created in last 28 days (Anyone, People-in-your-org, Specific people shared externally). +- 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. + +## EXAMPLES + +### Example 1 + +```powershell +Start-SPODataAccessGovernanceInsight -ReportEntity PermissionedUsers -Workload SharePoint -ReportType Snapshot -Name "OversharingBaselineReport" -CountOfUsersMoreThan 1000 +``` + +The above cmdlet generates a list of SharePoint sites which can be accessed by more than 1000 users, as of report generation day. + +## PARAMETERS + +### -CountOfUsersMoreThan + +Specifies the threshold of oversharing as defined by the number of users that can access the site. The number of users that can access the site are determined by expanding all users, groups across all permissions (at site level and at the level of any item with unqiue permissions), deduplicate and arrive at a unique number. Minimum value is 100. + +```yaml +Type: Int32 +Parameter Sets: SitePermissionsParameterSet +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -FileSensitivityLabelGUID + +Specifies the GUID for the sensitivity label for the file. + +```yaml +Type: Guid +Parameter Sets: LabelParameterSet +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -FileSensitivityLabelName + +Specifies the name of the sensitivity label for the file. + +```yaml +Type: String +Parameter Sets: LabelParameterSet +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Name + +Specifies the name to be given to the generated report. + +```yaml +Type: String +Parameter Sets: EEEUParameterSet, SitePermissionsParameterSet +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Privacy + +Specifies the privacy setting of the Microsoft 365 group. Relevant in case of filtering the report for group connected sites. + +```yaml +Type: PrivacyEnum +Parameter Sets: EEEUParameterSet, SitePermissionsParameterSet +Aliases: +Accepted values: All, Private, Public + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ReportEntity + +Specifies the entity that could cause oversharing and hence tracked by these reports. + +```yaml +Type: ReportEntityEnum +Parameter Sets: (All) +Aliases: +Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, SensitivityLabelForFiles, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, PermissionedUsers + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ReportType + +Specifies the time period of data based on which DAG report is generated. A 'Snapshot' report will have the latest data as of the report generation time. A 'RecentActivity' report will be based on data in the last 28 days. + +```yaml +Type: ReportTypeEnum +Parameter Sets: (All) +Aliases: +Accepted values: Snapshot, RecentActivity + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -SiteSensitivityLabelGUID + +Specifies the GUID of the sensitivity label applied to the site. + +```yaml +Type: System.Collections.Generic.List`1[System.Guid] +Parameter Sets: EEEUParameterSet, SitePermissionsParameterSet +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Template + +Specifies the template of the site. Relevant in case a report should be generated for that particular template. + +```yaml +Type: System.Collections.Generic.List`1[Microsoft.Online.SharePoint.TenantAdministration.TemplateEnum] +Parameter Sets: EEEUParameterSet, SitePermissionsParameterSet +Aliases: +Accepted values: AllSites, ClassicSites, CommunicationSites, TeamSites, OtherSites + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Workload + +Specifies whether the report is for SharePoint sites or OneDrive accounts. + +```yaml +Type: WorkloadEnum +Parameter Sets: (All) +Aliases: +Accepted values: SharePoint, OneDriveForBusiness + +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES + +## RELATED LINKS + +[Data Access Governance reports (DAG) for SharePoint admins](/sharepoint/data-access-governance-reports) + +[Site access review for DAG reports](/sharepoint/site-access-review) + +[Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) + +[Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) + +[Start-SPOSiteReview](./Start-SPOSiteReview.md) + +[Get-SPOSiteReview](./Get-SPOSiteReview.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md new file mode 100644 index 000000000..2590c4b40 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -0,0 +1,110 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/start-spositereview +applicable: SharePoint Online +title: Start-SPOSiteReview +schema: 2.0.0 +author: pvrk +ms.author: pullabhk +manager: +ms.reviewer: +--- + +# Start-SPOSiteReview + +## SYNOPSIS +SharePoint Administrators can delegate access governance of sites to corresponding site owners through 'site access review'. The 'access review' is under the context of oversharing as specified in the Data Access Governance (DAG) reports. Read all about site access review [here](/sharepoint/site-access-review). + +## SYNTAX + +``` +Start-SPOSiteReview -ReportID -SiteID [-Comment ] [] +``` + +## DESCRIPTION +Initiates a 'site access review' request to all the site owners under the context of the DAG report. The request is sent via email to all site owners with comments given by SharePoint Administrator. + +## EXAMPLES + +### Example 1 + +```powershell +PS C:\> Start-SPOSiteReview -ReportID 03327d1c-38c5-4c32-9dad-85753a682d65 -SiteID a10f1997-71f2-4ef2-825e-2439400fc601 -comment "check for EEEU access" +``` + +The above cmdlet initiates site access review for the given site as per oversharing criteria mentioned in the given DAG report. + +## PARAMETERS + +### -Comment +SharePoint Administrator to add comments to provide more context to the site owner regarding the purpose of the review. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ReportID +Specifies the ID of the particular report which contains sites for which site access review should be initiated. + +```yaml +Type: Guid +Parameter Sets: (All) +Aliases: + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -SiteID +Specifies the ID of the site for which site access review should be initiated. + +```yaml +Type: Guid +Parameter Sets: (All) +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). + +## INPUTS + +### None + +## OUTPUTS + +### System.Object + +## NOTES + +## RELATED LINKS + +[Site access review for DAG reports](/sharepoint/site-access-review) + +[Get-SPOSiteReview](./Get-SPOSiteReview.md) + +[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) + +[Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) + +[Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md)