メインコンテンツにスキップ

PowerShell による SharePoint 移行向けの Azure アプリ登録の設定

サインインしたユーザー アカウントなしで ShareGate Migrate PowerShell による SharePoint と Teams の移行を実行するために、Azure アプリ登録を設定する方法。

注: 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 にアプリを登録する

  1. Global Administrator として、Microsoft Entra 管理センターにサインインします。

  2. Entra ID > App registrations > New registration の順に移動します。

  3. アプリに名前を付けます (例: ShareGate Migration)。

  4. Supported account types で、シングル テナント アプリの場合は My organization only、複数のテナントで使用するマルチテナント アプリの場合は Multiple Entra ID tenants を選択します。

  5. Redirect URI は空のままにします。

  6. Register をクリックします。

  7. Overview ページで、Application (client) ID をコピーします。New-AzureApplication と一緒に使用します。

手順 3: 証明書をアップロードする

  1. アプリ登録で、Certificates & secrets > Certificates の順に移動し、Upload certificate を選択します。

  2. デスクトップにある .cer ファイルをアップロードします。

  3. Add をクリックします。

手順 4: API アクセス許可を追加する

  1. アプリ登録で、API permissions > Add a permission の順に移動します。

  2. 以下に記載されている Application permission をそれぞれ追加します。Microsoft Graph のアクセス許可と SharePoint のアクセス許可は、別々のエントリとして追加してください。Delegated permissions は選択しないでください。

  3. Grant admin consent for [your tenant] をクリックし、確認します。

Microsoft Graph のアクセス許可:

ChannelMember.ReadWrite.All

Teams のチャネル メンバーシップ

ChannelSettings.ReadWrite.All

Teams のチャネル設定

Directory.ReadWrite.All

ディレクトリ オブジェクト

Files.ReadWrite.All

すべてのサイト コレクション内のファイル

Group.ReadWrite.All

Microsoft 365 グループ

InformationProtectionPolicy.Read.All

情報保護ポリシー

SensitivityLabels.Read.All

機密ラベル

Notes.ReadWrite.All

OneNote ノートブック

Sites.FullControl.All

すべてのサイト コレクションに対するフル コントロール

Sites.Manage.All

すべてのサイト コレクション内の項目の作成、編集、削除

Sites.ReadWrite.All

すべてのサイト コレクション内の項目の読み取りと書き込み

Tasks.ReadWrite.All

Planner のタスク

Team.Create

チームの作成

TeamMember.ReadWrite.All

チーム メンバーシップ

TeamsAppInstallation.ReadWriteForUser.All

Teams アプリのインストール

TeamSettings.ReadWrite.All

チーム設定

TeamsTab.ReadWrite.All

Teams チャネル内のタブ

TermStore.ReadWrite.All

用語ストア

User.Read.All

ユーザー プロファイル

SharePoint のアクセス許可:

注: SharePoint のアクセス許可は、Microsoft Graph ではなく、API の一覧の SharePoint にあります。

Sites.FullControl.All

すべてのサイト コレクションに対するフル コントロール

Sites.Manage.All

すべてのサイト コレクション内の項目の作成、編集、削除

Sites.Read.All

すべてのサイト コレクション内の項目の読み取り

Sites.ReadWrite.All

すべてのサイト コレクション内の項目の読み取りと書き込み

TermStore.Read.All

用語ストア (読み取り)

TermStore.ReadWrite.All

用語ストア (読み取り/書き込み)

User.Read.All

ユーザー プロファイル (読み取り)

User.ReadWrite.All

ユーザー プロファイル (読み取り/書き込み)

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 の一覧には含まれていません。

Chat.Create

チャットの作成

Chat.ReadWrite.All

すべてのチャットの読み取りと書き込み

Teamwork.Migrate.All

Microsoft Teams への移行

Directory.ReadWrite.All

ディレクトリ データの読み取りと書き込み

各アクセス許可の説明については、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

この記事は人工知能を使用して翻訳されました。疑問がある場合は、元の英語版をご確認ください。

こちらの回答で解決しましたか?