From 4d110f79802a8788521b7802ca93928868409c53 Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Fri, 15 Nov 2024 00:25:39 +0530 Subject: [PATCH 01/49] New PS commands for DAG --- .../Export-SPODataAccessGovernanceInsight.md | 64 +++++ .../Get-SPODataAccessGovernanceInsight.md | 122 +++++++++ .../sharepoint-online/Get-SPOSiteReview.md | 108 ++++++++ .../Remove-SPODataAccessGovernanceInsight.md | 95 +++++++ .../Start-SPODataAccessGovernanceInsight.md | 248 ++++++++++++++++++ .../sharepoint-online/Start-SPOSiteReview.md | 90 +++++++ 6 files changed, 727 insertions(+) create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md new file mode 100644 index 000000000..9e8c197c5 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -0,0 +1,64 @@ +--- +external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: +schema: 2.0.0 +--- + +# Export-SPODataAccessGovernanceInsight + +## SYNOPSIS + +This commands exports/downloads the DAG report to the default path "C:\WINDOWS\system32\" + +## SYNTAX + +``` +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-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md new file mode 100644 index 000000000..3053dbfe4 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -0,0 +1,122 @@ +--- +external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: +schema: 2.0.0 +--- + +# Get-SPODataAccessGovernanceInsight + +## SYNOPSIS + +Lists various reports available in 'Data Access Governance' module (DAG) in SharePoint Admin Center. + +## SYNTAX + +### GetAllReportsParameterSet +``` +Get-SPODataAccessGovernanceInsight -ReportEntity [-WorkLoad ] + [-ReportType ] [] +``` + +### GetReportParameterSet +``` +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-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md new file mode 100644 index 000000000..7eb7c3dcb --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md @@ -0,0 +1,108 @@ +--- +external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: +schema: 2.0.0 +--- + +# Get-SPOSiteReview + +## SYNOPSIS +Track all site access reviews initiated by all SharePoint admins + +## SYNTAX + +``` +Get-SPOSiteReview [-SiteReviewID ] [-Status ] + [-ReportEntity ] [-SiteID ] [] +``` + +## DESCRIPTION +This command fetches details of a particular access review or a group of access reviews as per the filtering criteria. + +## EXAMPLES + +### Example 1 +```powershell +PS C:\> Get-SPOSiteReview -ReportEntity PermissionedUsers +``` + +The above command retrieves all site access reviews raised under all permissioned user reports. + +## PARAMETERS + +### -ReportEntity +Specifies the 'potential oversharing' scenario that should be captured by the DAG report. + +```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 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md new file mode 100644 index 000000000..183b96b6e --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -0,0 +1,95 @@ +--- +external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: +schema: 2.0.0 +--- + +# Remove-SPODataAccessGovernanceInsight + +## SYNOPSIS + +This command deletes the given 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' 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/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md new file mode 100644 index 000000000..1890fdf5d --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -0,0 +1,248 @@ +--- +external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: +schema: 2.0.0 +--- + +# 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 for Business. 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 +``` +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 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 unqiue permissions), deduplicate and arrive at a unique number. Minumum 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-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md new file mode 100644 index 000000000..4cbcab147 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -0,0 +1,90 @@ +--- +external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: +schema: 2.0.0 +--- + +# Start-SPOSiteReview + +## SYNOPSIS +SharePoint admins 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 reports. Read all about site access review [here](/sharepoint/site-access-review). + +## SYNTAX + +``` +Start-SPOSiteReview -ReportID -SiteID [-Comment ] [] +``` + +## DESCRIPTION +Initiates 'site access review' request to the site owner under the context of the Data Access Governance report + +## 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" +``` + +Initiate site access review for the given site as per oversharing criteria mentioned in the Data Access Governance report. + +## PARAMETERS + +### -Comment +SharePoint admin 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 From d401318fd76fcfd9232f1321842e06f3b935d1ed Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Fri, 15 Nov 2024 15:26:25 +0530 Subject: [PATCH 02/49] Applied all changes suggested --- .../Export-SPODataAccessGovernanceInsight.md | 17 +++++++++++++---- .../Get-SPODataAccessGovernanceInsight.md | 12 ++++++++++-- .../sharepoint-online/Get-SPOSiteReview.md | 11 ++++++++++- .../Remove-SPODataAccessGovernanceInsight.md | 10 +++++++++- .../Start-SPODataAccessGovernanceInsight.md | 11 +++++++++-- 5 files changed, 51 insertions(+), 10 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md index 9e8c197c5..13c74c13c 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -3,13 +3,17 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 +author: pvrk +ms.author: pvrk +manager: +ms.reviewer: --- # Export-SPODataAccessGovernanceInsight ## SYNOPSIS -This commands exports/downloads the DAG report to the default path "C:\WINDOWS\system32\" +This cmdlet downloads the Data Access Governance (DAG) reports to the current working directory ## SYNTAX @@ -19,17 +23,17 @@ 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. +This cmdlet exports or downloads the DAG report, specified by the ReportID, to the current working directory. The ReportID is shown in the output of the 'Start-SPODataAccessGovernanceInsight' 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 +Export-SPODataAccessGovernanceInsight -ReportID 28f4c550-215a-472b-a123-c11e5fa8804c ``` -This command downloads the report of the given ID to the default path "C:\WINDOWS\system32\" +The above example downloads the report of the given ID to the current working directory ## PARAMETERS @@ -50,6 +54,7 @@ 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 @@ -59,6 +64,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS ### System.Object + ## NOTES ## RELATED LINKS + +[Get-SPODataAcccessGovernanceInsight](Get-SPODataAccessGovernanceInsight.md) +[Start-SPODataAccessGovernanceInsight](Start-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md index 3053dbfe4..c1a1bf963 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -3,6 +3,10 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 +author: pvrk +ms.author: pvrk +manager: +ms.reviewer: --- # Get-SPODataAccessGovernanceInsight @@ -33,10 +37,10 @@ Fetch details of various reports available in 'Data Access Governance' module (D ### Example 1 ```powershell -PS C:\> Get-SPODataAccessGovernanceInsight -ReportEntity EveryoneExceptExternalUsersForItems +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. +The above 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 @@ -117,6 +121,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS ### System.Object + ## NOTES ## RELATED LINKS + +[Start-SPODataAccessGovernanceInsight](Start-SPODataAccessGovernanceInsight.md) +[Export-SPODataAccessGovernanceInsight](Export-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md index 7eb7c3dcb..991ea6bde 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md @@ -3,6 +3,10 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 +author: pvrk +ms.author: pvrk +manager: +ms.reviewer: --- # Get-SPOSiteReview @@ -24,7 +28,7 @@ This command fetches details of a particular access review or a group of access ### Example 1 ```powershell -PS C:\> Get-SPOSiteReview -ReportEntity PermissionedUsers +Get-SPOSiteReview -ReportEntity PermissionedUsers ``` The above command retrieves all site access reviews raised under all permissioned user reports. @@ -103,6 +107,11 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS ### System.Object + ## NOTES ## RELATED LINKS + +[Start-SPOSiteReview](Start-SPOSiteReview.md) + +[Site access review for DAG reports](/sharepoint/site-access-review) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md index 183b96b6e..809438fa2 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -3,6 +3,10 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 +author: pvrk +ms.author: pvrk +manager: +ms.reviewer: --- # Remove-SPODataAccessGovernanceInsight @@ -26,7 +30,7 @@ This command deletes the DAG report, specified by the given ReportID. The Report ### Example 1 ```powershell -PS C:\> Remove-SPODataAccessGovernanceInsight -ReportID 28f4c550-215a-472b-a123-c11e5fa8804c +Remove-SPODataAccessGovernanceInsight -ReportID 28f4c550-215a-472b-a123-c11e5fa8804c ``` This command deletes the report of the given ID "28f4c550-215a-472b-a123-c11e5fa8804c" @@ -90,6 +94,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS ### System.Object + ## NOTES ## RELATED LINKS + +[Start-SPODataAccessGovernanceInsight](Start-SPODataAccessGovernanceInsight.md) +[Export-SPODataAccessGovernanceInsight](Export-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md index 1890fdf5d..4f10bfc8b 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -3,6 +3,10 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 +author: pvrk +ms.author: pvrk +manager: +ms.reviewer: --- # Start-SPODataAccessGovernanceInsight @@ -58,7 +62,7 @@ This command is used to generate reports, in Data Access Governance (DAG) module ### Example 1 ```powershell -PS C:\> Start-SPODataAccessGovernanceInsight -ReportEntity PermissionedUsers -Workload SharePoint -ReportType Snapshot -Name "OversharingBaselineReport" -CountOfUsersMoreThan 1000 +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. @@ -245,4 +249,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Data Access Governance reports for SharePoint admins](/sharepoint/data-access-governance-reports) +[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) \ No newline at end of file From d3bd9b55284c307966bbb456a24207378b1c031d Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 10:34:42 -0600 Subject: [PATCH 03/49] Create Set-SPORestrictedSiteCreation.md New Cmdlet for new RSC feature releasing at Ignite --- .../Set-SPORestrictedSiteCreation.md | 178 ++++++++++++++++++ 1 file changed, 178 insertions(+) create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md 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 000000000..09a8bd978 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md @@ -0,0 +1,178 @@ +--- +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-SPOSite +schema: 2.0.0 +author: vaibhav-gaddam +ms.author: vgaddam +ms.reviewer: +--- + +# 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 + +The Set-SPORestrictedSiteCreation cmdlet sets or updates the configuration or setting for the Restricted Site Creation feature. + +You must be a SharePoint Online administrator to run the cmdlet. + +For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). + +> [!Important] +> You must use version 16.0.25513 (published November 2024) or later of the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=35588) 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 of disabled 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 + +[Getting started with SharePoint Online Management Shell](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/connect-sharepoint-online?view=sharepoint-ps) + +[Set-SPORestrictedSiteCreation](Set-SPORestrictedSiteCreation.md) From e55e685e23a455a46e4fbc01f4ef4f05a168672d Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 10:41:53 -0600 Subject: [PATCH 04/49] Update Set-SPORestrictedSiteCreation.md --- .../sharepoint-online/Set-SPORestrictedSiteCreation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md index 09a8bd978..d81028f59 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md @@ -3,7 +3,7 @@ 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-SPOSite +title: Set-SPORestrictedSiteCreation schema: 2.0.0 author: vaibhav-gaddam ms.author: vgaddam From 9a7f6da2bbcf46c384c81609e979e02280ad4254 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 10:44:48 -0600 Subject: [PATCH 05/49] Update Set-SPORestrictedSiteCreation.md --- .../sharepoint-online/Set-SPORestrictedSiteCreation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md index d81028f59..e216f9e09 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md @@ -7,7 +7,7 @@ title: Set-SPORestrictedSiteCreation schema: 2.0.0 author: vaibhav-gaddam ms.author: vgaddam -ms.reviewer: +ms.reviewer: jmcdowe --- # Set-SPORestrictedSiteCreation From 1d87ef5b1c4f10470d326db77bb9cd51e6c96da0 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 10:45:25 -0600 Subject: [PATCH 06/49] Update Set-SPORestrictedSiteCreation.md --- .../sharepoint-online/Set-SPORestrictedSiteCreation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md index e216f9e09..d95af4b9f 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md @@ -5,7 +5,7 @@ online version: https://learn.microsoft.com/powershell/module/sharepoint-online/ applicable: SharePoint Online title: Set-SPORestrictedSiteCreation schema: 2.0.0 -author: vaibhav-gaddam +author: vgaddam-pm ms.author: vgaddam ms.reviewer: jmcdowe --- From bbad15e3be80a005a8fe32772980bf24874c8067 Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Sat, 16 Nov 2024 00:34:25 +0530 Subject: [PATCH 07/49] Incorporated all suggestions --- .openpublishing.redirection.json | 32 +------------------ .../Export-SPODataAccessGovernanceInsight.md | 14 ++++---- .../Get-SPODataAccessGovernanceInsight.md | 18 +++++------ .../sharepoint-online/Get-SPOSiteReview.md | 21 ++++++------ .../Remove-SPODataAccessGovernanceInsight.md | 16 +++++----- .../Start-SPODataAccessGovernanceInsight.md | 15 ++++----- .../sharepoint-online/Start-SPOSiteReview.md | 19 ++++++++--- 7 files changed, 56 insertions(+), 79 deletions(-) diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 2f937b9d8..9fcc5157d 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -5,21 +5,6 @@ "redirect_url": "/powershell/module/sharepoint-online", "redirect_document_id": false }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Export-SPODataAccessGovernanceInsight.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Get-SPODataAccessGovernanceInsight.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Get-SPOSiteReview.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, { "source_path": "sharepoint/virtual-folder/sharepoint-online/Get-SPOTenantRestrictedSearchAllowedList.md", "redirect_url": "/powershell/module/sharepoint-online", @@ -30,11 +15,6 @@ "redirect_url": "/powershell/module/sharepoint-online", "redirect_document_id": false }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, { "source_path": "sharepoint/virtual-folder/sharepoint-online/Remove-SPOTenantRestrictedSearchAllowedList.md", "redirect_url": "/powershell/module/sharepoint-online", @@ -44,16 +24,6 @@ "source_path": "sharepoint/virtual-folder/sharepoint-online/Set-SPOTenantRestrictedSearchMode.md", "redirect_url": "/powershell/module/sharepoint-online", "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Start-SPODataAccessGovernanceInsight.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - }, - { - "source_path": "sharepoint/virtual-folder/sharepoint-online/Start-SPOSiteReview.md", - "redirect_url": "/powershell/module/sharepoint-online", - "redirect_document_id": false - } + } ] } diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md index 13c74c13c..4303c9406 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -3,8 +3,8 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pvrk -ms.author: pvrk +author: pullabhk +ms.author: pullabhk manager: ms.reviewer: --- @@ -13,7 +13,7 @@ ms.reviewer: ## SYNOPSIS -This cmdlet downloads the Data Access Governance (DAG) reports to the current working directory +This cmdlet downloads the Data Access Governance (DAG) reports to the current working directory. ## SYNTAX @@ -23,7 +23,7 @@ Export-SPODataAccessGovernanceInsight -ReportID [] ## DESCRIPTION -This cmdlet exports or downloads the DAG report, specified by the ReportID, to the current working directory. The ReportID is shown in the output of the 'Start-SPODataAccessGovernanceInsight' command. It can also be fetched from the output of the 'Get-SPODataAccessGovernanceInsight' command. +This cmdlet exports or downloads the DAG report, specified by the `ReportID`, to the current working directory. The `ReportID` is shown in the output of the [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) command. It can also be fetched from the output of the [Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) command. ## EXAMPLES @@ -33,7 +33,7 @@ This cmdlet exports or downloads the DAG report, specified by the ReportID, to t Export-SPODataAccessGovernanceInsight -ReportID 28f4c550-215a-472b-a123-c11e5fa8804c ``` -The above example downloads the report of the given ID to the current working directory +The above example downloads the report of the given ID to the current working directory. ## PARAMETERS @@ -69,5 +69,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Get-SPODataAcccessGovernanceInsight](Get-SPODataAccessGovernanceInsight.md) -[Start-SPODataAccessGovernanceInsight](Start-SPODataAccessGovernanceInsight.md) +[Get-SPODataAcccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) +[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md index c1a1bf963..06831f60a 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -3,8 +3,8 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pvrk -ms.author: pvrk +author: pullabhk +ms.author: pullabhk manager: ms.reviewer: --- @@ -13,7 +13,7 @@ ms.reviewer: ## SYNOPSIS -Lists various reports available in 'Data Access Governance' module (DAG) in SharePoint Admin Center. +Lists various 'Data Access Governance' (DAG) reports in SharePoint admin center. ## SYNTAX @@ -30,7 +30,7 @@ Get-SPODataAccessGovernanceInsight -ReportID [] ## DESCRIPTION -Fetch details of various reports available in 'Data Access Governance' module (DAG) in SharePoint Admin Center +Fetch details of various Data Access Governance (DAG) reports available in SharePoint admin center. ## EXAMPLES @@ -40,13 +40,13 @@ Fetch details of various reports available in 'Data Access Governance' module (D Get-SPODataAccessGovernanceInsight -ReportEntity EveryoneExceptExternalUsersForItems ``` -The above 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. +The above cmdlet fetches all DAG reports about 'Everyone except external users' attached to a 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 'potential oversharing' scenario as captured by DAG report given during the report creation. +Specifies the entity that could cause oversharing and hence tracked by these reports. For eg: Sharing links, sharing with Everyone except external users, users with permissions etc. ```yaml Type: ReportEntityEnum @@ -79,7 +79,7 @@ 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 +Specifies the time period of data of the reports to be fetched i.e., fetch 'Snapshot' reports or 'RecentActivity' reports. ```yaml Type: ReportTypeEnum @@ -126,5 +126,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Start-SPODataAccessGovernanceInsight](Start-SPODataAccessGovernanceInsight.md) -[Export-SPODataAccessGovernanceInsight](Export-SPODataAccessGovernanceInsight.md) +[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) +[Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md index 991ea6bde..2df22d278 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md @@ -3,8 +3,8 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pvrk -ms.author: pvrk +author: pullabhk +ms.author: pullabhk manager: ms.reviewer: --- @@ -12,7 +12,7 @@ ms.reviewer: # Get-SPOSiteReview ## SYNOPSIS -Track all site access reviews initiated by all SharePoint admins +Track all site access reviews initiated by all SharePoint administrators in Data Access Governance (DAG) reports. ## SYNTAX @@ -22,21 +22,21 @@ Get-SPOSiteReview [-SiteReviewID ] [-Status ] ``` ## DESCRIPTION -This command fetches details of a particular access review or a group of access reviews as per the filtering criteria. +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 +Get-SPOSiteReview -ReportEntity PermissionedUsers ``` -The above command retrieves all site access reviews raised under all permissioned user reports. +The above cmdlet retrieves all site access reviews raised under all 'Permissioned user' snapshot reports. ## PARAMETERS ### -ReportEntity -Specifies the 'potential oversharing' scenario that should be captured by the DAG report. +Specifies the entity that could cause oversharing and hence tracked by these reports. For eg: Sharing links, sharing with Everyone except external users, users with permissions etc. ```yaml Type: SiteAccessReportEntityEnum @@ -67,7 +67,7 @@ Accept wildcard characters: False ``` ### -SiteReviewID -Specifies the ID of the particular access review +Specifies the ID of the particular access review. ```yaml Type: Guid @@ -82,7 +82,7 @@ Accept wildcard characters: False ``` ### -Status -Specifies the current status of the site access review +Specifies the current status of the site access review. ```yaml Type: SiteReviewStatus @@ -112,6 +112,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Start-SPOSiteReview](Start-SPOSiteReview.md) - +[Start-SPOSiteReview](./Start-SPOSiteReview.md) [Site access review for DAG reports](/sharepoint/site-access-review) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md index 809438fa2..0c3b646e6 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -3,8 +3,8 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pvrk -ms.author: pvrk +author: pullabhk +ms.author: pullabhk manager: ms.reviewer: --- @@ -13,7 +13,7 @@ ms.reviewer: ## SYNOPSIS -This command deletes the given DAG report +This cmdlet deletes the given Data Access Governance (DAG) report. ## SYNTAX @@ -23,7 +23,7 @@ Remove-SPODataAccessGovernanceInsight -ReportID [-WhatIf] [-Confirm] [ -Workload ## 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: +This cmdlet is used to generate Data Access Governance (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. @@ -65,7 +65,7 @@ This command is used to generate reports, in Data Access Governance (DAG) module 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. +The above cmdlet generates a list of SharePoint sites which can be accessed by more than 1000 users, as of report generation day. ## PARAMETERS @@ -152,7 +152,7 @@ Accept wildcard characters: False ### -ReportEntity -Specifies the 'potential oversharing' scenario that should be captured by the DAG report. +Specifies the entity that could cause oversharing and hence tracked by these reports. For eg: Sharing links, sharing with Everyone except external users, users with permissions etc. ```yaml Type: ReportEntityEnum @@ -251,5 +251,4 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [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) \ No newline at end of file +[Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md index 4cbcab147..7cc5e3751 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -3,12 +3,16 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 +author: pullabhk +ms.author: pullabhk +manager: +ms.reviewer: --- # Start-SPOSiteReview ## SYNOPSIS -SharePoint admins 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 reports. Read all about site access review [here](/sharepoint/site-access-review). +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 @@ -17,21 +21,22 @@ Start-SPOSiteReview -ReportID -SiteID [-Comment ] [ Start-SPOSiteReview -ReportID 03327d1c-38c5-4c32-9dad-85753a682d65 -SiteID a10f1997-71f2-4ef2-825e-2439400fc601 -comment "check for EEEU access" ``` -Initiate site access review for the given site as per oversharing criteria mentioned in the Data Access Governance report. +The above cmdlet initiates site access review for the given site as per oversharing criteria mentioned in the given DAG report. ## PARAMETERS ### -Comment -SharePoint admin to add comments to provide more context to the site owner regarding the purpose of the review. +SharePoint administrator to add comments to provide more context to the site owner regarding the purpose of the review. ```yaml Type: String @@ -61,7 +66,7 @@ Accept wildcard characters: False ``` ### -SiteID -Specifies the ID of the site for which site access review should be initiated +Specifies the ID of the site for which site access review should be initiated. ```yaml Type: Guid @@ -85,6 +90,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## OUTPUTS ### System.Object + ## NOTES ## RELATED LINKS + +[Get-SPOSiteReview](./Get-SPOSiteReview.md) +[Site access review for DAG reports](/sharepoint/site-access-review) From bb5b103c42fca5fb458d18b53b6b20b842569d64 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 13:19:09 -0600 Subject: [PATCH 08/49] Update Set-SPORestrictedSiteCreation.md Updating document according to Sam Kabue's comments. --- .../Set-SPORestrictedSiteCreation.md | 21 +++++++++---------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md index d95af4b9f..7e7870f27 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md @@ -30,11 +30,7 @@ Set-SPORestrictedSiteCreation ## DESCRIPTION -The Set-SPORestrictedSiteCreation cmdlet sets or updates the configuration or setting for the Restricted Site Creation feature. - -You must be a SharePoint Online administrator to run the cmdlet. - -For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). +This cmdlet sets or updates the configuration or setting for the Restricted Site Creation feature. > [!Important] > You must use version 16.0.25513 (published November 2024) or later of the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=35588) for these commands to function properly. Earlier versions do not have the current list of site types and will not operate correctly. @@ -47,7 +43,7 @@ For permissions and the most current information about Windows PowerShell for Sh Set-SPORestrictedSiteCreation –Enabled:$true ``` -Example 1`enables the restricted site creation feature for the tenant. +Example 1 enables the restricted site creation feature for the tenant. ### Example 2 @@ -75,7 +71,8 @@ Example 4 updates the policy for the `Team` site type to apply to members of the ### Example 5 ```powershell -Set-SPORestrictedSiteCreation –SiteType "OneDrive" -RestrictedSiteCreationGroups "" ``` +Set-SPORestrictedSiteCreation –SiteType "OneDrive" -RestrictedSiteCreationGroups "" +``` Example 5 clears the policy for the `OneDrive` site type so that it no longer applies to any users. @@ -84,7 +81,7 @@ Example 5 clears the policy for the `OneDrive` site type so that it no longer ap ### -Enabled PARAMVALUE: true | false -Enables of disabled Restricted Site Creation feature in tenant +Enables or disables Restricted Site Creation feature in tenant. ```yaml Type: Boolean @@ -122,7 +119,7 @@ Accept wildcard characters: False ### -SiteType -When paired with the –RestrictedSiteCreationGroups parameter, creates a new policy which applies to the specified types of sites. +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 @@ -146,7 +143,7 @@ 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. +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 @@ -173,6 +170,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Getting started with SharePoint Online Management Shell](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/connect-sharepoint-online?view=sharepoint-ps) +For permissions and the most current information about Windows PowerShell for SharePoint Online, see the online documentation at [Intro to SharePoint Online Management Shell](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). + +[Getting started with SharePoint Online Management Shell](https://learn.microsoft.com//powershell/sharepoint/sharepoint-online/connect-sharepoint-online) [Set-SPORestrictedSiteCreation](Set-SPORestrictedSiteCreation.md) From 40caab33b8704d182723210c3e9f3aca815ff723 Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Sat, 16 Nov 2024 01:02:54 +0530 Subject: [PATCH 09/49] Incorporated latest suggestions --- .../Export-SPODataAccessGovernanceInsight.md | 4 +- .../Get-SPODataAccessGovernanceInsight.md | 10 ++-- .../sharepoint-online/Get-SPOSiteReview.md | 6 +- .../Remove-SPODataAccessGovernanceInsight.md | 2 +- .../Start-SPODataAccessGovernanceInsight.md | 57 ++++++++++++------- .../sharepoint-online/Start-SPOSiteReview.md | 8 +-- 6 files changed, 53 insertions(+), 34 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md index 4303c9406..6b54c1be5 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -1,9 +1,9 @@ --- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Export-SPODataAccessGovernanceInsight](https://learn.microsoft.com/powershell/module/sharepoint-online/Export-SPODataAccessGovernanceInsight) Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pullabhk +author: pvrk ms.author: pullabhk manager: ms.reviewer: diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md index 06831f60a..a4a798786 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -1,9 +1,9 @@ --- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPODataAccessGovernanceInsight](https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPODataAccessGovernanceInsight) Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pullabhk +author: pvrk ms.author: pullabhk manager: ms.reviewer: @@ -30,7 +30,7 @@ Get-SPODataAccessGovernanceInsight -ReportID [] ## DESCRIPTION -Fetch details of various Data Access Governance (DAG) reports available in SharePoint admin center. +Fetch details of various DAG reports available in SharePoint admin center. ## EXAMPLES @@ -46,7 +46,7 @@ The above cmdlet fetches all DAG reports about 'Everyone except external users' ### -ReportEntity -Specifies the entity that could cause oversharing and hence tracked by these reports. For eg: Sharing links, sharing with Everyone except external users, users with permissions etc. +Specifies the entity that could cause oversharing and hence tracked by these reports. ```yaml Type: ReportEntityEnum @@ -79,7 +79,7 @@ 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. +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 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md index 2df22d278..e04b96cb5 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md @@ -1,9 +1,9 @@ --- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPOSiteReview](https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPOSiteReview) Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pullabhk +author: pvrk ms.author: pullabhk manager: ms.reviewer: @@ -36,7 +36,7 @@ The above cmdlet retrieves all site access reviews raised under all 'Permissione ## PARAMETERS ### -ReportEntity -Specifies the entity that could cause oversharing and hence tracked by these reports. For eg: Sharing links, sharing with Everyone except external users, users with permissions etc. +Specifies the entity that could cause oversharing and hence tracked by these reports. ```yaml Type: SiteAccessReportEntityEnum diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md index 0c3b646e6..13db98556 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -3,7 +3,7 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pullabhk +author: pvrk ms.author: pullabhk manager: ms.reviewer: diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md index 58646222c..1cc229891 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -3,7 +3,7 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pullabhk +author: pvrk ms.author: pullabhk manager: ms.reviewer: @@ -18,39 +18,58 @@ This cmdlet generates Data Access Governance (DAG) reports meant to provide insi ## SYNTAX ### EEEUParameterSet + ``` -Start-SPODataAccessGovernanceInsight -ReportEntity -Workload - -ReportType -Name - [-Template ] - [-Privacy ] [-SiteSensitivityLabelGUID ] - [] +Start-SPODataAccessGovernanceInsight +-ReportEntity +-Workload +-ReportType +-Name +[-Template ] +[-Privacy ] +[-SiteSensitivityLabelGUID ] +[] ``` ### SharingLinkParameterSet + ``` -Start-SPODataAccessGovernanceInsight -ReportEntity -Workload - -ReportType [] +Start-SPODataAccessGovernanceInsight +-ReportEntity +-Workload +-ReportType [] ``` ### LabelParameterSet + ``` -Start-SPODataAccessGovernanceInsight -ReportEntity -Workload - -ReportType [-FileSensitivityLabelName ] -FileSensitivityLabelGUID - [] +Start-SPODataAccessGovernanceInsight +-ReportEntity +-Workload +-ReportType +[-FileSensitivityLabelName ] +-FileSensitivityLabelGUID +[] ``` ### SitePermissionsParameterSet + ``` -Start-SPODataAccessGovernanceInsight -ReportEntity -Workload - -ReportType -Name - [-Template ] - [-Privacy ] [-SiteSensitivityLabelGUID ] - -CountOfUsersMoreThan [] +Start-SPODataAccessGovernanceInsight +-ReportEntity +-Workload +-ReportType +-Name +[-Template ] +[-Privacy ] +[-SiteSensitivityLabelGUID ] +-CountOfUsersMoreThan +[] ``` ## DESCRIPTION -This cmdlet is used to generate Data Access Governance (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: +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. @@ -152,7 +171,7 @@ Accept wildcard characters: False ### -ReportEntity -Specifies the entity that could cause oversharing and hence tracked by these reports. For eg: Sharing links, sharing with Everyone except external users, users with permissions etc. +Specifies the entity that could cause oversharing and hence tracked by these reports. ```yaml Type: ReportEntityEnum @@ -169,7 +188,7 @@ 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. +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 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md index 7cc5e3751..073511196 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -3,7 +3,7 @@ external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 -author: pullabhk +author: pvrk ms.author: pullabhk manager: ms.reviewer: @@ -12,7 +12,7 @@ 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). +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 @@ -21,7 +21,7 @@ Start-SPOSiteReview -ReportID -SiteID [-Comment ] [ Date: Sat, 16 Nov 2024 01:08:45 +0530 Subject: [PATCH 10/49] Corrected help file links --- .../sharepoint-online/Remove-SPODataAccessGovernanceInsight.md | 2 +- .../sharepoint-online/Start-SPODataAccessGovernanceInsight.md | 2 +- .../sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md index 13db98556..32b9c212b 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Remove-SPODataAccessGovernanceInsight](https://learn.microsoft.com/powershell/module/sharepoint-online/Remove-SPODataAccessGovernanceInsight) Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md index 1cc229891..5bd70d9be 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPODataAccessGovernanceInsight](https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPODataAccessGovernanceInsight) Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md index 073511196..7acc0867d 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -1,5 +1,5 @@ --- -external help file: Microsoft.Online.SharePoint.PowerShell.dll-Help.xml +external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPOSiteReview](https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPOSiteReview) Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 From c603121dbc0eb0f95f3edd05ac98edb1b99adb0e Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 16:12:28 -0600 Subject: [PATCH 11/49] Create Get-SPORestrictedSiteCreation Adding Get-SPORestrictedSiteCreation Cmdlet for Restricted Site Creation Feature. --- .../Get-SPORestrictedSiteCreation | 78 +++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation new file mode 100644 index 000000000..3530ba0d4 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation @@ -0,0 +1,78 @@ +--- +external help file: sharepointonline.xml +Module Name: Microsoft.Online.SharePoint.PowerShell +online version: https://learn.microsoft.com/powershell/module/sharepoint-online/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 command 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 (published November 2024) or later of the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=3558) 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](https://learn.microsoft.com/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). From 6995e4be020630bb7d467e30e87e91b30b6ef6d8 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 17:56:20 -0600 Subject: [PATCH 12/49] Update Get-SPORestrictedSiteCreation --- .../sharepoint-online/Get-SPORestrictedSiteCreation | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation index 3530ba0d4..c488d7585 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation @@ -19,13 +19,12 @@ This cmdlet allows SharePoint administrators to check the current configuration ## SYNTAX ```powershell -Get-SPORestrictedSiteCreation - [-SiteType ] +Get-SPORestrictedSiteCreation [-SiteType ] ``` ## DESCRIPTION -This command obtains the current configuration information for the restricted site creation feature, including whether it is enabled, the current mode, and the current policies. +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 (published November 2024) or later of the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=3558) for these commands to function properly. Earlier versions do not have the current list of site types and will not operate correctly. @@ -73,6 +72,6 @@ Accept wildcard characters: False ## RELATED LINKS -[Getting started with SharePoint Online Management Shell](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) +[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). From 78ce8f92733be612fc9ad4480dc146852e5857c2 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 17:57:12 -0600 Subject: [PATCH 13/49] Rename Get-SPORestrictedSiteCreation to Get-SPORestrictedSiteCreation.md --- ...SPORestrictedSiteCreation => Get-SPORestrictedSiteCreation.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename sharepoint/sharepoint-ps/sharepoint-online/{Get-SPORestrictedSiteCreation => Get-SPORestrictedSiteCreation.md} (100%) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md similarity index 100% rename from sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation rename to sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md From 1ad2dc1133c2a7719adbe4c5590e0815de8635d9 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 17:59:40 -0600 Subject: [PATCH 14/49] Update Set-SPORestrictedSiteCreation.md Fixed related links --- .../sharepoint-online/Set-SPORestrictedSiteCreation.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md index 7e7870f27..76886a2c1 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md @@ -170,8 +170,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## 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](https://learn.microsoft.com/powershell/sharepoint/sharepoint-online/introduction-sharepoint-online-management-shell?view=sharepoint-ps). +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](https://learn.microsoft.com//powershell/sharepoint/sharepoint-online/connect-sharepoint-online) +[Getting started with SharePoint Online Management Shell](/powershell/sharepoint/sharepoint-online/connect-sharepoint-online) [Set-SPORestrictedSiteCreation](Set-SPORestrictedSiteCreation.md) From 6e1c7f982f1f0ee6883b993dfc3db4eb454570b0 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Fri, 15 Nov 2024 20:31:44 -0600 Subject: [PATCH 15/49] Update Get-SPORestrictedSiteCreation.md Updated link for SharePoint Online Management Shell Download --- .../sharepoint-online/Get-SPORestrictedSiteCreation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md index c488d7585..80dc08448 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md @@ -27,7 +27,7 @@ Get-SPORestrictedSiteCreation [-SiteType ] 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 (published November 2024) or later of the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=3558) for these commands to function properly. Earlier versions do not have the current list of site types and will not operate correctly. +>You must use version 16.0.25513 (published November 2024) or later of the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=35588&msockid=3bc54cadb1bd648039325ff4b0b5653a) for these commands to function properly. Earlier versions do not have the current list of site types and will not operate correctly. ## EXAMPLES From 741cf2e004ffd3604593d51557c74441169bde00 Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Sat, 16 Nov 2024 10:16:01 +0530 Subject: [PATCH 16/49] Help file links modified --- .../sharepoint-online/Export-SPODataAccessGovernanceInsight.md | 2 +- .../sharepoint-online/Get-SPODataAccessGovernanceInsight.md | 2 +- sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md | 2 +- .../sharepoint-online/Remove-SPODataAccessGovernanceInsight.md | 2 +- .../sharepoint-online/Start-SPODataAccessGovernanceInsight.md | 2 +- .../sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md index 6b54c1be5..c36cfd41b 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Export-SPODataAccessGovernanceInsight](https://learn.microsoft.com/powershell/module/sharepoint-online/Export-SPODataAccessGovernanceInsight) +external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Export-SPODataAccessGovernanceInsight Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md index a4a798786..38b41de03 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPODataAccessGovernanceInsight](https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPODataAccessGovernanceInsight) +external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPODataAccessGovernanceInsight Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md index e04b96cb5..58aecd916 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md @@ -1,5 +1,5 @@ --- -external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPOSiteReview](https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPOSiteReview) +external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPOSiteReview Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md index 32b9c212b..cfc6c2c8d 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Remove-SPODataAccessGovernanceInsight](https://learn.microsoft.com/powershell/module/sharepoint-online/Remove-SPODataAccessGovernanceInsight) +external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Remove-SPODataAccessGovernanceInsight Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md index 5bd70d9be..655298dc1 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPODataAccessGovernanceInsight](https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPODataAccessGovernanceInsight) +external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPODataAccessGovernanceInsight Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md index 7acc0867d..7687e5f32 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -1,5 +1,5 @@ --- -external help file: [https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPOSiteReview](https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPOSiteReview) +external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPOSiteReview Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 From 633b676b957f5dece87360f1dfc7400a21a3ad7c Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Tue, 19 Nov 2024 23:30:24 +0530 Subject: [PATCH 17/49] Fixed external help files --- .../sharepoint-online/Export-SPODataAccessGovernanceInsight.md | 2 +- .../sharepoint-online/Get-SPODataAccessGovernanceInsight.md | 2 +- sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md | 2 +- .../sharepoint-online/Remove-SPODataAccessGovernanceInsight.md | 2 +- .../sharepoint-online/Start-SPODataAccessGovernanceInsight.md | 2 +- .../sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md index c36cfd41b..f25d4472d 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Export-SPODataAccessGovernanceInsight +external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md index 38b41de03..9b6dfbc46 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPODataAccessGovernanceInsight +external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md index 58aecd916..3a39e2b53 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md @@ -1,5 +1,5 @@ --- -external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Get-SPOSiteReview +external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md index cfc6c2c8d..629164c43 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Remove-SPODataAccessGovernanceInsight +external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md index 655298dc1..3674cdc3f 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -1,5 +1,5 @@ --- -external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPODataAccessGovernanceInsight +external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md index 7687e5f32..442e1c723 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -1,5 +1,5 @@ --- -external help file: https://learn.microsoft.com/powershell/module/sharepoint-online/Start-SPOSiteReview +external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell online version: schema: 2.0.0 From 097ee5dd8f0de9ebc9b22463a5b331e791512ba3 Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Fri, 22 Nov 2024 16:06:52 +0530 Subject: [PATCH 18/49] Addressed all comments --- .../Export-SPODataAccessGovernanceInsight.md | 11 +++++++++-- .../Get-SPODataAccessGovernanceInsight.md | 10 +++++++--- .../sharepoint-online/Get-SPOSiteReview.md | 14 ++++++++++---- .../Remove-SPODataAccessGovernanceInsight.md | 5 ++++- .../Start-SPODataAccessGovernanceInsight.md | 10 +++++++++- .../sharepoint-online/Start-SPOSiteReview.md | 11 +++++++++-- 6 files changed, 48 insertions(+), 13 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md index f25d4472d..d4674343c 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -1,7 +1,9 @@ --- external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell -online version: +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 @@ -69,5 +71,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Get-SPODataAcccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) + +[Get-SPODataAcccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) + +[Start-SPOSiteReview](./Start-SPOSiteReview.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md index 9b6dfbc46..acf73bdbd 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -1,7 +1,9 @@ --- external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell -online version: +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 @@ -19,8 +21,7 @@ Lists various 'Data Access Governance' (DAG) reports in SharePoint admin center. ### GetAllReportsParameterSet ``` -Get-SPODataAccessGovernanceInsight -ReportEntity [-WorkLoad ] - [-ReportType ] [] +Get-SPODataAccessGovernanceInsight -ReportEntity [-WorkLoad ] [-ReportType ] [] ``` ### GetReportParameterSet @@ -127,4 +128,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) + [Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md index 3a39e2b53..1d2232ada 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md @@ -1,7 +1,9 @@ --- external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell -online version: +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 @@ -12,13 +14,12 @@ ms.reviewer: # Get-SPOSiteReview ## SYNOPSIS -Track all site access reviews initiated by all SharePoint administrators in Data Access Governance (DAG) reports. +Track all site access reviews initiated from Data Access Governance (DAG) reports. ## SYNTAX ``` -Get-SPOSiteReview [-SiteReviewID ] [-Status ] - [-ReportEntity ] [-SiteID ] [] +Get-SPOSiteReview [-SiteReviewID ] [-Status ] [-ReportEntity ] [-SiteID ] [] ``` ## DESCRIPTION @@ -113,4 +114,9 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS [Start-SPOSiteReview](./Start-SPOSiteReview.md) + [Site access review for DAG reports](/sharepoint/site-access-review) + +[Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) + +[Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md index 629164c43..f59486693 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -1,7 +1,9 @@ --- external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell -online version: +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 @@ -100,4 +102,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) + [Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md index 3674cdc3f..cc77f1be2 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -1,7 +1,9 @@ --- external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell -online version: +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 @@ -269,5 +271,11 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## 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) + +[Start-SPOSiteReview](./Start-SPOSiteReview.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md index 442e1c723..c2756bf63 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -1,7 +1,9 @@ --- external help file: sharepointonline.xml Module Name: Microsoft.Online.SharePoint.PowerShell -online version: +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 @@ -95,5 +97,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Get-SPOSiteReview](./Get-SPOSiteReview.md) [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) From f4228946556da40fbdce401d8a3063cd88a97609 Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Sat, 23 Nov 2024 01:44:08 +0530 Subject: [PATCH 19/49] Standardized all related links and corrected description --- .../Export-SPODataAccessGovernanceInsight.md | 2 ++ .../Get-SPODataAccessGovernanceInsight.md | 6 +++++- .../sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md | 8 ++++++-- .../Remove-SPODataAccessGovernanceInsight.md | 6 ++++++ .../Start-SPODataAccessGovernanceInsight.md | 4 ++++ .../sharepoint-online/Start-SPOSiteReview.md | 4 ++++ 6 files changed, 27 insertions(+), 3 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md index d4674343c..28a69576a 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -78,3 +78,5 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) [Start-SPOSiteReview](./Start-SPOSiteReview.md) + +[Get-SPOSiteReview](./Get-SPOSiteReview.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md index acf73bdbd..6d938f257 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -31,7 +31,7 @@ Get-SPODataAccessGovernanceInsight -ReportID [] ## DESCRIPTION -Fetch details of various DAG reports available in SharePoint admin center. +This cmdlet fetches details of various DAG reports available in SharePoint admin center. ## EXAMPLES @@ -132,3 +132,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) [Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) + +[Start-SPOSiteReview](./Start-SPOSiteReview.md) + +[Get-SPOSiteReview](./Get-SPOSiteReview.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md index 1d2232ada..779f44aa5 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOSiteReview.md @@ -113,10 +113,14 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable ## RELATED LINKS -[Start-SPOSiteReview](./Start-SPOSiteReview.md) - [Site access review for DAG reports](/sharepoint/site-access-review) +[Start-SPOSiteReview](./Start-SPOSiteReview.md) + [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) [Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) + +[Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md index f59486693..69d60e9af 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Remove-SPODataAccessGovernanceInsight.md @@ -103,4 +103,10 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [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/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md index cc77f1be2..61334eda2 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -278,4 +278,8 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [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 index c2756bf63..08c4d18d9 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -104,3 +104,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) [Export-SPODataAccessGovernanceInsight](./Export-SPODataAccessGovernanceInsight.md) + +[Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) + +[Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) From 9204f790229ec8383830a70d61ce9b53b872599b Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Sat, 23 Nov 2024 03:04:35 +0530 Subject: [PATCH 20/49] Update Export-SPODataAccessGovernanceInsight.md --- .../sharepoint-online/Export-SPODataAccessGovernanceInsight.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md index 28a69576a..39134b1c1 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -73,7 +73,7 @@ This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) -[Get-SPODataAcccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) +[Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) [Remove-SPODataAccessGovernanceInsight](./Remove-SPODataAccessGovernanceInsight.md) From d88935a28a7fd0a525b6cadfc12eef2fece45472 Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Sat, 23 Nov 2024 03:35:02 +0530 Subject: [PATCH 21/49] Update Get-SPODataAccessGovernanceInsight.md --- .../sharepoint-online/Get-SPODataAccessGovernanceInsight.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md index 6d938f257..e9fda4b93 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPODataAccessGovernanceInsight.md @@ -41,7 +41,7 @@ This cmdlet fetches details of various DAG reports available in SharePoint admin Get-SPODataAccessGovernanceInsight -ReportEntity EveryoneExceptExternalUsersForItems ``` -The above cmdlet fetches all DAG reports about 'Everyone except external users' attached to a 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. +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 From ab95f333316f00f36bf67d565cd99f1f40301286 Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Sat, 23 Nov 2024 03:41:21 +0530 Subject: [PATCH 22/49] Update Start-SPODataAccessGovernanceInsight.md --- .../sharepoint-online/Start-SPODataAccessGovernanceInsight.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md index 61334eda2..6f5ea22c2 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPODataAccessGovernanceInsight.md @@ -92,7 +92,7 @@ The above cmdlet generates a list of SharePoint sites which can be accessed by m ### -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. Minumum value is 100. +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 @@ -156,7 +156,7 @@ Accept wildcard characters: False ### -Privacy -Specifies the privacy setting of the 0365 group. Relevant in case of filtering the report for group connected sites. +Specifies the privacy setting of the Microsoft 365 group. Relevant in case of filtering the report for group connected sites. ```yaml Type: PrivacyEnum From 239e17ce6ad3dc9c4f4fe5fd06cbeae22cf52f0b Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Sat, 23 Nov 2024 03:46:47 +0530 Subject: [PATCH 23/49] Update Start-SPOSiteReview.md --- .../sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md index 08c4d18d9..2590c4b40 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOSiteReview.md @@ -23,7 +23,7 @@ Start-SPOSiteReview -ReportID -SiteID [-Comment ] [ Date: Tue, 26 Nov 2024 13:15:49 -0800 Subject: [PATCH 24/49] Update Set-SPOCopilotPromoOptInStatus.md --- .../sharepoint-online/Set-SPOCopilotPromoOptInStatus.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md index 65f5aad5e..6123cede6 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md @@ -29,7 +29,7 @@ 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`. From 8bab893a972df99324e35bbbdd0257b4e4a1063b Mon Sep 17 00:00:00 2001 From: arakeshmicrosoft <132292644+arakeshmicrosoft@users.noreply.github.com> Date: Wed, 27 Nov 2024 07:20:32 -0800 Subject: [PATCH 25/49] Set-SPOCopilotPromoOptInStatus.md Removing an awkward empty parameter box. --- .../sharepoint-online/Set-SPOCopilotPromoOptInStatus.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md index 6123cede6..3b39bdae3 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md @@ -34,8 +34,6 @@ Set-SPOCopilotPromoOptInStatus -IsCopilotPromoStatusEnabled $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. From d528a84c9f443ec4c6e17e2e8e0a1d7e332e880d Mon Sep 17 00:00:00 2001 From: Swathi Iruvanti Date: Wed, 27 Nov 2024 10:42:03 -0800 Subject: [PATCH 26/49] Update Get-SPOCopilotPromoOptInStatus.md --- .../sharepoint-online/Get-SPOCopilotPromoOptInStatus.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md index d7610ec52..06db8f673 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotPromoOptInStatus.md @@ -31,7 +31,7 @@ If the promo status is enabled, the return value is `True`, otherwise the return ### Example 1 ```powershell -Get-SPOCopilotPromoOptInStatusEnabled +Get-SPOCopilotPromoOptInStatus ``` Example 1 returns the value of the Opt-In promo status. From 53f955de8dbdd28f45a2476609d8e5204c93dc99 Mon Sep 17 00:00:00 2001 From: Supreet Singh Date: Mon, 2 Dec 2024 12:46:47 +0530 Subject: [PATCH 27/49] Add docs for Disabled ace ids --- .../sharepoint-online/Set-SPOTenant.md | 23 +++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md index ea19d7fa2..85958863c 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md @@ -56,6 +56,7 @@ Set-SPOTenant [-DefaultLinkPermission ] [-DefaultSharingLinkType ] [-DisabledWebPartIds ] + [-DisabledAdaptiveCardExtensionIds ] [-DisallowInfectedFileDownload ] [-DisableAddShortcutsToOneDrive ] [-EnableGuestSignInAcceleration ] @@ -1094,6 +1095,28 @@ 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: + +- Power Apps: 0d2d0fd0-9489-47ef-acfb-90edca009cba + +To disable a specific Adaptive Card Extension, you need to enter its GUID as the parameter. For example Set-SPOTenant -DisabledAdaptiveCardExtensionIds 0d2d0fd0-9489-47ef-acfb-90edca009cba. To view a list of disabled Adaptive Card Extensions, use Get-SPOTenant 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. From 8e031544f97bffd8151297ec8ca1d4a359ab55a2 Mon Sep 17 00:00:00 2001 From: Supreet Singh Date: Wed, 4 Dec 2024 09:17:45 +0530 Subject: [PATCH 28/49] address comments --- .../sharepoint-online/Set-SPOTenant.md | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md index 85958863c..030903124 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md @@ -55,8 +55,8 @@ Set-SPOTenant [-SocialBarOnSitePagesDisabled ] [-DefaultLinkPermission ] [-DefaultSharingLinkType ] - [-DisabledWebPartIds ] - [-DisabledAdaptiveCardExtensionIds ] + [-DisabledWebPartIds [Guid[]]] + [-DisabledAdaptiveCardExtensionIds [Guid[]]] [-DisallowInfectedFileDownload ] [-DisableAddShortcutsToOneDrive ] [-EnableGuestSignInAcceleration ] @@ -364,6 +364,13 @@ Set-SPOTenant –WhoCanShareAnonymousAllowList @() This example empties the WhoCanShareAnonymousAllowList. Similar code works for the WhoCanShareAuthenticatedGuestAllowList. +### EXAMPLE 21 +```powershell +Set-SPOTenant -DisabledAdaptiveCardExtensionIds 0d2d0fd0-9489-47ef-acfb-90edca009cba +``` + +This example disables the Power Apps Adaptive Card Extension. + ## PARAMETERS ### -ApplyAppEnforcedRestrictionsToAdHocRecipients @@ -1101,9 +1108,9 @@ Allows administrators to prevent certain Adaptive Card Extensions from being add - Power Apps: 0d2d0fd0-9489-47ef-acfb-90edca009cba -To disable a specific Adaptive Card Extension, you need to enter its GUID as the parameter. For example Set-SPOTenant -DisabledAdaptiveCardExtensionIds 0d2d0fd0-9489-47ef-acfb-90edca009cba. To view a list of disabled Adaptive Card Extensions, use Get-SPOTenant to get DisabledAdaptiveCardExtensionIds. +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 @(). +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[] From 53c8a48b8a8366f495dfd3b1c0c9a334a7c2a6d7 Mon Sep 17 00:00:00 2001 From: Supreet Singh Date: Wed, 4 Dec 2024 09:39:00 +0530 Subject: [PATCH 29/49] convert to table --- sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md index 030903124..b65e601ec 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOTenant.md @@ -1106,7 +1106,9 @@ Accept wildcard characters: False 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: -- Power Apps: 0d2d0fd0-9489-47ef-acfb-90edca009cba +| 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`. From 75119941aae1cc7dd75024a5653a72b6ea40002e Mon Sep 17 00:00:00 2001 From: arakeshmicrosoft <132292644+arakeshmicrosoft@users.noreply.github.com> Date: Wed, 4 Dec 2024 08:31:19 -0800 Subject: [PATCH 30/49] Set-SPOCopilotPromoOptInStatus.md Added ## PARAMETERS --- .../sharepoint-online/Set-SPOCopilotPromoOptInStatus.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md index 3b39bdae3..cdbab776f 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOCopilotPromoOptInStatus.md @@ -34,6 +34,8 @@ Set-SPOCopilotPromoOptInStatus -IsCopilotPromoStatusEnabled $true Example 1 sets the Opt-In Copilot promo status for the tenant to `True`. +## PARAMETERS + ### -IsCopilotPromoStatusEnabled Use this parameter to set Copilot opt-in promo status. From f98c99851fde7998b43ed77e7ae99977176da754 Mon Sep 17 00:00:00 2001 From: Gary Moore <5432776+garycentric@users.noreply.github.com> Date: Wed, 4 Dec 2024 11:47:31 -0800 Subject: [PATCH 31/49] Correct invisible content (disallowed-html-tag) When the build interprets something like "" as an HTML tag that's disallowed, it does not include that content in the rendered page. One way to solve that is to add backslashes before the angle brackets. --- .../sharepoint-online/Revoke-SPOUserSession.md | 6 +++--- .../sharepoint-online/Set-SPOMigrationPackageAzureSource.md | 4 ++-- .../sharepoint-online/Unregister-SPOHubSite.md | 2 +- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Revoke-SPOUserSession.md b/sharepoint/sharepoint-ps/sharepoint-online/Revoke-SPOUserSession.md index 831dfc114..97a1fa61e 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-SPOMigrationPackageAzureSource.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPOMigrationPackageAzureSource.md index 0ba1ad73f..a2d682131 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/Unregister-SPOHubSite.md b/sharepoint/sharepoint-ps/sharepoint-online/Unregister-SPOHubSite.md index 0349fcf07..db9b88ce2 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 From 478c524491a519181aefbc40f340e724b0692f57 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Wed, 4 Dec 2024 17:00:51 -0600 Subject: [PATCH 32/49] Update Set-SPORestrictedSiteCreation.md Add relative link + update full build number --- .../sharepoint-online/Set-SPORestrictedSiteCreation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md index 76886a2c1..8b26c8f29 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md @@ -33,7 +33,7 @@ Set-SPORestrictedSiteCreation This cmdlet sets or updates the configuration or setting for the Restricted Site Creation feature. > [!Important] -> You must use version 16.0.25513 (published November 2024) or later of the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=35588) for these commands to function properly. Earlier versions do not have the current list of site types and will not operate correctly. +> 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 From 00d1b836ff8fff5fc6bd3b3eba89e214497144ed Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Wed, 4 Dec 2024 17:00:59 -0600 Subject: [PATCH 33/49] Update Get-SPORestrictedSiteCreation.md Add relative link + update full build number --- .../sharepoint-online/Get-SPORestrictedSiteCreation.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md index 80dc08448..ce1fc548e 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPORestrictedSiteCreation.md @@ -27,7 +27,7 @@ Get-SPORestrictedSiteCreation [-SiteType ] 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 (published November 2024) or later of the [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=35588&msockid=3bc54cadb1bd648039325ff4b0b5653a) for these commands to function properly. Earlier versions do not have the current list of site types and will not operate correctly. +>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 From 5e8a643cdd3f9a9ad0097b155d9286ed11852710 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Thu, 5 Dec 2024 13:10:46 -0600 Subject: [PATCH 34/49] Update sharepoint-online.md --- .../sharepoint-ps/sharepoint-online/sharepoint-online.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md b/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md index d7f698ffb..94aec9fde 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md @@ -175,6 +175,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}} From d22c63898178d02ef22b1e7a1457da8d299477f7 Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Thu, 5 Dec 2024 13:13:26 -0600 Subject: [PATCH 35/49] Update sharepoint-online.md --- .../sharepoint-ps/sharepoint-online/sharepoint-online.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md b/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md index d7f698ffb..84392b1fd 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md @@ -540,6 +540,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}} From ec78d611c13a7f5bafaad390ba838044aca17c82 Mon Sep 17 00:00:00 2001 From: Shweta Bhagat Date: Tue, 10 Dec 2024 18:07:23 +0530 Subject: [PATCH 36/49] add documentation for Copilot Insights Cmdlets Add public documentation for Copilot Insights Cmdlets --- .../Get-SPOCopilotAgentInsightsReport.md | 165 ++++++++++++++++++ .../Start-SPOCopilotAgentInsightsReport.md | 99 +++++++++++ 2 files changed, 264 insertions(+) create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md create mode 100644 sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.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 000000000..4c9c279e7 --- /dev/null +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md @@ -0,0 +1,165 @@ +--- +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 + + + +## 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 the report creation was triggered in UTC. | +| Status | The status of the report. | +| ReportPeriodInDays | The report duration in days. | + +If this cmdlet is executed with `-ReportId` as parameter and `-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 last N 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 | RAC status (Yes/No) of the SharePoint site. | +| Restrict site discovery | RCD 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 last N 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 | RAC status (Yes/No) of the SharePoint site. | +| Restrict site discovery | RCD 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 last N 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 | Name of Copilot agent on the SharePoint site corresponding to that particular site template. | + +If this cmdlet is executed with both the parameters, i.e. `-ReportId` and `-Action`, and if the value of `-Action` is set as `View`, it will display the same result as described above. If the value of `-Action` is set to `Download`, it will download the full report in CSV format to the same path from where the command was run. + +> [!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 insights 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 insights report of ReportId: `9d946216-afe7-49f5-8267-7b662435c70b` to the same path from where the command was run. + +## PARAMETERS + +### -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 +``` + +### -Content + +It is an optional parameter, and it specifies the kind of report to view or download. There are 3 kinds of sub-reports: CopilotAgentsOnSites, TopSites, SiteDistribution. + +```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 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-SPOCopilotAgentInsightsReport](./Start-SPOCopilotAgentInsightsReport.md) \ No newline at end of file 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 000000000..8ddee7526 --- /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 + +This cmdlet enables administrator to trigger the build of a new Copilot Agent Insight report for the last N days. + +## SYNTAX + +```powershell +Start-SPOCopilotAgentInsightsReport [-ReportPeriodInDays ] [-Force ] +``` + +## DESCRIPTION + +After this cmdlet is executed, the Copilot Agent Insight report generation request for the last N 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 the report creation was triggered in UTC. | +| Status | The status of the report. | +| ReportPeriodInDays | The report duration in days. | + +## EXAMPLES + +### -----------------------EXAMPLE 1----------------------------- + +```powershell +Start-SPOCopilotAgentInsightsReport +``` + +Example 1 generates the Copilot agent insights report for a default duration of 1 day as the parameter `–ReportPeriodInDays` is not provided. + +### -----------------------EXAMPLE 2----------------------------- + +```powershell +Start-SPOCopilotAgentInsightsReport –ReportPeriodInDays 14 +``` + +Example 2 generates the Copilot Agent insights report for a specified duration of 14 days. + +## PARAMETERS + +### -ReportPeriodInDays + +It is an optional parameter, and it specifies the duration of the Copilot Agent insights 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: 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-SPOCopilotAgentInsightsReport](./Get-SPOCopilotAgentInsightsReport.md) \ No newline at end of file From d68ffa857f40fe72058d09fb57a0584e08a171bc Mon Sep 17 00:00:00 2001 From: Shweta Bhagat Date: Wed, 11 Dec 2024 10:38:09 +0530 Subject: [PATCH 37/49] resolve comments --- .../Get-SPOCopilotAgentInsightsReport.md | 86 +++++++++---------- .../Start-SPOCopilotAgentInsightsReport.md | 22 ++--- 2 files changed, 53 insertions(+), 55 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md index 4c9c279e7..e227d04a3 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md @@ -15,7 +15,7 @@ manager: hikakar ## 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 @@ -34,44 +34,6 @@ If this cmdlet is executed without any parameters, it displays the status of all | Status | The status of the report. | | ReportPeriodInDays | The report duration in days. | -If this cmdlet is executed with `-ReportId` as parameter and `-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 last N 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 | RAC status (Yes/No) of the SharePoint site. | -| Restrict site discovery | RCD 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 last N 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 | RAC status (Yes/No) of the SharePoint site. | -| Restrict site discovery | RCD 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 last N 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 | Name of Copilot agent on the SharePoint site corresponding to that particular site template. | - -If this cmdlet is executed with both the parameters, i.e. `-ReportId` and `-Action`, and if the value of `-Action` is set as `View`, it will display the same result as described above. If the value of `-Action` is set to `Download`, it will download the full report in CSV format to the same path from where the command was run. - > [!NOTE] > All reports adhere to any retention timeline as per [Data Access Governance](/sharepoint/data-access-governance-reports). @@ -91,7 +53,7 @@ Example 1 enables administrator to view the status of all active and completed r Get-SPOCopilotAgentInsightsReport –ReportId 9d946216-afe7-49f5-8267-7b662435c70b ``` -Example 2 enables administrator to view the Copilot agent insights report of 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----------------------------- @@ -99,13 +61,13 @@ Example 2 enables administrator to view the Copilot agent insights report of Rep Get-SPOCopilotAgentInsightsReport – ReportId 9d946216-afe7-49f5-8267-7b662435c70b -Action Download ``` -Example 3 enables administrator to download the Copilot agent insights report of ReportId: `9d946216-afe7-49f5-8267-7b662435c70b` to the same path from where the command was run. +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 is an optional parameter, and it specifies the unique Id of the report to be viewed or downloaded. +It specifies the unique Id of the report to be viewed or downloaded. ```yaml Type: Guid @@ -122,7 +84,43 @@ Accept wildcard characters: False ### -Content -It is an optional parameter, and it specifies the kind of report to view or download. There are 3 kinds of sub-reports: CopilotAgentsOnSites, TopSites, SiteDistribution. +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 | RAC status (Yes/No) of the SharePoint site. | +| Restrict site discovery | RCD 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 | RAC status (Yes/No) of the SharePoint site. | +| Restrict site discovery | RCD 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 | Name of Copilot agent on the SharePoint site corresponding to that particular site template. | ```yaml Type: SPOCopilotAgentInsightType @@ -139,7 +137,7 @@ Accept wildcard characters: False ### -Action -It is an optional parameter, and it specifies whether to view or download a specific report. +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 diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md index 8ddee7526..e52ca3cec 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md @@ -15,7 +15,7 @@ manager: hikakar ## SYNOPSIS -This cmdlet enables administrator to trigger the build of a new Copilot Agent Insight report for the last N days. +Using this commandlet, SPO Administrators may trigger the build of a new Copilot agent insight report for the specified number of days. ## SYNTAX @@ -25,14 +25,14 @@ Start-SPOCopilotAgentInsightsReport [-ReportPeriodInDays ] [-Force Date: Wed, 11 Dec 2024 12:00:11 +0530 Subject: [PATCH 38/49] update description of CreatedDateTimeInUtc --- .../Get-SPOCopilotAgentInsightsReport.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md index e227d04a3..8bc061803 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md @@ -27,12 +27,12 @@ Get-SPOCopilotAgentInsightsReport [-ReportId ] [-Content [!NOTE] > All reports adhere to any retention timeline as per [Data Access Governance](/sharepoint/data-access-governance-reports). From bc5b1ff13706f0e483b85dab9733e2f2121d089c Mon Sep 17 00:00:00 2001 From: Shweta Bhagat Date: Wed, 11 Dec 2024 12:12:57 +0530 Subject: [PATCH 39/49] update default values --- .../Get-SPOCopilotAgentInsightsReport.md | 46 +++++++++---------- .../Start-SPOCopilotAgentInsightsReport.md | 4 +- 2 files changed, 25 insertions(+), 25 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md index 8bc061803..d860f595b 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md @@ -88,31 +88,31 @@ It specifies the kind of report to view or download. There are 3 kinds of sub-re 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 | RAC status (Yes/No) of the SharePoint site. | -| Restrict site discovery | RCD status (Yes/No) of the SharePoint site. | -| External sharing | External Sharing status (Yes/No) of the SharePoint site. | +| 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 | RAC status (Yes/No) of the SharePoint site. | +| Restrict site discovery enabled | RCD 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 | RAC status (Yes/No) of the SharePoint site. | -| Restrict site discovery | RCD status (Yes/No) of the SharePoint site. | -| External sharing | External Sharing status (Yes/No) of the SharePoint site. | +| 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 | RAC status (Yes/No) of the SharePoint site. | +| Restrict site discovery enabled | RCD 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: @@ -147,7 +147,7 @@ Applicable: SharePoint Online Required: False Position: Named -Default value: None +Default value: View Accept pipeline input: False Accept wildcard characters: False ``` diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md index e52ca3cec..dcff9067b 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md @@ -42,7 +42,7 @@ After this cmdlet is executed, the Copilot agent insight report generation reque Start-SPOCopilotAgentInsightsReport ``` -Example 1 generates the Copilot agent insight report for a default duration of 1 day as the parameter `–ReportPeriodInDays` is not provided. +Example 1 generates the Copilot agent insight report for a default duration of 1 day since the parameter `–ReportPeriodInDays` is not provided. ### -----------------------EXAMPLE 2----------------------------- @@ -66,7 +66,7 @@ Applicable: SharePoint Online Required: False Position: Named -Default value: None +Default value: 1 Accept pipeline input: False Accept wildcard characters: False ``` From dee085a709813ec47ec8809d29c23a80940793c4 Mon Sep 17 00:00:00 2001 From: Anupam Francis <146057103+AnfraMsft@users.noreply.github.com> Date: Wed, 11 Dec 2024 14:19:49 +0530 Subject: [PATCH 40/49] Update Get-SPOUnifiedGroupMoveState.md Added additional status values --- .../sharepoint-online/Get-SPOUnifiedGroupMoveState.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md index 52376a655..b4dbce0f8 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md @@ -103,6 +103,9 @@ 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 admin while it was still queued. +* NotSupported: The move could not be processed because the PDL was invalid. +* Rescheduled: The move did not succeed and is being scheduled again for another attempt. ## NOTES From f59fef29f106f0666fccd7919a343638415686c7 Mon Sep 17 00:00:00 2001 From: Anupam Francis <146057103+AnfraMsft@users.noreply.github.com> Date: Wed, 11 Dec 2024 14:25:35 +0530 Subject: [PATCH 41/49] Update Get-SPOUserAndContentMoveState.md Added additional status values --- .../sharepoint-online/Get-SPOUserAndContentMoveState.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md index 3ceae4143..fd3ef7696 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 admin while it was still queued.| +|NotSupported|The move could not be processed because the PDL was invalid.| +|Rescheduled|The move did not succeed and is being scheduled again for another attempt.| ## EXAMPLES From c15bb3addc4e508ceec070eea43ffaed6c00111f Mon Sep 17 00:00:00 2001 From: Shweta Bhagat Date: Thu, 12 Dec 2024 06:31:58 +0530 Subject: [PATCH 42/49] add cmdlets to TOC --- .../Get-SPOCopilotAgentInsightsReport.md | 52 +++++++++---------- .../Start-SPOCopilotAgentInsightsReport.md | 2 +- .../sharepoint-online/sharepoint-online.md | 8 +++ 3 files changed, 35 insertions(+), 27 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md index d860f595b..a959bfa09 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md @@ -88,31 +88,31 @@ It specifies the kind of report to view or download. There are 3 kinds of sub-re 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 | RAC status (Yes/No) of the SharePoint site. | -| Restrict site discovery enabled | RCD 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 | RAC status (Yes/No) of the SharePoint site. | -| Restrict site discovery enabled | RCD status (Yes/No) of the SharePoint site. | -| External sharing | External Sharing status (Yes/No) of the SharePoint site. | +| 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: @@ -120,7 +120,7 @@ If this cmdlet is executed with `-ReportId` as parameter and `-Content` as ` |:---------------|:---------------------------------------------------------------------------------------------| | Site template | The Site template of the SharePoint site. | | Sites | Number of sites corresponding to that particular site template. | -| Copilot agents | Name of Copilot agent on the SharePoint site corresponding to that particular site template. | +| Copilot agents | Number of Copilot agent on the SharePoint site corresponding to that particular site template. | ```yaml Type: SPOCopilotAgentInsightType diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md index dcff9067b..928e5b8cf 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Start-SPOCopilotAgentInsightsReport.md @@ -15,7 +15,7 @@ manager: hikakar ## SYNOPSIS -Using this commandlet, SPO Administrators may trigger the build of a new Copilot agent insight report for the specified number of days. +Using this cmdlet, administrators may trigger the build of a new Copilot agent insight report for the specified number of days. ## SYNTAX diff --git a/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md b/sharepoint/sharepoint-ps/sharepoint-online/sharepoint-online.md index 3d29c0623..a635b89d3 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}} @@ -608,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}} From c2ae728762db20bbadbcea84dde9744b2f3521fa Mon Sep 17 00:00:00 2001 From: Shweta Bhagat Date: Thu, 12 Dec 2024 09:13:21 +0530 Subject: [PATCH 43/49] minor fix --- .../sharepoint-online/Get-SPOCopilotAgentInsightsReport.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md index a959bfa09..7e37aca69 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOCopilotAgentInsightsReport.md @@ -120,7 +120,7 @@ If this cmdlet is executed with `-ReportId` as parameter and `-Content` as ` |:---------------|:---------------------------------------------------------------------------------------------| | Site template | The Site template of the SharePoint site. | | Sites | Number of sites corresponding to that particular site template. | -| Copilot agents | Number of Copilot agent on the SharePoint site 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 From 5c36fbf229c4eb4bb53541b00b90405bc9062b13 Mon Sep 17 00:00:00 2001 From: Anupam Francis <146057103+AnfraMsft@users.noreply.github.com> Date: Thu, 12 Dec 2024 09:22:02 +0530 Subject: [PATCH 44/49] Update Get-SPOUserAndContentMoveState.md --- .../sharepoint-online/Get-SPOUserAndContentMoveState.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md index fd3ef7696..5a45cb1f0 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUserAndContentMoveState.md @@ -50,8 +50,8 @@ 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 admin while it was still queued.| -|NotSupported|The move could not be processed because the PDL was invalid.| +|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 From b5b4c4a517fcca9a96567c238a2a809e88ca54fc Mon Sep 17 00:00:00 2001 From: Anupam Francis <146057103+AnfraMsft@users.noreply.github.com> Date: Thu, 12 Dec 2024 09:28:21 +0530 Subject: [PATCH 45/49] Update Get-SPOUnifiedGroupMoveState.md --- .../sharepoint-online/Get-SPOUnifiedGroupMoveState.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md index b4dbce0f8..b9156c476 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md @@ -103,8 +103,8 @@ 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 admin while it was still queued. -* NotSupported: The move could not be processed because the PDL was invalid. +* 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 From fd47791111ee4eb8bd633d193f31cab14e097c39 Mon Sep 17 00:00:00 2001 From: Anupam Francis <146057103+AnfraMsft@users.noreply.github.com> Date: Thu, 12 Dec 2024 09:29:36 +0530 Subject: [PATCH 46/49] Update Get-SPOUnifiedGroupMoveState.md --- .../sharepoint-online/Get-SPOUnifiedGroupMoveState.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md index b9156c476..8a9a52616 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md @@ -113,4 +113,4 @@ You can also apply the `-Verbose` option to see additional information about the ## 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) From 5ebc2a88a2431f5819367eab3be36a73c2345713 Mon Sep 17 00:00:00 2001 From: Ruchika Mittal Date: Fri, 13 Dec 2024 03:22:42 +0530 Subject: [PATCH 47/49] Fix note formatting in Get-SPOUnifiedGroupMoveState.md --- .../sharepoint-online/Get-SPOUnifiedGroupMoveState.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md index 8a9a52616..88ede939b 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Get-SPOUnifiedGroupMoveState.md @@ -107,9 +107,8 @@ The move status for the Office 365 Group. Possible values are: * 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 From 82844877469f0a883630d9311b14a55bdfa267cc Mon Sep 17 00:00:00 2001 From: Vaibhav Gaddam <188270566+vgaddam-pm@users.noreply.github.com> Date: Thu, 12 Dec 2024 16:29:12 -0800 Subject: [PATCH 48/49] Update Set-SPORestrictedSiteCreation.md --- .../Set-SPORestrictedSiteCreation.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md index 8b26c8f29..1a603c7f9 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Set-SPORestrictedSiteCreation.md @@ -99,8 +99,8 @@ Accept wildcard characters: False 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. +- 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. @@ -122,11 +122,11 @@ Accept wildcard characters: False 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 +- 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 From d922368d3c118a988af704c3534ccc0414e598a3 Mon Sep 17 00:00:00 2001 From: Kartik P V R Date: Mon, 16 Dec 2024 15:03:29 +0530 Subject: [PATCH 49/49] Corrected parameter list for this command --- .../Export-SPODataAccessGovernanceInsight.md | 20 +++++++++++++++++-- 1 file changed, 18 insertions(+), 2 deletions(-) diff --git a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md index 39134b1c1..099792f96 100644 --- a/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md +++ b/sharepoint/sharepoint-ps/sharepoint-online/Export-SPODataAccessGovernanceInsight.md @@ -15,7 +15,7 @@ ms.reviewer: ## SYNOPSIS -This cmdlet downloads the Data Access Governance (DAG) reports to the current working directory. +This cmdlet downloads the Data Access Governance (DAG) reports to the specified path. The default is the "Downloads" folder. ## SYNTAX @@ -25,7 +25,7 @@ Export-SPODataAccessGovernanceInsight -ReportID [] ## DESCRIPTION -This cmdlet exports or downloads the DAG report, specified by the `ReportID`, to the current working directory. The `ReportID` is shown in the output of the [Start-SPODataAccessGovernanceInsight](./Start-SPODataAccessGovernanceInsight.md) command. It can also be fetched from the output of the [Get-SPODataAccessGovernanceInsight](./Get-SPODataAccessGovernanceInsight.md) command. +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 @@ -55,6 +55,22 @@ 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).