diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 2f937b9d..9fcc5157 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 00000000..099792f9 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -0,0 +1,98 @@ +--- +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 specified path. The default is the "Downloads" folder. + +## SYNTAX + +``` +Export-SPODataAccessGovernanceInsight -ReportID [] +``` + +## DESCRIPTION + +This cmdlet exports or downloads the DAG report, specified by the `ReportID`, to the path as specified with `DownloadPath`. If not specified, the commands downloads the report to the "Downloads" folder. 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 +``` + +### -DownloadPath + +Specifies the path to which the report should be downloaded. The default path is the "Downloads" folder. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: + +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) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) + +[Start-SPOSiteReview](./Start-SPOSiteReview.md) + +[Get-SPOSiteReview](./Get-SPOSiteReview.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md new file mode 100644 index 00000000..7e37aca6 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md @@ -0,0 +1,163 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-spocopilotagentinsightsreport +applicable: SharePoint Online +title: Get-SPOCopilotAgentInsightsReport +schema: 2.0.0 +author: bhagatshweta +ms.author: bhagatshweta +ms.reviewer: +manager: hikakar +--- + +# Get-SPOCopilotAgentInsightsReport + +## SYNOPSIS + +This cmdlet enables the administrator to check status of all active and available reports when no report ID is present and to view or download a report if report ID is present. + +## SYNTAX + +```powershell +Get-SPOCopilotAgentInsightsReport [-ReportId ] [-Content ] [-Action ] +``` + +## DESCRIPTION + +If this cmdlet is executed without any parameters, it displays the status of all active and completed reports with the following properties: + +| Property | Description | +|:---------------------|:-----------------------------------------------------------------| +| Id | The unique Id of the report. | +| CreatedDateTimeInUtc | The date and time in UTC when the report creation was triggered. | +| Status | The status of the report. | +| ReportPeriodInDays | The report duration in days. | + +> [!NOTE] +> All reports adhere to any retention timeline as per [Data Access Governance](/sharepoint/data-access-governance-reports). + +## EXAMPLES + +### -----------------------EXAMPLE 1----------------------------- + +```powershell +Get-SPOCopilotAgentInsightsReport +``` + +Example 1 enables administrator to view the status of all active and completed reports. + +### -----------------------EXAMPLE 2----------------------------- + +```powershell +Get-SPOCopilotAgentInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b +``` + +Example 2 enables administrator to view the Copilot agent insight report of ReportId: `9d946216-afe7-49f5-8267-7b662435c70b`. + +### -----------------------EXAMPLE 3----------------------------- + +```powershell +Get-SPOCopilotAgentInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download +``` + +Example 3 enables administrator to download the Copilot agent insight report of ReportId: `9d946216-afe7-49f5-8267-7b662435c70b` to the same path from where the command was run. + +## PARAMETERS + +### -ReportId + +It specifies the unique Id of the report to be viewed or downloaded. + +```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 +``` + +### -Content + +It specifies the kind of report to view or download. There are 3 kinds of sub-reports: CopilotAgentsOnSites, TopSites, SiteDistribution. + +If this cmdlet is executed with `-Content` as `CopilotAgentsOnSites`, a report with list of all sites on which a Copilot agent is created along with the names of the Copilot agent created in the specified number of days will be displayed with the following properties: + +| Property | Description | +|:--------------------------------|:----------------------------------------------------------------| +| Site name | The name of the SharePoint site. | +| URL | The URL of the SharePoint site. | +| Template | The Site template of the SharePoint site. | +| Site owner | Name of the owner of the SharePoint site. | +| Copilot name | Name of Copilot agent on the SharePoint site. | +| Sensitivity | The sensitivity label of the SharePoint site. | +| Restrict site access enabled | Restrict site access status (Yes/No) of the SharePoint site. | +| Restrict site discovery enabled | Restrict site discovery status (Yes/No) of the SharePoint site. | +| External sharing | External Sharing status (Yes/No) of the SharePoint site. | + +If this cmdlet is executed with `-ReportId` as parameter and `-Content` as `TopSites`, the top 100 records summarizing the number of Copilot agents on sites created in the specified number of days will be displayed with the following properties: + +| Property | Description | +|:--------------------------------|:----------------------------------------------------------------| +| Site name | The name of the SharePoint site. | +| URL | The URL of the SharePoint site. | +| Template | The Site template of the SharePoint site. | +| Site owner | Name of the owner of the SharePoint site. | +| Copilot agents | Number of Copilot agents on the SharePoint site. | +| Sensitivity | The sensitivity label of the SharePoint site. | +| Restrict site access enabled | Restrict site access status (Yes/No) of the SharePoint site. | +| Restrict site discovery enabled | Restrict site discovery status (Yes/No) of the SharePoint site. | +| External sharing | External Sharing status (Yes/No) of the SharePoint site. | + +If this cmdlet is executed with `-ReportId` as parameter and `-Content` as `SiteDistribution`, a report showing Copilot distribution across sites in the specified number of days will be displayed with the following properties: + +| Property | Description | +|:---------------|:---------------------------------------------------------------------------------------------| +| Site template | The Site template of the SharePoint site. | +| Sites | Number of sites corresponding to that particular site template. | +| Copilot agents | Number of Copilot agents on the SharePoint site corresponding to that particular site template. | + +```yaml +Type: SPOCopilotAgentInsightType +Parameter Sets: (All) +Aliases: +Applicable: SharePoint Online + +Required: False +Position: Named +Default value: CopilotAgentsOnSites +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Action + +It determines whether a report would be viewed or downloaded. If the value of `-Action` is set as `View`, it will display the output on the PowerShell screen. Else if the value of `-Action` is set as `Download`, it will download the full report in CSV format to the same path from where the command was run. + +```yaml +Type: ActionType +Parameter Sets: (All) +Aliases: +Applicable: SharePoint Online + +Required: False +Position: Named +Default value: View +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](https://go.microsoft.com/fwlink/?LinkID=113216). + +## RELATED LINKS + +[Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) + +[Start-SPOCopilotAgentInsightsReport](./Start-SPOCopilotAgentInsightsReport.md) \ No newline at end of file diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md index d7610ec5..06db8f67 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 00000000..e9fda4b9 --- /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-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md new file mode 100644 index 00000000..ce1fc548 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.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-sporestrictedsitecreation +applicable: SharePoint Online +title: Get-SPORestrictedSiteCreation +schema: 2.0.0 +author: vgaddam-pm +ms.author: vgaddam +ms.reviewer: +--- + +# Get-SPORestrictedSiteCreation + +## SYNOPSIS + +This cmdlet allows SharePoint administrators to check the current configuration of the restricted site creation feature. + +## SYNTAX + +```powershell +Get-SPORestrictedSiteCreation [-SiteType ] +``` + +## DESCRIPTION + +This cmdlet obtains the current configuration information for the restricted site creation feature, including whether it is enabled, the current mode, and the current policies. + +> [!Important] +>You must use version 16.0.25513.12000 (published November 2024) or later of the [SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) for these commands to function properly. Earlier versions do not have the current list of site types and will not operate correctly. + +## EXAMPLES + +### Example 1 + +```powershell +Get-SPORestrictedSiteCreation +``` + +Example 1 returns all configuration information for the restricted site creation feature. This includes whether the feature is enabled, the current mode (deny or allow), and the Microsoft Entra security groups configured for each site type. + +### Example 2 + +```powershell +Get-SPORestrictedSiteCreation –SiteType Communication +``` + +Example 2 returns a comma-separated list of the IDs of the Microsoft Entra security groups configured for the `Communication` site type. Depending on whether restricted site creation is in allow or deny mode, members of these groups are either allowed or denied from creating SharePoint communication sites. + +## PARAMETERS + +### -SiteType +When provided, only return the Microsoft Entra security groups configured for the specified site type. + +PARAMVALUE: All | SharePoint | OneDrive | Team | Communication +• All - OneDrive and all SharePoint sites +• SharePoint - All SharePoint sites (but not OneDrive) +• OneDrive - Only OneDrive +• Team - Only SharePoint team sites (group-connected and classic) +• Communication - Only SharePoint communication sites + +```yaml +Type: RestrictedSiteCreationSiteType +Parameter Sets: (All) +Applicable: SharePoint Online +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +## RELATED LINKS + +[Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) + +For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell). 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 00000000..779f44aa --- /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/Get-SPOUnifiedGroupMoveState.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md index 52376a65..88ede939 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md @@ -103,11 +103,13 @@ The move status for the Office 365 Group. Possible values are: * InProgress (n/4): The move is in progress in one of the following states: Validation (1/4), Backup (2/4), Restore (3/4), Cleanup (4/4). * Success: The move has completed successfully. * Failed: The move failed. +* Stopped: The move was canceled by an administrator while it was still queued. +* NotSupported: The move could not be processed because the Preferred Data Location was invalid. +* Rescheduled: The move did not succeed and is being scheduled again for another attempt. -## NOTES - -You can also apply the `-Verbose` option to see additional information about the move. +> [!NOTE] +> You can also apply the `-Verbose` option to see additional information about the move. ## RELATED LINKS -[Move a SharePoint site to a different geo location](https://learn.microsoft.com/office365/enterprise/move-sharepoint-between-geo-locations) +[Move a SharePoint site to a different geo location](/microsoft-365/enterprise/m365-dr-workload-spo) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md index 3ceae414..5a45cb1f 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md @@ -50,6 +50,9 @@ The following are the available move states: |InProgress| The move is in progress in one of the following states: Validation, Backup, Restore, Cleanup.| |Success| The move has completed successfully.| |Failed|The move failed.| +|Stopped|The move was canceled by an administrator while it was still queued.| +|NotSupported|The move could not be processed because the Preferred Data Location was invalid.| +|Rescheduled|The move did not succeed and is being scheduled again for another attempt.| ## EXAMPLES 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 00000000..69d60e9a --- /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/Revoke-SPOUserSession.md b/sharepoint/sharepoint-ps/sharepoint-online/Revoke-SPOUserSession.md index 831dfc11..97a1fa61 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Revoke-SPOUserSession.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Revoke-SPOUserSession.md @@ -39,9 +39,9 @@ Possible results for this cmdlet are: Result | Reason --- | --- Warning : We couldn't find the user@contoso.com. Check for typos and try again. | Invalid input for -User parameter. -We successfully signed out from all devices. | Successful instantaneous revocation. -It can take up to an hour to sign out from all devices. | Successful non-instantaneous revocation. -Sorry, something went wrong and we couldn't sign out from any device. | The cmdlet did not successfully execute. +We successfully signed out \ from all devices. | Successful instantaneous revocation. +It can take up to an hour to sign out \ from all devices. | Successful non-instantaneous revocation. +Sorry, something went wrong and we couldn't sign out \ from any device. | The cmdlet did not successfully execute. The cmdlet will be available in the future, but it isn't ready for use in your organization yet. | The cmdlet has been disabled for the tenant. ## EXAMPLES diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md index 65f5aad5..cdbab776 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-SPOMigrationPackageAzureSource.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOMigrationPackageAzureSource.md index 0ba1ad73..a2d68213 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOMigrationPackageAzureSource.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOMigrationPackageAzureSource.md @@ -164,7 +164,7 @@ Accept wildcard characters: False ### -FileContainerName -The optional name of the Azure Blob Storage container that will be created if it does not currently exist. It will hold the uploaded package content files. The value must be in lower case and conform to Azure's container naming rules. If this not supplied a name will be generated using the format -files. +The optional name of the Azure Blob Storage container that will be created if it does not currently exist. It will hold the uploaded package content files. The value must be in lower case and conform to Azure's container naming rules. If this not supplied a name will be generated using the format \-files. ```yaml Type: String @@ -274,7 +274,7 @@ Accept wildcard characters: False ### -PackageContainerName -The optional name of the Azure Blob Storage container that will be created if it does not currently exist. It will hold the uploaded package metadata files. The value must be in lower case and conform to Azure's container naming rules. If this not supplied a name will be generated using the format -package. +The optional name of the Azure Blob Storage container that will be created if it does not currently exist. It will hold the uploaded package metadata files. The value must be in lower case and conform to Azure's container naming rules. If this not supplied a name will be generated using the format \-package. ```yaml Type: String diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md new file mode 100644 index 00000000..1a603c7f --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md @@ -0,0 +1,177 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/set-sporestrictedsitecreation +applicable: SharePoint Online +title: Set-SPORestrictedSiteCreation +schema: 2.0.0 +author: vgaddam-pm +ms.author: vgaddam +ms.reviewer: jmcdowe +--- + +# Set-SPORestrictedSiteCreation + +## SYNOPSIS + +Sets or updates one or more group configurations for restricting site creation. + +## SYNTAX + +### ParamSet1 + +```powershell +Set-SPORestrictedSiteCreation + [-Enabled ] + [-Mode ] + [-SiteType ] + [-RestrictedSiteCreationGroups ] +``` + +## DESCRIPTION + +This cmdlet sets or updates the configuration or setting for the Restricted Site Creation feature. + +> [!Important] +> You must use version 16.0.25513.12000 (published November 2024) or later of the [SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) for these commands to function properly. Earlier versions do not have the current list of site types and will not operate correctly. + +## EXAMPLES + +### Example 1 + +```powershell +Set-SPORestrictedSiteCreation –Enabled:$true +``` + +Example 1 enables the restricted site creation feature for the tenant. + +### Example 2 + +```powershell +Set-SPORestrictedSiteCreation –Mode Allow +``` + +Example 2 sets restricted site creation to allow mode. In this mode, a user is only able to create a site if they are a member of a group specified for a matching site type. + +### Example 3 + +```powershell +Set-SPORestrictedSiteCreation –SiteType "All" -RestrictedSiteCreationGroups "281e395b-7316-4cb2-b5bb-8881426ee411" +``` + +Example 3 updates the policy for the `All` site type to apply to members of the Microsoft Entra security group with ID 281e395b-7316-4cb2-b5bb-8881426ee411. Members of this group are now either allowed or denied (depending on the current mode) from creating all OneDrive and SharePoint sites. + +### Example 4 + +```powershell +Set-SPORestrictedSiteCreation –SiteType "Team" -RestrictedSiteCreationGroups "78159241-04a9-41d2-8dd4-ac568e9766a3,1f95829b-e1c8-4406-b2be-508c36f4bca5" +``` + +Example 4 updates the policy for the `Team` site type to apply to members of the two specified groups. Members of both specified security groups are now either allowed or denied from creating Team sites, depending on the current mode. +### Example 5 + +```powershell +Set-SPORestrictedSiteCreation –SiteType "OneDrive" -RestrictedSiteCreationGroups "" +``` + +Example 5 clears the policy for the `OneDrive` site type so that it no longer applies to any users. + +## PARAMETERS + +### -Enabled + +PARAMVALUE: true | false +Enables or disables Restricted Site Creation feature in tenant. + +```yaml +Type: Boolean +Parameter Sets: ParamSet1 +Aliases: +Applicable: SharePoint Online +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Mode + +Specifies whether policies allow or deny users from creating sites. +PARAMVALUE: Deny | Allow +- Deny – a user will be blocked from creating a site if any policy applies to them. +- Allow – a user will only be allowed to create a site if a policy applies to them. + +> [!NOTE] +> The restricted site creation mode is shared across all site type policies. It is not possible to use deny mode for one site type and allow mode for a different site type. When the mode is changed, all polices are cleared. + +```yaml +Type: RestrictedSiteCreationMode +Parameter Sets: ParamSet1 +Aliases: +Applicable: SharePoint Online +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -SiteType + +When paired with the `–RestrictedSiteCreationGroups` parameter, creates a new policy which applies to the specified types of sites. + +PARAMVALUE: All | SharePoint | OneDrive | Team | Communication +- All - OneDrive and all SharePoint sites +- SharePoint - All SharePoint sites (but not OneDrive) +- OneDrive - Only OneDrive +- Team - Only SharePoint team sites (group-connected and classic) +- Communication - Only SharePoint communication sites + + +```yaml +Type: RestrictedSiteCreationSiteType +Parameter Sets: ParamSet1 +Aliases: +Applicable: SharePoint Online +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -RestrictedSiteCreationGroups + +A comma-separated list of up to 10 Microsoft Entra security group IDs. When paired with the `–SiteType` parameter, defines a new policy which applies to the specified groups. +Set to the empty string ("") to clear the policy for a site type. + +```yaml +Type: String +Parameter Sets: (All) +Aliases: cf +Applicable: SharePoint Online +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](https://go.microsoft.com/fwlink/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS + +For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). + +[Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) + +[Set-SPORestrictedSiteCreation](Set-SPORestrictedSiteCreation.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md index 7a6b3bcd..20e7ce73 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 ] @@ -390,6 +391,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 @@ -1121,6 +1129,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-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md new file mode 100644 index 00000000..928e5b8c --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md @@ -0,0 +1,99 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/start-spocopilotagentinsightsreport +applicable: SharePoint Online +title: Start-SPOCopilotAgentInsightsReport +schema: 2.0.0 +author: bhagatshweta +ms.author: bhagatshweta +ms.reviewer: +manager: hikakar +--- + +# Start-SPOCopilotAgentInsightsReport + +## SYNOPSIS + +Using this cmdlet, administrators may trigger the build of a new Copilot agent insight report for the specified number of days. + +## SYNTAX + +```powershell +Start-SPOCopilotAgentInsightsReport [-ReportPeriodInDays ] [-Force ] +``` + +## DESCRIPTION + +After this cmdlet is executed, the Copilot agent insight report generation request for the specified number of days gets queued in the pipeline and the below metadata is displayed with the following properties: + +| Property | Description | +|:---------------------|:-----------------------------------------------------------------| +| Id | The unique Id of the report. | +| CreatedDateTimeInUtc | The date and time in UTC when the report creation was triggered. | +| Status | The status of the report. | +| ReportPeriodInDays | The report duration in days. | + +## EXAMPLES + +### -----------------------EXAMPLE 1----------------------------- + +```powershell +Start-SPOCopilotAgentInsightsReport +``` + +Example 1 generates the Copilot agent insight report for a default duration of 1 day since the parameter `–ReportPeriodInDays` is not provided. + +### -----------------------EXAMPLE 2----------------------------- + +```powershell +Start-SPOCopilotAgentInsightsReport –ReportPeriodInDays 14 +``` + +Example 2 generates the Copilot agent insight report for a specified duration of 14 days. + +## PARAMETERS + +### -ReportPeriodInDays + +It specifies the duration of the Copilot agent insight report in days. The possible values of ReportPeriodInDays are: 1, 7, 14, 28. If this parameter is not provided, it generates the report for a default duration of 1 day. + +```yaml +Type: Int +Parameter Sets: (All) +Aliases: +Applicable: SharePoint Online + +Required: False +Position: Named +Default value: 1 +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Force + +It is an optional parameter which is used to bypass confirmation prompts and execute the command without interruptions. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: SharePoint Online + +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](https://go.microsoft.com/fwlink/?LinkID=113216). + +## Related Links + +[Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) + +[Get-SPOCopilotAgentInsightsReport](./Get-SPOCopilotAgentInsightsReport.md) \ No newline at end of file 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 00000000..6f5ea22c --- /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 00000000..2590c4b4 --- /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) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Unregister-SPOHubSite.md b/sharepoint/sharepoint-ps/sharepoint-online/Unregister-SPOHubSite.md index 0349fcf0..db9b88ce 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Unregister-SPOHubSite.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Unregister-SPOHubSite.md @@ -37,7 +37,7 @@ Disables the hub site feature on a site so that it is no longer a hub site. Asso Unregister-SPOHubSite -Identity ``` -This example removes a site from the hub site list based on unique hub identifier (). +This example removes a site from the hub site list based on unique hub identifier (\). ### Example 2 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md b/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md index d7f698ff..a635b89d 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md @@ -99,6 +99,10 @@ The following cmdlet references are for SharePoint Online. {{Manually Enter Get-SPOAppInfo Description Here}} +### [Get-SPOCopilotAgentInsightsReport](Get-SPOCopilotAgentInsightsReport.md) + +{{Gets the status of all active and available reports when no report ID is present, and allows to view or download a report if report ID is present.}} + ### [Get-SPOCrossGeoMovedUsers](Get-SPOCrossGeoMovedUsers.md) {{Manually Enter Get-SPOCrossGeoMovedUsers Description Here}} @@ -175,6 +179,10 @@ The following cmdlet references are for SharePoint Online. {{Manually Enter Get-SPOPublicCdnOrigins Description Here}} +### [Get-SPORestrictedSiteCreation](Get-SPORestrictedSiteCreation.md) + +{{Gets group configurations for restricting site creation policy}} + ### [Get-SPOSite](Get-SPOSite.md) {{Manually Enter Get-SPOSite Description Here}} @@ -540,6 +548,10 @@ This cmdlet is not currently active in production and may be removed in the futu {{Manually Enter Set-SPOOrgAssetsLibrary Description Here}} +### [Set-SPORestrictedSiteCreation](Set-SPORestrictedSiteCreation.md) + +{{Sets or updates one or more group configurations for restricting site creation}} + ### [Set-SPOSite](Set-SPOSite.md) {{Manually Enter Set-SPOSite Description Here}} @@ -600,6 +612,10 @@ This cmdlet is not currently active in production and may be removed in the futu {{Manually Enter Set-SPOUser Description Here}} +### [Start-SPOCopilotAgentInsightsReport](Start-SPOCopilotAgentInsightsReport.md) + +{{Triggers the build of a new Copilot agent insight report for the specified number of days.}} + ### [Start-SPOSiteContentMove](Start-SPOSiteContentMove.md) {{Manually Enter Start-SPOSiteContentMove Description Here}}