注: PowerShell 統合には、ShareGate の Migration Pro または Migration Ultimate パッケージが必要です。Migration Essentials Mailbox または Migration Essentials Files パッケージでは利用できません。
この記事は、ShareGate Migrate の PowerShell 統合専用です。
アプリケーション専用認証を使うと、サインインしたユーザー アカウントなしで、PowerShell から SharePoint と Teams の移行を実行できます。ShareGate Migrate は、ユーザーの資格情報の代わりに、Azure アプリ登録を使って認証します。
セットアップでは、アプリ登録の作成、証明書資格情報のアップロード、必要な API アクセス許可の付与を行います。
その後、Application (client) ID と証明書を使って PowerShell から認証します。
始める前に
ShareGate の Migration Pro または Migration Ultimate パッケージ
アプリ登録の作成と管理者の同意の付与には、Microsoft 365 テナントの Global Administrator アクセス権が必要です
アプリ登録を設定する
移行元または移行先となる各テナントで、この手順を実行してください。
シングル テナント アプリ (単一のテナント内でのみ使用するアプリ) の場合は、テナントごとにセットアップ全体を繰り返します。
マルチテナント アプリ (1 つの登録を複数のテナントで再利用するアプリ) の場合は、ホーム テナントで手順を完了してから、追加の各テナントで管理者の同意を付与します。
手順 1: 証明書を生成する
ShareGate は、証明書を使ってアプリとして認証します。次の PowerShell スクリプトを実行して、ローカル ユーザー ストアに自己署名証明書を生成し、デスクトップにエクスポートします。
# Generate a self-signed certificate in your local user store
$certName = "AzureAppAuthCert"
$cert = New-SelfSignedCertificate -Subject "CN=$certName" -CertStoreLocation "Cert:\CurrentUser\My" -KeyExportPolicy Exportable -KeySpec Signature -KeyLength 2048 -KeyAlgorithm RSA -HashAlgorithm SHA256
# Export the public key (.cer) - upload this to Azure in Step 3
Export-Certificate -Cert $cert -FilePath "$home\Desktop\$certName.cer"
# Export the private key as a .pfx - required if connecting via Option B
$pfxPassword = ConvertTo-SecureString -String "choose-a-strong-password" -Force -AsPlainText
Export-PfxCertificate -Cert $cert -FilePath "$home\Desktop\$certName.pfx" -Password $pfxPassword
# Copy this value for use with New-AzureApplication
Write-Host "Thumbprint: $($cert.Thumbprint)"
どちらのファイルもデスクトップに保存されます。.cer ファイルは、手順 3 で Azure にアップロードします。オプション B で接続する場合は、.pfx ファイルも必要です。
コンソールに表示される拇印を控えておいてください。接続の手順で New-AzureApplication と一緒に使用します。
手順 2: Microsoft Entra ID にアプリを登録する
Global Administrator として、Microsoft Entra 管理センターにサインインします。
Entra ID > App registrations > New registration の順に移動します。
アプリに名前を付けます (例: ShareGate Migration)。
Supported account types で、シングル テナント アプリの場合は My organization only、複数のテナントで使用するマルチテナント アプリの場合は Multiple Entra ID tenants を選択します。
Redirect URI は空のままにします。
Register をクリックします。
Overview ページで、Application (client) ID をコピーします。
New-AzureApplicationと一緒に使用します。
手順 3: 証明書をアップロードする
アプリ登録で、Certificates & secrets > Certificates の順に移動し、Upload certificate を選択します。
デスクトップにある
.cerファイルをアップロードします。Add をクリックします。
手順 4: API アクセス許可を追加する
アプリ登録で、API permissions > Add a permission の順に移動します。
以下に記載されている Application permission をそれぞれ追加します。Microsoft Graph のアクセス許可と SharePoint のアクセス許可は、別々のエントリとして追加してください。Delegated permissions は選択しないでください。
Grant admin consent for [your tenant] をクリックし、確認します。
Microsoft Graph のアクセス許可:
| Teams のチャネル メンバーシップ |
| Teams のチャネル設定 |
| ディレクトリ オブジェクト |
| すべてのサイト コレクション内のファイル |
| Microsoft 365 グループ |
| 情報保護ポリシー |
| 機密ラベル |
| OneNote ノートブック |
| すべてのサイト コレクションに対するフル コントロール |
| すべてのサイト コレクション内の項目の作成、編集、削除 |
| すべてのサイト コレクション内の項目の読み取りと書き込み |
| Planner のタスク |
| チームの作成 |
| チーム メンバーシップ |
| Teams アプリのインストール |
| チーム設定 |
| Teams チャネル内のタブ |
| 用語ストア |
| ユーザー プロファイル |
SharePoint のアクセス許可:
注: SharePoint のアクセス許可は、Microsoft Graph ではなく、API の一覧の SharePoint にあります。
| すべてのサイト コレクションに対するフル コントロール |
| すべてのサイト コレクション内の項目の作成、編集、削除 |
| すべてのサイト コレクション内の項目の読み取り |
| すべてのサイト コレクション内の項目の読み取りと書き込み |
| 用語ストア (読み取り) |
| 用語ストア (読み取り/書き込み) |
| ユーザー プロファイル (読み取り) |
| ユーザー プロファイル (読み取り/書き込み) |
ShareGate から接続する
New-AzureApplication で資格情報オブジェクトを作成し、Connect-Site または Connect-Tenant に渡します。
オプション A: 証明書の拇印 (生成スクリプトで作成したもの)
手順 1 のスクリプトを使用した場合、証明書は Cert:\CurrentUser\My にあります。拇印をそのまま渡します。
# Build a credential object from the certificate thumbprint
$app = New-AzureApplication -ClientId "<application-client-id>" -Thumbprint "<certificate-thumbprint>"
# Connect to a specific site
Connect-Site -Url "https://contoso.sharepoint.com/sites/Marketing" -AzureApplication $app
# Or connect at the tenant level
Connect-Tenant -Domain "contoso" -AzureApplication $app
オプション B: .pfx ファイルの証明書
証明書が .pfx ファイルの場合は、そのまま読み込めます。
# Load the certificate from a .pfx file
$certificate = [System.Security.Cryptography.X509Certificates.X509Certificate2]::new(
"C:\certs\sharegate-app.pfx",
"your-pfx-password")
# Build a credential object
$app = New-AzureApplication -ClientId "<application-client-id>" -Certificate $certificate
# Connect to a site
Connect-Site -Url "https://contoso.sharepoint.com/sites/Marketing" -AzureApplication $app
1 つのアプリ オブジェクトで、同じセッション内の複数の接続を認証できます。複数の Connect-Site または Connect-Tenant の呼び出しで、同じ $app 変数を再利用してください。
注: セキュリティ ポリシーにより必要なアクセス許可のいずれかを付与できない場合は、Connect-Site または Connect-Tenant に -AllowMissingPermissions を追加すると、そのまま接続できます。
不足しているアクセス許可に依存する操作は、Forbidden エラーで失敗します。
このスイッチは、認証が成功した後のアクセス許可のチェックを緩和するだけです。サインインの失敗は解決されません。
アプリを保存して再利用する
アプリ登録オブジェクトを保存しておけば、後のセッションで取得できるため、毎回作り直す必要がありません。保存には Save-AzureApplication、読み込みには Get-AzureApplication を使用します。
既知の制限事項
管理対象メタデータの値は、移行時に引き継がれません。
ユーザー アラートはスキップされます。アプリ専用認証にはアラートを送信するユーザー コンテキストがありません。
クラシック Web パーツは移行されません。
クラシック SharePoint ワークフローは移行されません。
InfoPath フォームは部分的に移行されます。警告が表示されることがあります。
発行承認ワークフローにはユーザー コンテキストが必要です。エラーまたは警告が表示されることがあります。
機密ラベルは、移行時に適用されません。
Teams のチャネル メッセージは、アプリ専用認証ではコピーされません。
プライベート チャットをコピーする
独自の Azure アプリ登録を使って、PowerShell から Copy-Chat を実行できます。上記の説明に従ってアプリ登録と証明書をセットアップし、次の Microsoft Graph の Application permissions を追加します。これらは手順 4 の一覧には含まれていません。
| チャットの作成 |
| すべてのチャットの読み取りと書き込み |
| Microsoft Teams への移行 |
| ディレクトリ データの読み取りと書き込み |
各アクセス許可の説明については、ShareGate に必要な Microsoft 365 のアクセス許可セットを参照してください。
接続するには、Connect-MicrosoftOnline の -CopyFeature パラメーターに ChatCopy を指定して使用します。Teams の移行専用の Connect-Tenant は使用しないでください。
# Build a credential object from the certificate thumbprint
$app = New-AzureApplication -ClientId "<application-client-id>" -Thumbprint "<certificate-thumbprint>"
# Connect to the tenant for Copy-Chat
$connection = Connect-MicrosoftOnline -TenantId "<tenant-id>" -AzureApplication $app -CopyFeature ChatCopy
この記事は人工知能を使用して翻訳されました。疑問がある場合は、元の英語版をご確認ください。
