SharePoint の最新化評価はどこで開始すればよいですか?

新しいクラシック ページの評価と変換プロジェクトの場合は、Microsoft Learn の 従来の SharePoint ページの評価と変換 から始めてください。 このガイダンスには、要件、アプリケーションのセットアップ、評価の実行、レポートの解釈、CSV 参照、発行ページの準備、PnP PowerShell 変換、検証が含まれています。

SharePoint 最新化スキャナーはレガシ ツールであり、アクティブに保守されなくなりました。 そのドキュメントは、既にスキャナーを使用しているお客様、既存のスキャナー レポートを解釈する必要があるお客様、または Microsoft 365 アセスメント ツールでまだ使用できない機能を必要とするお客様に引き続きご利用いただけます。

レガシー スキャナーのドキュメント

• レガシ スキャナーによって作成されるレポートについて
• レガシ スキャナーに関する FAQ
• 従来の SharePoint Modernization Scanner の実行可能ファイルをダウンロードする

次のセクションでは、引き続き必要な顧客向けに、従来の SharePoint 最新化スキャナーについて説明します。

手順 1: 従来の SharePoint 最新化スキャナーをダウンロードする

従来の SharePoint 最新化スキャナーの実行可能ファイルをダウンロードします。 スキャナーはアクティブに維持されなくなったため、使用する前にその動作と認証モデルを検証してください。

手順 2: スキャンの準備

一般的なスキャンではすべてのサイト コレクションをスキャンできる必要があるため、テナント スコープのアクセス許可を持つアプリのみのプリンシパルを使用してスキャンすることをお勧めします。 この方法により、スキャナーが常にアクセスできるようになります。 アカウント (SharePoint テナント管理者アカウントなど) を使用する場合、スキャナーは、このユーザーもアクセスできるサイトにのみアクセスできます。 アプリのみのアクセスには、Azure AD アプリケーションまたは SharePoint アプリ プリンシパルを使用できます。以下のリンクでは、手動で設定する方法について説明します。 推奨される方法は Azure AD アプリのみであるため、PnP PowerShellRegister-PnPAzureADAppコマンドレットを使用すると、Azure AD アプリケーションを簡単にセットアップできます。 詳細については、「Register-PnPAzureADApp を使用して AD アプリのみAzureセットアップする」の章を参照してください。

• Azure AD アプリ専用を使用してアクセスを許可する (推奨)
• SharePoint アプリ専用のアクセスを許可する

準備作業が終わったら、スキャンを続けましょう。

Register-PnPAzureADApp を使用して Azure AD App-Only を設定する

PnP PowerShell を使用して Azure AD アプリ専用を構成するには、次の手順を実行します。

1. PnP PowerShell をインストールするか、2020 年 4 月またはそれより新しいバージョンに更新します。

2. Register-PnPAzureADAppコマンドレットを使用して、Azure AD アプリを設定します。

   Register-PnPAzureADApp
     -ApplicationName "ModernizationScannerApp"
     -Tenant "contoso.onmicrosoft.com"
     -OutPath "C:\temp"
     -CertificatePassword (ConvertTo-SecureString -String "password" -AsPlainText -Force)
     -SharePointApplicationPermissions "Sites.FullControl.All"
     -GraphApplicationPermissions "Group.Read.All"
   

3. 認証を求められます。 テナント管理者であるユーザーで認証していることを確認します

4. コマンドレットは Azure AD アプリをセットアップし、60 秒間待機して Azure AD にアプリの作成を処理する時間を与えます

5. 作成した Azure AD アプリケーションに付与されたアクセス許可に同意するよう求められます。

   1. まず、もう一度サインインしてテナント管理者アカウントを使用するように求められます
   2. 次に、要求されたアクセス許可で同意ダイアログが表示されます (下のスクリーンショットを参照)。 [Accept] をクリックします

6. 返された AzureAppId、作成した PFX ファイル、パスワードを安全な場所に保存する場合は、「Azure AD アプリのみで認証する」の見出しの説明に従って使用する必要があります

手順 3: ユーザー インターフェイスのオプションを使用してスキャンを起動する

最も簡単な方法は、スキャナーに備わっている UI を使用して SharePoint.Modernization.Scanner.exe を起動する方法です。 または、(PowerShell) コマンド プロンプトを起動してそのフォルダーに移動し、コマンド ラインからスキャナーを使用できるようにすることもできます。 この章では、UI オプションについて説明し、一般的な フル スキャンを行います。 最初に、SharePoint.Modernization.Scanner.exe を起動します。

1 ページ目: スキャナー認証の構成

Azure AD アプリ専用経由での認証

モダン化スキャナー ウィザードの最初のページで、認証情報を求められます。 スキャナーは 4 つのオプションをサポートしています。必要なものを選択し、以下で説明されている必要な情報を入力します。 理想的には、スキャナーがスキャンする必要があるすべてのサイトに確実にアクセスできるようにするために、アプリのみのモデルを使用します。

Azure AD アプリ専用経由でアクセス権を設定 した場合、Azure アプリが作成され、アクセスの証明書が構成されます。 この情報をツールに提供する必要がありあります。

• Azure AD Application ID: Azure AD 環境で作成されたアプリケーションの ID
• Azure AD Domain name: Azure AD 環境の既定のドメイン。 この情報は、Azure AD 管理センターの概要ページから確認することができます。 通常、このドメインは *.onmicrosoft.com (contoso.onmicrosoft.com など) として書式設定されます。
• 証明書ファイル: Azure AD アプリへのアプリ限定のアクセスを付与した証明書。これはパスワードで保護された PFX ファイルとして提示する必要があります
• Password for the PFX file: 以前に提供した PFX ファイルを保護するために使用したパスワード
• 認証リージョン: テナントが米国政府 (ITAR)、ドイツ、または中国のクラウド環境にある場合は、それぞれのリージョンを選択します

SharePoint AD アプリ専用経由での認証

"クラシック" の SharePoint アプリのみ のアプローチを使用した場合は、次を指定する必要があります。

• Azure ACS Client ID: 作成されたアプリ専用プリンシパルの ID
• Azure ACS Client Secret: アプリケーション プリンシパルを作成したときに取得したシークレット

資格情報による認証

標準のユーザー名とパスワードの組み合わせを使用します (提供したユーザーが必要なアクセス許可を持っていることが前提です)。 スキャナーのバージョン 2.9 以降、ユーザー/パスワードベースの認証は、スキャンされたテナントで有効になっているレガシ認証に依存しなくなりました。 この種類の認証が機能しない唯一の理由は、ユーザーのアカウントで多要素認証が必要な場合です。 このような場合は、バージョン 2.9 以降で導入された多要素認証オプションを使用してください。

多要素認証を使用して認証する (バージョン 2.9 以降)

使用しているテナントとアカウントによっては、管理者が SharePoint Online へのログインに多要素認証を必要とする場合があります。 その場合、ユーザーの資格情報を介してスキャナーを使用する場合は、このオプションを使用する必要があります。 アプリのみの使用も推奨しますが、アプリのみを設定するために必要なアクセス許可がない場合は、この方法を使用すると、ユーザーとしてアクセス許可を持つサイト コレクションをスキャンできます。 これを使用するには、次の必要があります:

• スキャンするサイトの URL を入力します (アクセスしたサイトはすべて問題ありません)
• [ ログイン] ボタンをクリックすると、多要素認証フローがトリガーされます

2 ページ目: スキャナーのサイト範囲の構成

テナント全体をスキャンする

このページでは、スキャン対象のサイトを定義できます。 スキャナーでは、テナント全体のスキャンから、個別に選択したサイト コレクションのスキャンまでサポートされています。

テナントの完全なスキャンを行うとモダン化レポートが作成されるため、多くの場合この方法が推奨されます。 それがあなたの好みである場合は、テナントの名前を入力するだけです。 このアプローチは、テナントが sharepoint.com で終わらない URL を使用している場合には機能しません。その場合は、次の 2 つのオプションのいずれかを使用する必要があります。

定義されたサイト コレクションの一覧をスキャンする

このオプションでは、次のうちどちらかを提供して 1 つまたは複数のサイト コレクションを選択できます。

• スキャン対象のサイト コレクションの完全修飾 URL
• ワイルドカード URL: 星で終わる URL を追加すると、そのフィルターに一致するすべてのサイトが含まれます。 サポートされているワイルドカードは、アスタリスクで終わるもののみです

sharepoint.com で終わらない URL (いわゆるバニティ URL) を使用している場合は、テナント管理センター サイトの URL (https://contoso-admin.contoso.com など) も指定する必要があります。

CSV ファイルで定義されているサイト コレクションの一覧をスキャンする

3 番目のオプションとして、スキャンするサイト コレクションを一覧表示した CSV ファイルをスキャナーに提供できます。 この CSV ファイルは、サイト コレクションの単純なリストです。次の例に示すように、ファイルにはヘッダーがありません。

https://contoso.sharepoint.com/sites/hrteam
https://contoso.sharepoint.com/sites/funatwork
https://contoso.sharepoint.com/sites/opensourcerocks

3 ページ目: スキャナー モードの構成

SharePoint モダン化スキャナーでは複数のモードが利用できます。モダン化のモードに合わせて、スキャンする範囲を一部の場所に限ったり、または全体をスキャンしたりできます。

ドロップダウン リストで目的のオプションを選択すると、選択したスキャンに含まれるコンポーネントのチェック ボックスがオンになります。 「Microsoft 365 グループ接続の準備状態」コンポーネントは中心的なコンポーネントであるため、すべてのスキャン モードに含まれます。

4 ページ目: スキャナーのオプション

最後のステップでは、スキャナー オプションの詳細を調整することができます。 先ほど選択したスキャナーのモードによっては、一部のオプションが無効になっている場合があります。

次のスキャン オプションを使用できます。

• Number of threads: 実行されるスキャンはマルチ スレッドで既定値は 10ですが、大規模なスキャンではスレッド数を 20 - 30 にするとパフォーマンスが上がります (効果にばらつきがある場合があります)
• Don't use search: ページやサイトの使用状況の情報が必要な場合には、このオプションの選択を解除できます。 サイト コレクションごとに検索クエリが 1 つ追加されるので、スキャンがわずかに低速化します
• Don't include user information: 作成されたデータにユーザー情報 (ユーザー名) 表示する必要がない場合はこのボックスをオンにします
• Exclude lists: [モダン リストとライブラリ エクスペリエンス] スキャンでは、アウトオブボックス に関する理由だけでブロックされているリストを除外することができます
• Export page details: Web パーツの詳細情報 (Web パーツ プロパティ) のデータセットは巨大になる場合があるので、既定ではスキャンからエクスポートされません。 Web パーツ オプションの完全なデータが必要な場合は、このボックスをオンにします
• Don't generate reports: 既定では、スキャンは Excel ベースのダッシュボードを出力しますが、生の CSV ファイルのみが必要な場合は、Excel レポートを省略できます
• Disable feedback: スキャナーは、スキャナーの性能を向上させる目的で Microsoft にフィードバックを送信します。 希望しない場合は、このボックスをオンにします
• 区切り記号: 生成される CSV ファイルの既定の区切り記号はコンマですが、必要に応じてこれをセミコロンに変更できます
• Date format: 生成された CSV ファイルの既定の日付形式は月/日/年です。 オプションでこれを日/月/年に切り替えることができます

手順 3 (別のオプション): コマンドラインを使用してスキャンを開始する

以下に、ほとんどのお客様にご利用いただける、ツールの既定の使用方法を示します: モード、テナント名、作成されたクライアント ID、およびシークレットを指定します:

SharePoint.Modernization.Scanner.exe -t <tenant> -i <clientid> -s <clientsecret>

実際のサンプル:

SharePoint.Modernization.Scanner.exe -t contoso -i 7a5c1615-997a-4059-a784-db2245ec7cc1 -s eOb6h+s805O/V3DOpd0dalec33Q6ShrHlSKkSra1FFw=

上記の使い方ではスキャンのオプションがすべて実行されますが、Mode パラメーター (-m) を使用してスキャンの対象を絞ることもできます。

SharePoint.Modernization.Scanner.exe -m <mode> -t <tenant> -i <clientid> -s <clientsecret>

実際のサンプル:

SharePoint.Modernization.Scanner.exe -m GroupifyOnly -t contoso -i 7a5c1615-997a-4059-a784-db2245ec7cc1 -s eOb6h+s805O/V3DOpd0dalec33Q6ShrHlSKkSra1FFw=

利用できるスキャナー モード

コマンドライン パラメーターの概要

SharePoint PnP Modernization scanner 2.19.0.0
Copyright (C) 2020 SharePoint PnP
==========================================================

See the sp-dev-modernization repo for more information at:
https://github.com/SharePoint/sp-dev-modernization/tree/master/Tools/SharePoint.Modernization

Let the tool figure out your urls (works only for SPO MT):
==========================================================
Using Azure AD app-only:
SharePoint.Modernization.Scanner.exe -t <tenant> -i <your client id> -z <Azure AD domain> -f <PFX file> -x <PFX file
password>
e.g. SharePoint.Modernization.Scanner.exe -t contoso -i e5808e8b-6119-44a9-b9d8-9003db04a882 -z conto.onmicrosoft.com
-f apponlycert.pfx -x pwd

Using app-only:
SharePoint.Modernization.Scanner.exe -t <tenant> -i <your client id> -s <your client secret>
e.g. SharePoint.Modernization.Scanner.exe -t contoso -i 7a5c1615-997a-4059-a784-db2245ec7cc1 -s
eOb6h+s805O/V3DOpd0dalec33Q6ShrHlSKkSra1FFw=

Using credentials:
SharePoint.Modernization.Scanner.exe -t <tenant> -u <your user id> -p <your user password>

e.g. SharePoint.Modernization.Scanner.exe -t contoso -u spadmin@contoso.onmicrosoft.com -p pwd

Specifying url to your sites and tenant admin (needed for SPO with vanity urls):
================================================================================
Using Azure AD app-only:
SharePoint.Modernization.Scanner.exe -r <wildcard urls> -a <tenant admin site>  -i <your client id> -z <Azure AD
domain> -f <PFX file> -x <PFX file password>
e.g. SharePoint.Modernization.Scanner.exe -r "https://teams.contoso.com/sites/*,https://my.contoso.com/personal/*" -a
https://contoso-admin.contoso.com -i e5808e8b-6119-44a9-b9d8-9003db04a882 -z conto.onmicrosoft.com  -f apponlycert.pfx
-x pwd

Using app-only:
SharePoint.Modernization.Scanner.exe -r <wildcard urls> -a <tenant admin site> -i <your client id> -s <your client
secret>
e.g. SharePoint.Modernization.Scanner.exe -r "https://teams.contoso.com/sites/*,https://my.contoso.com/personal/*" -a
https://contoso-admin.contoso.com -i 7a5c1615-997a-4059-a784-db2245ec7cc1 -s
eOb6h+s805O/V3DOpd0dalec33Q6ShrHlSKkSra1FFw=

Using credentials:
SharePoint.Modernization.Scanner.exe -r <wildcard urls> -a <tenant admin site> -u <your user id> -p <your user
password>
e.g. SharePoint.Modernization.Scanner.exe -r "https://teams.contoso.com/sites/*,https://my.contoso.com/personal/*" -a
https://contoso-admin.contoso.com -u spadmin@contoso.com -p pwd


  -i, --clientid                           Client ID of the app-only principal used to scan your site collections

  -s, --clientsecret                       Client Secret of the app-only principal used to scan your site collections

  -u, --user                               User id used to scan/enumerate your site collections

  -p, --password                           Password of the user used to scan/enumerate your site collections

  -z, --azuretenant                        Azure tenant (e.g. contoso.microsoftonline.com)

  -y, --azureenvironment                   (Default: Production) Azure environment (only works for Azure AD Cert
                                           auth!). Possible values: Production, USGovernment, Germany, China

  -f, --certificatepfx                     Path + name of the pfx file holding the certificate to authenticate

  -x, --certificatepfxpassword             Password of the pfx file holding the certificate to authenticate

  -a, --tenantadminsite                    Url to your tenant admin site (e.g. https://contoso-admin.contoso.com): only
                                           needed when your not using SPO MT

  -t, --tenant                             Tenant name, e.g. contoso when your sites are under
                                           https://contoso.sharepoint.com/sites. This is the recommended model for
                                           SharePoint Online MT as this way all site collections will be scanned

  -r, --urls                               List of (wildcard) urls (e.g.
                                           https://contoso.sharepoint.com/*,https://contoso-my.sharepoint.com,https://co
                                           ntoso-my.sharepoint.com/personal/*) that you want to get scanned. Ignored if
                                           -t or --tenant are provided.

  -o, --includeod4b                        (Default: False) Include OD4B sites in the scan

  -v, --csvfile                            CSV file name (e.g. input.csv) which contains the list of site collection
                                           urls that you want to scan

  -h, --threads                            (Default: 10) Number of parallel threads, maximum = 100

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

  -m, --mode                               (Default: Full) Execution mode. Use following modes: Full, GroupifyOnly,
                                           ListOnly, PageOnly, HomePageOnly, PublishingOnly, PublishingWithPagesOnly,
                                           WorkflowOnly, WorkflowWithDetailsOnly, InfoPathOnly, BlogOnly or CustomizedFormsOnly. Omit or use
                                           full for a full scan

  -b, --exportwebpartproperties            (Default: False) Export the web part property data

  -c, --skipusageinformation               (Default: False) Don't use search to get the site/page usage information and
                                           don't export that data

  -j, --skipuserinformation                (Default: False) Don't include user information in the exported data

  -k, --skiplistsonlyblockedbyoobreaons    (Default: False) Exclude lists which are blocked due to out of the box
                                           reasons: base template, view type of field type

  -d, --skipreport                         (Default: False) Don't generate an Excel report for the found data

  -g, --exportpaths                        List of paths (e.g. c:\temp\636529695601669598,c:\temp\636529695601656430)
                                           containing scan results you want to add to the report

  -n, --disabletelemetry                   (Default: False) We use telemetry to make this a better tool...but you're
                                           free to disable that

  -q, --dateformat                         (Default: M/d/yyyy) Date format to use for date export in the CSV files. Use
                                           M/d/yyyy or d/M/yyyy

  -w, --storedcertificate                  (Default: ) Path to stored certificate in the form of
                                           StoreName|StoreLocation|Thumbprint. E.g.
                                           My|LocalMachine|3FG496B468BE3828E2359A8A6F092FB701C8CDB1

  --help                                   Display this help screen.