Hinweis: Die PowerShell-Integration erfordert ein ShareGate Migration Pro- oder Migration Ultimate-Paket. Sie ist mit Migration Essentials Mailbox oder Migration Essentials Files nicht verfügbar.
Dieser Artikel gilt nur für die PowerShell-Integration von ShareGate Migrate.
Mit der reinen Anwendungsauthentifizierung können Sie SharePoint- und Teams-Migrationen aus PowerShell ohne angemeldetes Benutzerkonto ausführen. Anstelle von Benutzeranmeldeinformationen authentifiziert sich ShareGate Migrate über eine Azure-App-Registrierung.
Bei der Einrichtung erstellen Sie eine App-Registrierung, laden eine Zertifikatanmeldeinformation hoch und erteilen die erforderlichen API-Berechtigungen.
Anschließend verwenden Sie die Application (client) ID und das Zertifikat, um sich aus PowerShell zu authentifizieren.
Bevor Sie beginnen
ShareGate Migration Pro- oder Migration Ultimate-Paket
Zugriff als Globaler Administrator im Microsoft 365-Mandanten ist erforderlich, um die App-Registrierung zu erstellen und die Administratoreinwilligung zu erteilen
App-Registrierung einrichten
Führen Sie dies in jedem Mandanten aus, in den oder aus dem Sie migrieren.
Bei einer App für einen einzelnen Mandanten (die nur innerhalb eines Mandanten verwendet wird) wiederholen Sie die gesamte Einrichtung für jeden Mandanten.
Bei einer App für mehrere Mandanten (bei der eine einzelne Registrierung in mehreren Mandanten wiederverwendet wird) führen Sie die Schritte in Ihrem Heimatmandanten aus und erteilen dann in jedem weiteren Mandanten die Administratoreinwilligung.
Schritt 1: Zertifikat erstellen
ShareGate verwendet ein Zertifikat, um sich als Ihre App zu authentifizieren. Führen Sie das folgende PowerShell-Skript aus, um ein selbstsigniertes Zertifikat in Ihrem lokalen Benutzerspeicher zu erstellen und auf Ihren Desktop zu exportieren.
# 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)"
Beide Dateien werden auf Ihrem Desktop gespeichert. Laden Sie die .cer-Datei in Schritt 3 in Azure hoch. Wenn Sie sich über Option B verbinden möchten, benötigen Sie außerdem die .pfx-Datei.
Notieren Sie sich den in der Konsole ausgegebenen Fingerabdruck. Sie verwenden ihn im Schritt „Verbinden“ mit New-AzureApplication.
Schritt 2: App in Microsoft Entra ID registrieren
Melden Sie sich im Microsoft Entra Admin Center als Globaler Administrator an.
Gehen Sie zu Entra ID > App registrations > New registration.
Geben Sie der App einen Namen (zum Beispiel ShareGate Migration).
Wählen Sie unter Supported account types die Option My organization only für eine App für einen einzelnen Mandanten oder Multiple Entra ID tenants für eine App für mehrere Mandanten, die in mehreren Mandanten verwendet wird.
Lassen Sie den Redirect URI leer.
Klicken Sie auf Register.
Kopieren Sie auf der Seite Overview die Application (client) ID. Sie verwenden sie mit
New-AzureApplication.
Schritt 3: Zertifikat hochladen
Gehen Sie in Ihrer App-Registrierung zu Certificates & secrets > Certificates und wählen Sie dann Upload certificate aus.
Laden Sie die
.cer-Datei von Ihrem Desktop hoch.Klicken Sie auf Add.
Schritt 4: API-Berechtigungen hinzufügen
Gehen Sie in Ihrer App-Registrierung zu API permissions > Add a permission.
Fügen Sie jede unten aufgeführte Application permission hinzu. Fügen Sie die Microsoft Graph-Berechtigungen und die SharePoint-Berechtigungen als getrennte Einträge hinzu. Wählen Sie keine Delegated permissions aus.
Klicken Sie auf Grant admin consent for [your tenant] und bestätigen Sie.
Microsoft Graph-Berechtigungen:
| Mitgliedschaft in Teams-Kanälen |
| Einstellungen von Teams-Kanälen |
| Verzeichnisobjekte |
| Dateien in allen Websitesammlungen |
| Microsoft 365-Gruppen |
| Informationsschutzrichtlinien |
| Vertraulichkeitsbezeichnungen |
| OneNote-Notizbücher |
| Vollzugriff auf alle Websitesammlungen |
| Elemente in allen Websitesammlungen erstellen, bearbeiten und löschen |
| Elemente in allen Websitesammlungen lesen und schreiben |
| Planner-Aufgaben |
| Teams erstellen |
| Teammitgliedschaft |
| Installationen von Teams-Apps |
| Teameinstellungen |
| Registerkarten in Teams-Kanälen |
| Terminologiespeicher |
| Benutzerprofile |
SharePoint-Berechtigungen:
Hinweis: SharePoint-Berechtigungen finden Sie in der API-Liste unter SharePoint, nicht unter Microsoft Graph.
| Vollzugriff auf alle Websitesammlungen |
| Elemente in allen Websitesammlungen erstellen, bearbeiten und löschen |
| Elemente in allen Websitesammlungen lesen |
| Elemente in allen Websitesammlungen lesen und schreiben |
| Terminologiespeicher (Lesen) |
| Terminologiespeicher (Lesen/Schreiben) |
| Benutzerprofile (Lesen) |
| Benutzerprofile (Lesen/Schreiben) |
Verbindung mit ShareGate herstellen
Erstellen Sie mit New-AzureApplication ein Anmeldeinformationsobjekt und übergeben Sie es dann an Connect-Site oder Connect-Tenant.
Option A: Zertifikatfingerabdruck (aus dem Erstellungsskript)
Wenn Sie das Skript aus Schritt 1 verwendet haben, befindet sich das Zertifikat in Cert:\CurrentUser\My. Übergeben Sie den Fingerabdruck direkt:
# 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
Option B: Zertifikat aus einer .pfx-Datei
Wenn Sie das Zertifikat als .pfx-Datei haben, laden Sie es direkt:
# 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
Ein einzelnes App-Objekt kann mehrere Verbindungen in derselben Sitzung authentifizieren. Verwenden Sie dieselbe $app-Variable für mehrere Connect-Site- oder Connect-Tenant-Aufrufe erneut.
Hinweis: Wenn Ihre Sicherheitsrichtlinie die Erteilung einer der erforderlichen Berechtigungen verhindert, fügen Sie -AllowMissingPermissions zu Connect-Site oder Connect-Tenant hinzu, um die Verbindung trotzdem herzustellen.
Vorgänge, die auf der fehlenden Berechtigung beruhen, schlagen mit Forbidden-Fehlern fehl.
Dieser Schalter lockert nur die Berechtigungsprüfung, nachdem die Authentifizierung erfolgreich war. Eine fehlgeschlagene Anmeldung behebt er nicht.
App speichern und wiederverwenden
Sie können ein App-Registrierungsobjekt speichern und in späteren Sitzungen wieder abrufen, sodass Sie es nicht jedes Mal neu erstellen müssen. Verwenden Sie Save-AzureApplication, um es zu speichern, und Get-AzureApplication, um es wieder zu laden.
Bekannte Einschränkungen
Verwaltete Metadaten-Werte werden bei der Migration nicht übernommen.
Benutzerbenachrichtigungen werden übersprungen. Bei reiner App-Authentifizierung gibt es keinen Benutzerkontext, in dem Benachrichtigungen gesendet werden könnten.
Klassische Web Parts werden nicht migriert.
Klassische SharePoint-Workflows werden nicht migriert.
InfoPath-Formulare werden teilweise migriert. Rechnen Sie mit Warnungen.
Genehmigungsworkflows für Veröffentlichungen erfordern einen Benutzerkontext. Rechnen Sie mit Fehlern oder Warnungen.
Vertraulichkeitsbezeichnungen werden bei der Migration nicht angewendet.
Teams-Kanalnachrichten werden bei reiner App-Authentifizierung nicht kopiert.
Private Chats kopieren
Sie können Ihre eigene Azure-App-Registrierung verwenden, um Copy-Chat aus PowerShell auszuführen. Richten Sie die App-Registrierung und das Zertifikat wie oben beschrieben ein und fügen Sie dann die folgenden Microsoft Graph-Application permissions hinzu. Sie sind in den Listen von Schritt 4 nicht enthalten.
| Chats erstellen |
| Alle Chats lesen und schreiben |
| Zu Microsoft Teams migrieren |
| Verzeichnisdaten lesen und schreiben |
Eine Beschreibung jeder Berechtigung finden Sie unter Für ShareGate erforderliche Microsoft 365-Berechtigungssätze.
Verwenden Sie zum Verbinden Connect-MicrosoftOnline mit dem Parameter -CopyFeature, der auf ChatCopy gesetzt ist. Verwenden Sie nicht Connect-Tenant, das nur für Teams-Migrationen gedacht ist.
# 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
Dieser Artikel wurde mithilfe künstlicher Intelligenz übersetzt. Wenden Sie sich im Zweifelsfall an die englische Originalversion.
