Merge branch 'main' into patch-1

MicrosoftDocs · Dec 4, 2024 · d046156 · d046156
2 parents 1ad2dc1 + f89afbc
commit d046156
Show file tree

Hide file tree

Showing 10 changed files with 890 additions and 35 deletions.
diff --git 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/...epoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/...epoint/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 <Guid> [<CommonParameters>]
+```
+
+## 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
@@ -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
@@ -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 <ReportEntityEnum> [-WorkLoad <WorkloadEnum>] [-ReportType <ReportTypeEnum>] [<CommonParameters>]
+```
+
+### GetReportParameterSet
+```
+Get-SPODataAccessGovernanceInsight -ReportID <Guid> [<CommonParameters>]
+```
+
+## 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)