Skip to content

Commit dad6a77

Browse files
committed
Scanner doc updates
1 parent 5637bd5 commit dad6a77

File tree

5 files changed

+19
-5
lines changed

5 files changed

+19
-5
lines changed
Loading
Loading

docs/transform/modernize-scanner-reports-blogs.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: The SharePoint modernization scanner reports for the blog scanner mode
33
description: Explains the blog output created by the modernization scanner
4-
ms.date: 10/23/2019
4+
ms.date: 11/27/2019
55
ms.prod: sharepoint
66
localization_priority: Priority
77
---
@@ -21,6 +21,7 @@ Column | Description
2121
**Site Collection Url** | Url of the scanned site collection.
2222
**SiteUrl** | Url of the scanned web.
2323
**Web Relative Url** | Relative Url of the scanned web.
24+
**Blog Type** | Is this a classic blog or Delve blog (requires scanner 2.7+).
2425
**Web Template** | Used web template (should all be BLOG#0).
2526
**Language** | Language used to create the blog site.
2627
**Blog Page Count** | Number of blog posts in this site.
@@ -38,6 +39,7 @@ Filter | Takeaway
3839
---------|----------
3940
**No filter** | Lists all the blog sites found in your tenant.
4041
**Blog Page Count > 10 AND Change Year = this year** | A good filter to identify the actively used blog sites in your tenant. These sites are good candidates for modernization.
42+
**Blog Type = "Delve blogs"** | As Delve blogs are retired it's good to understand where they are used in your tenant. (requires scanner 2.7+)
4143

4244
## Understanding the ModernizationBlogPageScanResults.csv file
4345

@@ -48,6 +50,7 @@ Column | Description
4850
**Site Collection Url** | Url of the scanned site collection.
4951
**SiteUrl** | Url of the scanned web.
5052
**Web Relative Url** | Relative Url of the scanned web.
53+
**Blog Type** | Is this a classic blog page or Delve blog page (requires scanner 2.7+).
5154
**Page Title** | Title of this blog post.
5255
**Modified At** | Last modified date of this blog post.
5356
**Modified By** | This blog post was last modified by.

docs/transform/modernize-scanner-reports-groupconnect.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: The SharePoint modernization scanner reports for the Office 365 group connect scanner mode
33
description: Explains the Office 365 group connect output created by the modernization scanner
4-
ms.date: 10/23/2019
4+
ms.date: 11/27/2019
55
ms.prod: sharepoint
66
localization_priority: Priority
77
---
@@ -31,6 +31,7 @@ Column | Description
3131
**ModernUIWarnings** | This is a collection of warnings indicating either some modern UI component was turned off or incompatible features/customizations have been detected. Possible values are `ModernPageFeatureDisabled` (modern pages are disabled for this site), `ModernListsBlockedAtSiteLevel` (modern UI for lists has been purposely been blocked at site collection level), `ModernListsBlockedAtWebLevel` (modern UI for lists has been purposely been blocked at web collection level), `MasterPageUsed` (a custom master page has been used), `AlternateCSSUsed` (alternate CSS was defined), `UserCustomActionUsed` (incompatible user custom actions have been found) and `PublishingFeatureEnabled` (publishing features are enabled).
3232
**WebTemplate** | The web template used by the site.
3333
**Office365GroupId** | If this site is already connected to an Office 365 group is shows the id if that group.
34+
**HasTeamsTeam** | Is there a Teams team created for the Office 365 Group connected to this site collection (as of version 2.7)
3435
**MasterPage** | Was a custom master page used?
3536
**AlternateCSS** | Was alternate CSS defined?
3637
**UserCustomActions** | Are there incompatible user custom actions used?
@@ -72,6 +73,7 @@ Filter | Takeaway
7273
**ReadyForGroupify = TRUE** | Will give you all the site collections that can be "Office 365 group connected". There might still be warnings to check, but we did not find any blocking issues
7374
**ReadyForGroupify = FALSE AND Office365GroupId = ""** | Will give you all the sites which do not yet have an Office 365 group connected and which can't be "Office 365 group connected"
7475
**ReadyForGroupify = TRUE AND GroupMode = PUBLIC** | Will give you all the site collections that can be "Office 365 group connected" and for which we'll default to a public group (based on the presence of the `everyone` or `everyone except external users` in the site members or site owners
76+
**HasTeamsTeam = FALSE AND WebTemplate = GROUP#0** | Modern group connected team sites that do not yet have a Teams team created for their Office 365 group (as of version 2.7)
7577

7678
## Understanding the ModernizationWebScanResults.csv file ##
7779

docs/transform/modernize-scanner.md

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: The SharePoint modernization scanner
33
description: Gets you started with the SharePoint modernization scanner
4-
ms.date: 11/19/2019
4+
ms.date: 11/27/2019
55
ms.prod: sharepoint
66
localization_priority: Priority
77
---
@@ -38,7 +38,9 @@ Since a typical scan needs to be able to scan all site collections it's recommen
3838
- [Granting access via SharePoint App-Only](../solution-guidance/security-apponly-azureacs.md)
3939

4040
> [!IMPORTANT]
41-
> If you're choosing for Azure AD app-only, then above mentioned instructions grant the Azure AD app the **Sites.FullControl.All** permission, which is needed if you want to run all scan components. If you're not interested in workflow scanning you can also use **Sites.Read.All** as a permission as of version 2.6 of the SharePoint Modernization Scanner.
41+
> If you're choosing for Azure AD app-only, then above mentioned instructions grant the Azure AD app the **Sites.FullControl.All** permission, which is needed if you want to run **all** scan components.
42+
> If you're not interested in workflow scanning you can also use **Sites.Read.All** as a permission (as of version 2.6).
43+
> If you want to report on site collections that have a Teams team linked then you also need to add the **Group.Read.All** permission (as of version 2.7).
4244
4345
Once the preparation work is done, let's continue with doing a scan.
4446

@@ -61,6 +63,9 @@ If you've [setup access via Azure AD App-Only](../solution-guidance/security-app
6163
- **Certificate file**: the certificate that you granted app-only access to the Azure AD app, this needs to be presented as a password protected PFX file
6264
- **Password for the PFX file**: the password used to secure the previously provided PFX file
6365

66+
> [!NOTE]
67+
> You can also opt to install the certificate on your computer and refence it via the -w command line parameters. To reference the certificate you would use this value for the -w parameter "My|CurrentUser|1FG498B468AV3895E7659C8A6F098FB701C8CDB1". You can use My/Root and CurrentUser/LocalMachine to identify the store. The last argument is the certificate thumbprint. This option is available as of the 2.7 release.
68+
6469
> [!IMPORTANT]
6570
> The default instructions mentioned to grant the Azure AD app the **Sites.FullControl.All** permission which is needed if you want to run all scan components. If you're not interested in workflow scanning you can also use **Sites.Read.All** as a permission as of version 2.6 of the SharePoint Modernization Scanner.
6671
@@ -180,7 +185,7 @@ Mode | Description
180185
### Command line parameter overview
181186

182187
```Console
183-
SharePoint PnP Modernization scanner 2.6.0.0
188+
SharePoint PnP Modernization scanner 2.7.0.0
184189
Copyright (C) 2019 SharePoint PnP
185190
==========================================================
186191

@@ -287,5 +292,9 @@ https://contoso-admin.contoso.com -u [email protected] -p pwd
287292

288293
-e, --separator (Default: ,) Separator used in output CSV files (e.g. ";")
289294

295+
-w, --storedcertificate (Default: ) Path to stored certificate in the form of
296+
StoreName|StoreLocation|Thumbprint. E.g.
297+
My|LocalMachine|3FG496B468BE3828E2359A8A6F092FB701C8CDB1
298+
290299
--help Display this help screen.
291300
```

0 commit comments

Comments
 (0)