New PS commands for Opt-in feature

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

@@ -0,0 +1,77 @@
+---
+external help file: sharepointonline.xml
+Module Name: Microsoft.Online.SharePoint.PowerShell
+online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-spoauditdatacollectionstatusforactivityinsights
+applicable: SharePoint Online
+title: Get-SPOAuditDataCollectionStatusForActivityInsights
+schema: 2.0.0
+author: pvrk
+ms.author: pullabhk
+manager: 
+ms.reviewer:
+---
+
+# Get-SPOAuditDataCollectionStatusForActivityInsights
+
+## SYNOPSIS
+
+Lists the current status of audit data collection for reports based on activities within the last 28 days, from SharePoint Admin Center.
+
+## SYNTAX
+
+```
+Get-SPOAuditDataCollectionStatusForActivityInsights [-ReportEntity <OptInReportEntityEnum>]
+ [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+SharePoint administrators can generate reports based on activities within the last 28 days such as Sharing link reports, content shared with Everyone except external users etc from SharePoint admin center. These reports require audit data to be collected after approved by SharePoint admin. This command gives the current status of the relevant audit data collection.
+
+## EXAMPLES
+
+### Example 1
+
+```powershell
+PS C:\> Get-SPOAuditDataCollectionStatusForActivityInsights -ReportEntity SharingLinks_Anyone
+```
+
+This command fetches the current status of audit data collection for the report on sites with most number of "Anyone" sharing links generated in the last 28 days.
+
+## PARAMETERS
+
+### -ReportEntity
+
+Specifies the entity for which the corresponding audit data collection status should be shown
+
+```yaml
+Type: OptInReportEntityEnum
+Parameter Sets: (All)
+Aliases:
+Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, CopilotAppInsights
+
+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-SPOAuditDataCollectionForActivityInsights](./Start-SPOAuditDataCollectionForActivityInsights.md)
+[Stop-SPOAuditDataCollectionForActivityInsights](./Stop-SPOAuditDataCollectionForActivityInsights.md)
+[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md)

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

@@ -0,0 +1,79 @@
+---
+external help file: sharepointonline.xml
+Module Name: Microsoft.Online.SharePoint.PowerShell
+online version: https://learn.microsoft.com/powershell/module/sharepoint-online/start-spoauditdatacollectionforactivityinsights
+applicable: SharePoint Online
+title: Start-SPOAuditDataCollectionForActivityInsights
+schema: 2.0.0
+author: pvrk
+ms.author: pullabhk
+manager: 
+ms.reviewer:
+---
+
+# Start-SPOAuditDataCollectionForActivityInsights
+
+## SYNOPSIS
+
+This cmdlet starts collecting relevant audit data for reports, based on activities within the last 28 days, such as Sharing link reports, content shared with Everyone except external users etc from SharePoint admin center.
+
+## SYNTAX
+
+```
+Start-SPOAuditDataCollectionForActivityInsights -ReportEntity <OptInReportEntityEnum> [<CommonParameters>]
+```
+
+## DESCRIPTION
+
+This cmdlet starts collecting relevant audit data for reports, based on activites related to sharing and access. Reports are 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.
+- Copilot agents created in last 28 days *(Private Preview)*
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> Start-SPOAuditDataCollectionForActivityInsights -ReportEntity SharingLinks_Anyone
+```
+
+This cmdlet will start collecting audit data related to the generation of 'Anyone' sharing links from the moment it is executed.
+
+## PARAMETERS
+
+### -ReportEntity
+
+Specifies the entity for which the corresponding audit data should be collected.
+
+```yaml
+Type: OptInReportEntityEnum
+Parameter Sets: (All)
+Aliases:
+Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, CopilotAppInsights
+
+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
+
+[Stop-SPOAuditDataCollectionForActivityInsights](./Stop-SPOAuditDataCollectionForActivityInsights.md)
+[Get-SPOAuditDataCollectionStatusForActivityInsights](./Get-SPOAuditDataCollectionStatusForActivityInsights.md)
+[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md)

sharepoint/sharepoint-ps/sharepoint-online/Stop-SPOAuditDataCollectionForActivityInsights.md

@@ -0,0 +1,78 @@
+---
+external help file: sharepointonline.xml
+Module Name: Microsoft.Online.SharePoint.PowerShell
+online version: https://learn.microsoft.com/powershell/module/sharepoint-online/stop-spoauditdatacollectionforactivityinsights
+applicable: SharePoint Online
+title: Stop-SPOAuditDataCollectionForActivityInsights
+schema: 2.0.0
+author: pvrk
+ms.author: pullabhk
+manager: 
+ms.reviewer:
+---
+
+# Stop-SPOAuditDataCollectionForActivityInsights
+
+## SYNOPSIS
+
+This cmdlet stops collecting relevant audit data for reports, based on activities within the last 28 days, such as Sharing link reports, content shared with Everyone except external users etc from SharePoint admin center.
+
+## SYNTAX
+
+```
+Stop-SPOAuditDataCollectionForActivityInsights -ReportEntity <OptInReportEntityEnum> [<CommonParameters>]
+```
+
+## DESCRIPTION
+This cmdlet stops collecting relevant audit data for reports, based on activites related to sharing and access. Reports are 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.
+- Copilot agents created in last 28 days *(Private Preview)*
+
+## EXAMPLES
+
+### Example 1
+```powershell
+PS C:\> Stop-SPOAuditDataCollectionForActivityInsights -ReportEntity SharingLinks_Anyone
+```
+
+This cmdlet will stop collecting audit data related to the generation of 'Anyone' sharing links from the moment it is executed.
+
+## PARAMETERS
+
+### -ReportEntity
+
+Specifies the entity for which the corresponding audit data should not be collected.
+
+```yaml
+Type: OptInReportEntityEnum
+Parameter Sets: (All)
+Aliases:
+Accepted values: SharingLinks_Anyone, SharingLinks_PeopleInYourOrg, SharingLinks_Guests, EveryoneExceptExternalUsersAtSite, EveryoneExceptExternalUsersForItems, CopilotAppInsights
+
+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-SPOAuditDataCollectionForActivityInsights](./Start-SPOAuditDataCollectionForActivityInsights.md)
+[Get-SPOAuditDataCollectionStatusForActivityInsights](./Get-SPOAuditDataCollectionStatusForActivityInsights.md)
+[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md)