diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 525f0dc17..2f937b9d8 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -1,29 +1,59 @@ { - "redirections": [ - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Add-SPOTenantRestrictedSearchAllowedList.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", - "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Get-SPOTenantRestrictedSearchMode.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", - "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Set-SPOTenantRestrictedSearchMode.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - } - ] + "redirections": [ + { + "source_path": "sharepoint/virtual-folder/sharepoint-online/Add-SPOTenantRestrictedSearchAllowedList.md", + "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", + "redirect_document_id": false + }, + { + "source_path": "sharepoint/virtual-folder/sharepoint-online/Get-SPOTenantRestrictedSearchMode.md", + "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", + "redirect_document_id": false + }, + { + "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 deleted file mode 100644 index 8c1f4863b..000000000 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml -Module Name: Microsoft.Online.SharePoint.PowerShell -applicable: SharePoint Online -online version: -schema: 2.0.0 -author: MachelleTranMSFT -ms.author: mactra -ms.reviewer: pullabhk ---- - -# Export-SPODataAccessGovernanceInsight - -## SYNOPSIS - -This commands exports/downloads the Data access governance report to the default path "C:\WINDOWS\system32\" - -## SYNTAX - -```powershell -Export-SPODataAccessGovernanceInsight -ReportID [] -``` - -## DESCRIPTION - -This commands exports/downloads the DAG report, specified by the ReportID, to the default path "C:\WINDOWS\system32\". The ReportID is shown in the output of the 'Start-SPODataAccessGovernanceInsight' command. It can also be fetched from the output of the 'Get-SPODataAccessGovernanceInsight' command. - -## EXAMPLES - -### Example 1 - -```powershell -PS C:\> Export-SPODataAccessGovernanceInsight -ReportID 28f4c550-215a-472b-a123-c11e5fa8804c -``` - -This command downloads the report of the given ID to the default path "C:\WINDOWS\system32\" - -## 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 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md new file mode 100644 index 000000000..d7610ec52 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md @@ -0,0 +1,41 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPOCopilotPromoOptInStatus +applicable: SharePoint Online +title: Get-SPOCopilotPromoOptInStatus +schema: +author: siruvanti +ms.author: siruvanti +ms.reviewer: +--- + +# Get-SPOCopilotPromoOptInStatus + +## SYNOPSIS + +Returns the Opt-In Copilot promo status for the tenant. + +## SYNTAX +```powershell +Get-SPOCopilotPromoOptInStatus +``` + +## DESCRIPTION + +This cmdlet returns the Opt-In Copilot promo status for the tenant. +If the promo status is enabled, the return value is `True`, otherwise the return value is `False`. + +## EXAMPLES + +### Example 1 + +```powershell +Get-SPOCopilotPromoOptInStatusEnabled +``` + +Example 1 returns the value of the Opt-In promo status. + +## RELATED LINKS +- [Set-SPOCopilotPromoOptInStatus](./Set-SPOCopilotPromoOptInStatus.md) +- [Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md deleted file mode 100644 index 1f52448a5..000000000 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md +++ /dev/null @@ -1,129 +0,0 @@ ---- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml -Module Name: Microsoft.Online.SharePoint.PowerShell -online version: -schema: 2.0.0 -author: MachelleTranMSFT -ms.author: mactra -ms.reviewer: pullabhk ---- - -# Get-SPODataAccessGovernanceInsight - -## SYNOPSIS - -Lists various reports available in Data access governance module in SharePoint Admin Center. - -## SYNTAX - -### GetAllReportsParameterSet - -```powershell -Get-SPODataAccessGovernanceInsight -ReportEntity [-WorkLoad ] - [-ReportType ] [] -``` - -### GetReportParameterSet - -```powershell -Get-SPODataAccessGovernanceInsight -ReportID [] -``` - -## DESCRIPTION - -Fetch details of various reports available in 'Data Access Governance' module (DAG) in SharePoint Admin Center - -## EXAMPLES - -### Example 1 - -```powershell -PS C:\> Get-SPODataAccessGovernanceInsight -ReportEntity EveryoneExceptExternalUsersForItems -``` - -This command fetches all DAG reports about 'Everyone except external users' attached to a item i.e., file/folder/list. 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 'potential oversharing' scenario as captured by DAG report given during the report creation. - -```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 i.e., fetch 'Snapshot' reports or 'RecentActivity' reports - -```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 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedAccessForSitesInsights.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedAccessForSitesInsights.md new file mode 100644 index 000000000..c416db614 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedAccessForSitesInsights.md @@ -0,0 +1,189 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/get-sporestrictedaccessforsitesinsights +applicable: SharePoint Online +title: Get-SPORestrictedAccessForSitesInsights +schema: 2.0.0 +author: ishwarit +ms.author: itambakhe +ms.reviewer: +manager: +--- + +# Get-SPORestrictedAccessForSitesInsights + +## SYNOPSIS + +This cmdlet enables the administrator to check status of all active and available reports about insights on sites protected and access denials by restricted access control. + +## SYNTAX + +```powershell +Get-SPORestrictedAccessForSitesInsights -RACProtectedSites [-ReportId ] [-Action ] [-InsightsSummary ] +``` + +```powershell +Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy [-ReportId ] [-Content ] [-Action ] +``` + +## DESCRIPTION + +If this cmdlet is executed with `-RACProtectedSites` as parameter, it displays the status of all the active and completed reports. + +If this cmdlet is executed with `-RACProtectedSites` `-ReportId` as parameter, top 100 sites with the highest page views that are protected by restricted access control will be displayed. + +If this cmdlet is executed with `-RACProtectedSites` `-ReportId` `-InsightsSummary` as parameter, the count of sites protected with restricted access control compared to total number of sites will be displayed. + +If this cmdlet is executed with `-ActionsBlockedByPolicy` as parameter, it displays the status of all active and completed reports. + +If this cmdlet is executed with `-ActionsBlockedByPolicy` `-ReportId` `-Content TopSites` as parameter, top 100 sites with the highest access denials by restricted access control will be displayed. + +If this cmdlet is executed with `-ActionsBlockedByPolicy` `-ReportId` `-Content TopUsers` as parameter, top 10 users with the highest access denials by restricted access control will be displayed. + +If this cmdlet is executed with `-ActionsBlockedByPolicy` `-ReportId` `-Content AllDenials` as parameter, most recent 100 access denials by restricted access control in the last 28 days will be displayed. + +If this cmdlet is executed with `-ActionsBlockedByPolicy` `-ReportId` `-Content SiteDistribution` as parameter, distribution of access denials by restricted access control on different site types will be displayed. + +> [!NOTE] +> All reports adhere to any retention timeline as per [Data Access Governance](/sharepoint/data-access-governance-reports). + +## EXAMPLES + +### -----------------------EXAMPLE 1----------------------------- + +```powershell +Get-SPORestrictedAccessForSitesInsights -RACProtectedSites +``` + +Example 1 enables administrator to view the status of all active and completed reports on list of sites protected with restricted access control. + +### -----------------------EXAMPLE 2----------------------------- + +```powershell +Get-SPORestrictedAccessForSitesInsights –RACProtectedSites -ReportId 9d946216-afe7-49f5-8267-7b662435c70b +``` + +Example 2 enables administrator to view the report containing list of sites protected with restricted access control with ReportId: `9d946216-afe7-49f5-8267-7b662435c70b` + +### -----------------------EXAMPLE 3----------------------------- + +```powershell +Get-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy -ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Content TopSites +``` + +Example 3 enables administrator to view the report containing top sites with access denials due to restricted access control with ReportId: `9d946216-afe7-49f5-8267-7b662435c70b`. + +## PARAMETERS + +### -RACProtectedSites + +It is an optional parameter, and it specifies the type of report to be viewed or downloaded. + +```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 +``` + +### -ActionsBlockedByPolicy + +It is an optional parameter, and it specifies the type of report to be viewed or downloaded. + +```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 +``` + +### -ReportId + +It is an optional parameter, and 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 +``` + +### -InsightsSummary + +It is an optional parameter, and it specifies the subtype of the report to be viewed or downloaded. + +```yaml +Type: Bool +Parameter Sets: (All) +Aliases: +Applicable: SharePoint Online + +Required: False +Position: Named +Default value: True +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Content + +It is an optional parameter, and it specifies the subtype of the report to be viewed or downloaded. + +```yaml +Type: ContentType +Parameter Sets: (All) +Aliases: +Applicable: SharePoint Online + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Action + +It is an optional parameter, and it specifies whether to view or download a specific report. + +```yaml +Type: ActionType +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) + +[Start-SPORestrictedAccessForSitesInsights](./Start-SPORestrictedAccessForSitesInsights.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md deleted file mode 100644 index b9c138fd2..000000000 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md +++ /dev/null @@ -1,120 +0,0 @@ ---- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml -Module Name: Microsoft.Online.SharePoint.PowerShell -online version: -schema: 2.0.0 -author: MachelleTranMSFT -ms.author: mactra -ms.reviewer: pullabhk ---- - -# Get-SPOSiteReview - -## SYNOPSIS - -This command retrieves the site review report. - -## SYNTAX - -```powershell -Get-SPOSiteReview [-SiteReviewID ] [-Status ] - [-ReportEntity ] [-SiteID ] [] -``` - -## DESCRIPTION - -{{ Fill in the Description }} - -## EXAMPLES - -### Example 1 - -```powershell -PS C:\> {{ Add example code here }} -``` - -{{ Add example description here }} - -## PARAMETERS - -### -ReportEntity - -{{ Fill ReportEntity Description }} - -```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 - -{{ Fill SiteID Description }} - -```yaml -Type: Guid -Parameter Sets: (All) -Aliases: - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -SiteReviewID - -{{ Fill SiteReviewID Description }} - -```yaml -Type: Guid -Parameter Sets: (All) -Aliases: - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -Status - -{{ Fill Status Description }} - -```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 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md deleted file mode 100644 index ba1cfb731..000000000 --- a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml -Module Name: Microsoft.Online.SharePoint.PowerShell -online version: -schema: 2.0.0 -author: MachelleTranMSFT -ms.author: mactra -ms.reviewer: pullabhk ---- - -# Remove-SPODataAccessGovernanceInsight - -## SYNOPSIS - -This command deletes the given Data access governance report. - -## SYNTAX - -```powershell -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' command. It can also be fetched from the output of the 'Get-SPODataAccessGovernanceInsight' command. - -## EXAMPLES - -### Example 1 - -```powershell -PS C:\> 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/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 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md new file mode 100644 index 000000000..65f5aad5e --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md @@ -0,0 +1,54 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/Set-SPOCopilotPromoOptInStatus +applicable: SharePoint Online +title: Set-SPOCopilotPromoOptInStatus +schema: +author: siruvanti +ms.author: siruvanti +ms.reviewer: +--- +# Set-SPOCopilotPromoOptInStatus + +## SYNOPSIS + +Sets the Opt-In Copilot promo status for the tenant. + +## SYNTAX +```powershell +Set-SPOCopilotPromoOptInStatus -IsCopilotPromoStatusEnabled + +``` +## DESCRIPTION + +This cmdlet sets the Opt-In Copilot promo status for the tenant to `True` or `False`. + +## EXAMPLES + +### Example 1 + +```powershell +Set-SPOCopilotPromoOptInStatusSetSuccessfully -SPOCopilotPromoOptInStatusEnabled $true +``` + +Example 1 sets the Opt-In Copilot promo status for the tenant to `True`. + +### Parameter: + +### -IsCopilotPromoStatusEnabled + +Use this parameter to set Copilot opt-in promo status. + +```yaml +Type: Boolean +Parameter Sets: +Aliases: +Applicable: SharePoint Online + +Required: True +Default value: None +``` +## RELATED LINKS +- [Get-SPOCopilotPromoOptInStatus](./Get-SPOCopilotPromoOptInStatus.md) +- [Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOSite.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOSite.md index 5698f84b0..86fbb1a31 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOSite.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOSite.md @@ -62,6 +62,11 @@ Set-SPOSite [-Identity] [-AllowSelfServiceUpgrade ] [ [-DefaultShareLinkRole ] [-HidePeoplePreviewingFiles ] [-HidePeopleWhoHaveListsOpen ] + [-AddRestrictedAccessControlGroups ] + [-ClearRestrictedAccessControl ] + [-RestrictedAccessControl ] + [-RestrictedAccessControlGroups ] + [-RemoveRestrictedAccessControlGroups ] [] ``` @@ -328,6 +333,37 @@ Default value: None Accept pipeline input: False Accept wildcard characters: False ``` +### -AddRestrictedAccessControlGroups + +Add the groups that are given access to the site and its content as per the restricted access control policy to the existing list of control groups. + +```yaml +Type: GUID +Parameter Sets: ParamSet1 +Aliases: +Applicable: SharePoint Online +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ClearRestrictedAccessControl + +Resets the restricted access control flag to False and clears the list of control groups that were given access to the site and its content as per restricted access control policy. + +```yaml +Type: Boolean +Parameter Sets: ParamSet1 +Aliases: +Applicable: SharePoint Online +Required: False +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` ### -Confirm @@ -485,6 +521,54 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -RestrictedAccessControl + +Specifies the flag value for restricted access control policy. + +```yaml +Type: Boolean +Parameter Sets: ParamSet1 +Aliases: +Applicable: SharePoint Online +Required: False +Position: Named +Default value: False +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -RestrictedAccessControlGroups + +Specifies the groups that are given access to the site and its content as per the restricted access control policy. + +```yaml +Type: GUID +Parameter Sets: ParamSet1 +Aliases: +Applicable: SharePoint Online +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -RemoveRestrictedAccessControlGroups + +Removes the specified groups from the list of control groups that are given access to the site and its content as per the restricted access control policy. + +```yaml +Type: GUID +Parameter Sets: ParamSet1 +Aliases: +Applicable: SharePoint Online +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -SensitivityLabel Used to specify the unique identifier (GUID) of the SensitivityLabel. diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md deleted file mode 100644 index 3212e2cf8..000000000 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md +++ /dev/null @@ -1,256 +0,0 @@ ---- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml -Module Name: Microsoft.Online.SharePoint.PowerShell -online version: -schema: 2.0.0 -author: MachelleTranMSFT -ms.author: mactra -ms.reviewer: pullabhk ---- - -# Start-SPODataAccessGovernanceInsight - -## SYNOPSIS - -This command generates various reports which are meant to provide insights into potential oversharing of sensitive data in SharePoint and/or OneDrive. These insights are powered by Data Access Governance (DAG) module, available in SharePoint Admin Center. SharePoint Advanced Management (SAM) license is required to run this command. - -## SYNTAX - -### EEEUParameterSet - -```powershell -Start-SPODataAccessGovernanceInsight -ReportEntity -Workload - -ReportType -Name - [-Template ] - [-Privacy ] [-SiteSensitivityLabelGUID ] - [] -``` - -### SharingLinkParameterSet - -```powershell -Start-SPODataAccessGovernanceInsight -ReportEntity -Workload - -ReportType [] -``` - -### LabelParameterSet - -```powershell -Start-SPODataAccessGovernanceInsight -ReportEntity -Workload - -ReportType [-FileSensitivityLabelName ] -FileSensitivityLabelGUID - [] -``` - -### SitePermissionsParameterSet - -```powershell -Start-SPODataAccessGovernanceInsight -ReportEntity -Workload - -ReportType -Name - [-Template ] - [-Privacy ] [-SiteSensitivityLabelGUID ] - -CountOfUsersMoreThan [] -``` - -## DESCRIPTION - -This command is used to generate reports, in Data Access Governance (DAG) module, regarding potential oversharing of sensitive data. Reports are currently available for: - -- 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 -PS C:\> Start-SPODataAccessGovernanceInsight -ReportEntity PermissionedUsers -Workload SharePoint -ReportType Snapshot -Name "OversharingBaselineReport" -CountOfUsersMoreThan 1000 -``` - -The above command generates a list of SharePoint sites which can be accessed by more than 1000 users, as of the 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 unique 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 0365 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 'potential oversharing' scenario that should be captured by the DAG report. - -```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 'X' 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 for SharePoint admins](/sharepoint/data-access-governance-reports) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPORestrictedAccessForSitesInsights.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPORestrictedAccessForSitesInsights.md new file mode 100644 index 000000000..5f6c8e0a6 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPORestrictedAccessForSitesInsights.md @@ -0,0 +1,113 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/start-sporestrictedaccessforsitesinsights +applicable: SharePoint Online +title: Start-SPORestrictedAccessForSitesInsights +schema: 2.0.0 +author: ishwarit +ms.author: itambakhe +ms.reviewer: +manager: +--- + +# Start-SPORestrictedAccessForSitesInsights + +## SYNOPSIS + +This cmdlet enables administrator to trigger the build of a new restricted access control insights report for the data from last 28 days. + +## SYNTAX + +```powershell +Start-SPORestrictedAccessForSitesInsights -RACProtectedSites [-Force ] +``` + +```powershell +Start-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy [-Force ] +``` + +## DESCRIPTION + +After this cmdlet is executed, the restricted access control insights report generation request is initiated for the requested report subtype. | + +## EXAMPLES + +### -----------------------EXAMPLE 1----------------------------- + +```powershell +Start-SPORestrictedAccessForSitesInsights -RACProtectedSites +``` + +Example 1 generates the restricted access control report which contains insights about the list of sites protected with the policy. + +### -----------------------EXAMPLE 2----------------------------- + +```powershell +Start-SPORestrictedAccessForSitesInsights -ActionsBlockedByPolicy +``` + +Example 2 generates the restricted access control report which contains insights about access denials by the policy. + +## PARAMETERS + +### -RACProtectedSites + +It is an optional parameter, and it specifies the type of report generation to be triggered. + +```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 +``` + +### -ActionsBlockedByPolicy + +It is an optional parameter, and it specifies the type of report generation to be triggered. + +```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 +``` + +### -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-SPORestrictedAccessForSitesInsights](./Get-SPORestrictedAccessForSitesInsights.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md deleted file mode 100644 index 257f6f663..000000000 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md +++ /dev/null @@ -1,101 +0,0 @@ ---- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml -Module Name: Microsoft.Online.SharePoint.PowerShell -online version: -schema: 2.0.0 -author: MachelleTranMSFT -ms.author: mactra -ms.reviewer: pullabhk ---- - -# Start-SPOSiteReview - -## SYNOPSIS - -This commands initiates the site review report. - -## SYNTAX - -```powershell -Start-SPOSiteReview -ReportID -SiteID [-Comment ] [] -``` - -## DESCRIPTION - -{{ Fill in the Description }} - -## EXAMPLES - -### Example 1 - -```powershell -PS C:\> {{ Add example code here }} -``` - -{{ Add example description here }} - -## PARAMETERS - -### -Comment - -{{ Fill Comment Description }} - -```yaml -Type: String -Parameter Sets: (All) -Aliases: - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -ReportID - -{{ Fill ReportID Description }} - -```yaml -Type: Guid -Parameter Sets: (All) -Aliases: - -Required: True -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - -### -SiteID - -{{ Fill SiteID Description }} - -```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