Einrichten eines Connectors zum Importieren von Personaldaten

Sie können einen Datenconnector einrichten, um Personaldaten im Zusammenhang mit Ereignissen wie dem Rücktritt eines Benutzers oder einer Änderung der Aufgabenebene eines Benutzers zu importieren. Die Insider-Risikomanagementlösung verwendet die HR-Daten, um Risikoindikatoren zu generieren, die Ihnen helfen, mögliche schädliche Aktivitäten oder Datendiebstahl durch Benutzer in Ihrem organization zu identifizieren.

Zum Einrichten eines Connectors für HR-Daten, die Insider-Risikomanagementrichtlinien verwenden, um Risikoindikatoren zu generieren, müssen Sie eine CSV-Datei erstellen, die die HR-Daten enthält, eine App in Microsoft Entra für die Authentifizierung erstellen, einen HR-Datenconnector im Microsoft Purview-Portal erstellen und ein Skript (planmäßig) ausführen, das die HR-Daten in CSV-Dateien in der Microsoft-Cloud erfasst, damit es für die Insider-Risikomanagementlösung verfügbar ist.

Bevor Sie beginnen

• Bestimmen Sie, welche HR-Szenarien und -Daten in Microsoft 365 importiert werden sollen. Diese Bestimmung hilft Ihnen zu entscheiden, wie viele CSV-Dateien und HR-Connectors Sie erstellen müssen, und wie die CSV-Dateien generiert und strukturiert werden sollen. Die Insider-Risikomanagementrichtlinien, die Sie implementieren möchten, bestimmen die hr-Daten, die Sie importieren. Weitere Informationen finden Sie unter Schritt 1.

• Bestimmen Sie, wie Die Daten (regelmäßig) aus dem HR-System Ihrer organization abgerufen oder exportiert werden, und fügen Sie sie den CSV-Dateien hinzu, die Sie in Schritt 1 erstellen. Das Skript, das Sie in Schritt 4 ausführen, lädt die PERSONAL-Daten in den CSV-Dateien in die Microsoft-Cloud hoch.

• Weisen Sie dem Benutzer, der den HR-Connector in Schritt 3 erstellt, die Rolle Datenconnector Admin zu. Diese Rolle ist erforderlich, um Connectors auf der Seite Datenconnectors im Microsoft Purview-Portal hinzuzufügen. Diese Rolle ist standardmäßig in mehreren Rollengruppen enthalten. Eine Liste dieser Rollengruppen finden Sie unter Rollen in Microsoft Defender for Office 365 und Microsoft Purview-Compliance. Alternativ kann ein Administrator in Ihrem organization eine benutzerdefinierte Rollengruppe erstellen, die Rolle Datenconnector Admin zuweisen und die entsprechenden Benutzer als Mitglieder hinzufügen. Weitere Anweisungen finden Sie in:

  • Berechtigungen im Microsoft Purview-Portal
  • Rollen und Rollengruppen in Microsoft Defender for Office 365 und Microsoft Purview Compliance

• Verstehen Sie, dass das Beispielskript, das Sie in Schritt 4 ausführen, Ihre Personaldaten in die Microsoft-Cloud hochlädt, damit sie von der Insider-Risikomanagementlösung verwendet werden können. Dieses Beispielskript wird von keinem Microsoft-Standardsupportprogramm oder -Dienst unterstützt. Es wird ohne jegliche Garantie bereitgestellt. Microsoft schließt ferner alle konkludenten Gewährleistungen, einschließlich, aber nicht beschränkt auf konkludente Gewährleistungen der Marktgängigkeit oder Eignung für einen bestimmten Zweck aus. Sie übernehmen alle Risiken, die sich aus der Verwendung oder Leistung des Beispielskripts und der Dokumentation ergeben. In keinem Fall sind Microsoft, seine Autoren oder an der Erstellung, Produktion oder Übermittlung der Skripts beteiligte Personen für Schäden jeglicher Art (einschließlich und ohne Einschränkung Schäden durch Verlust entgangener Gewinne, Geschäftsunterbrechungen, Verlust von Geschäftsinformationen oder andere geldliche Verluste) haftbar, die aus der Nutzung bzw. Unfähigkeit zur Nutzung der Beispielskripts oder Dokumentation entstehen, auch wenn Microsoft auf die Möglichkeit solcher Schäden hingewiesen wurde.

• Dieser Connector ist in GCC-Umgebungen in der Microsoft 365 US Government-Cloud verfügbar. Anwendungen und Dienste von Drittanbietern können das Speichern, Übertragen und Verarbeiten von Kundendaten Ihrer organization auf Systemen von Drittanbietern umfassen, die sich außerhalb der Microsoft 365-Infrastruktur befinden und daher nicht durch die Microsoft Purview- und Datenschutzverpflichtungen abgedeckt sind. Microsoft übernimmt keine Zusicherung, dass die Verwendung dieses Produkts zum Herstellen einer Verbindung mit Anwendungen von Drittanbietern bedeutet, dass diese Anwendungen von Drittanbietern FEDRAMP-konform sind. Schritt-für-Schritt-Anweisungen zum Einrichten eines HR-Connectors in einer GCC-Umgebung finden Sie unter Einrichten eines Connectors zum Importieren von HR-Daten in us-behörden.

• Fügen Sie die webhook.ingestion.office.com Domäne ihrer Firewall-Positivliste für Ihre organization hinzu.

Schritt 1: Vorbereiten einer CSV-Datei mit Ihren Personaldaten

Erstellen Sie zunächst eine CSV-Datei, die die Personaldaten enthält, die der Connector in Microsoft 365 importiert. Die Insider-Risikolösung verwendet diese Daten, um potenzielle Risikoindikatoren zu generieren. Sie können Daten für die folgenden HR-Szenarien in Microsoft 365 importieren:

• Kündigung des Mitarbeiters. Informationen zu Mitarbeitern, die Ihre organization verlassen.

• Änderungen an der Auftragsebene. Informationen zu Änderungen an der Positionsebene für Mitarbeiter, z. B. Beförderungen und Herabstufungen.

• Leistungsüberprüfungen. Informationen zur Mitarbeiterleistung.

• Pläne zur Leistungsverbesserung. Informationen zu Leistungsverbesserungsplänen für Mitarbeiter.

• Mitarbeiterprofil (Vorschau). Allgemeine Informationen zu einem Mitarbeiter.

Die Art der zu importierenden HR-Daten hängt von der Insider-Risikomanagementrichtlinie und der entsprechenden Richtlinienvorlage ab, die Sie implementieren möchten. Die folgende Tabelle zeigt, welchen HR-Datentyp jede Richtlinienvorlage erfordert:

Weitere Informationen zu Richtlinienvorlagen für das Insider-Risikomanagement finden Sie unter Insider-Risikomanagementrichtlinien.

Geben Sie für jedes HR-Szenario die entsprechenden Personaldaten in einer oder mehreren CSV-Dateien an. Die Anzahl der CSV-Dateien, die für Ihre Implementierung des Insider-Risikomanagements verwendet werden sollen, wird weiter unten in diesem Abschnitt erläutert.

Nachdem Sie die CSV-Datei mit den erforderlichen Personaldaten erstellt haben, speichern Sie sie auf dem lokalen Computer, auf dem Sie das Skript in Schritt 4 ausführen. Implementieren Sie eine Updatestrategie, um sicherzustellen, dass die CSV-Datei immer die aktuellsten Informationen enthält, damit unabhängig davon, wie Sie das Skript ausführen, die aktuellsten PERSONAL-Daten in die Microsoft-Cloud hochgeladen und für die Insider-Risikomanagementlösung zugänglich sind.

CSV-Datei für Mitarbeiterrücktrittsdaten

Hier sehen Sie ein Beispiel für eine CSV-Datei für Mitarbeiterrücktrittsdaten.

UserPrincipalName,ResignationDate,LastWorkingDate
sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,2019-04-29T15:18:02.4675041+05:30
pilarp@contoso.com,2019-04-24T09:15:49Z,2019-04-29T15:18:02.7117540

In der folgenden Tabelle werden die einzelnen Spalten in der CSV-Datei für Mitarbeiterrücktrittsdaten beschrieben.

CSV-Datei für Änderungsdaten auf Auftragsebene

Hier sehen Sie ein Beispiel für eine CSV-Datei für Änderungsdaten auf Auftragsebene.

UserPrincipalName,EffectiveDate,OldLevel,NewLevel
sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,Level 61 - Sr. Manager,Level 60- Manager
pillar@contoso.com,2019-04-23T15:18:02.4675041+05:30,Level 62 - Director,Level 60- Sr. Manager

In der folgenden Tabelle werden die einzelnen Spalten in der CSV-Datei für Änderungsdaten auf Auftragsebene beschrieben.

CSV-Datei für Leistungsüberprüfungsdaten

Hier sehen Sie ein Beispiel für eine CSV-Datei für Leistungsdaten.

UserPrincipalName,EffectiveDate,Remarks,Rating
sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,Met expectations but bad attitude,2-Below expectation
pillar@contoso.com,2019-04-23T15:18:02.4675041+05:30, Multiple conflicts with the team

In der folgenden Tabelle werden die einzelnen Spalten in der CSV-Datei für Leistungsüberprüfungsdaten beschrieben.

CSV-Datei für Leistungsverbesserungsplandaten

Hier sehen Sie ein Beispiel für eine CSV-Datei für die Daten für die Leistungsverbesserungsplandaten.

UserPrincipalName,EffectiveDate,ImprovementRemarks,PerformanceRating
sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,Met expectation but bad attitude,2-Below expectation
pillar@contoso.com,2019-04-23T15:18:02.4675041+05:30, Multiple conflicts with the team

In der folgenden Tabelle werden die einzelnen Spalten in der CSV-Datei für Leistungsüberprüfungsdaten beschrieben.

CSV-Datei für Mitarbeiterprofildaten (Vorschau)

Hier sehen Sie ein Beispiel für eine CSV-Datei für Mitarbeiterprofildaten.

UserPrincipalName,UserName,EmployeeFirstName,EmployeeLastName,EmployeeAddLine1,EmployeeAddLine2,EmployeeCity,EmployeeState,EmployeeZipCode,EmployeeDept,EmployeeType,EmployeeRole
jackq@contoso.com,jackq,jack,qualtz,50 Oakland Ave,#206,City,Florida,32104,Orthopaedic,Regular,Nurse

In der folgenden Tabelle werden die einzelnen Spalten in der CSV-Datei für Mitarbeiterprofildaten beschrieben.

Es wird empfohlen, einen HR-Connector zu erstellen, der nur Mitarbeiterprofildaten importiert. Aktualisieren Sie für diesen Connector häufig die Mitarbeiterprofildaten, vorzugsweise alle 15 bis 20 Tage. Mitarbeiterprofildatensätze werden gelöscht, wenn Sie sie in den letzten 30 Tagen nicht aktualisiert haben.

Bestimmen, wie viele CSV-Dateien für Personaldaten verwendet werden sollen

In Schritt 3 können Sie separate Connectors für jeden HR-Datentyp oder einen einzelnen Connector für alle Datentypen erstellen. Sie können separate CSV-Dateien verwenden, die Daten für ein HR-Szenario enthalten (wie in den Beispielen der CSV-Dateien, die in den vorherigen Abschnitten beschrieben wurden). Alternativ können Sie eine einzelne CSV-Datei verwenden, die Daten für zwei oder mehr HR-Szenarien enthält. Hier finden Sie einige Richtlinien, mit denen Sie bestimmen können, wie viele CSV-Dateien für Personaldaten verwendet werden sollen.

• Wenn die Insider-Risikomanagementrichtlinie, die Sie implementieren möchten, mehrere HR-Datentypen erfordert, sollten Sie eine einzelne CSV-Datei verwenden, die alle erforderlichen Datentypen enthält.

• Die Methode zum Generieren oder Sammeln der Personaldaten kann die Anzahl der CSV-Dateien bestimmen. Wenn sich beispielsweise die verschiedenen Typen von HR-Daten, die zum Konfigurieren eines HR-Connectors verwendet werden, in einem einzelnen HR-System in Ihrem organization befinden, können Sie die Daten möglicherweise in eine einzelne CSV-Datei exportieren. Wenn Daten jedoch auf verschiedene HR-Systeme verteilt sind, ist es möglicherweise einfacher, Daten in verschiedene CSV-Dateien zu exportieren. Beispielsweise können sich Mitarbeiterrücktrittsdaten in einem anderen HR-System befinden als Daten zur Auftrags- oder Leistungsüberprüfung. In diesem Fall ist es möglicherweise einfacher, separate CSV-Dateien zu verwenden, anstatt die Daten manuell in einer einzelnen CSV-Datei kombinieren zu müssen. Wie Sie Also Daten aus Ihren HR-Systemen abrufen oder exportieren, hängt möglicherweise davon ab, wie viele CSV-Dateien Sie benötigen.

• In der Regel bestimmen die Datentypen in einer CSV-Datei die Anzahl der HR-Connectors, die Sie erstellen müssen. Wenn eine CSV-Datei beispielsweise alle Datentypen enthält, die zur Unterstützung Ihrer Insider-Risikomanagementimplementierung erforderlich sind, benötigen Sie nur einen HR-Connector. Wenn Sie jedoch über zwei separate CSV-Dateien verfügen, die jeweils einen einzelnen Datentyp enthalten, müssen Sie zwei HR-Connectors erstellen. Eine Ausnahme von dieser Regel besteht darin, dass Sie beim Hinzufügen einer HRScenario-Spalte zu einer CSV-Datei (siehe nächster Abschnitt) einen einzelnen HR-Connector konfigurieren können, der verschiedene CSV-Dateien verarbeiten kann.

• Für jede CSV-Datei können Sie bis zu 500 Datensätze gleichzeitig erfassen. Um eine größere Anzahl von Datensätzen zu erfassen, laden Sie mehrere CSV-Dateien mit jeweils weniger als 500 Datensätzen hoch.

Konfigurieren einer einzelnen CSV-Datei für mehrere HR-Datentypen

Sie können einer einzelnen CSV-Datei mehrere HR-Datentypen hinzufügen. Diese Konfiguration ist nützlich, wenn die Insider-Risikomanagementlösung, die Sie implementieren, mehrere HR-Datentypen erfordert oder wenn sich die Datentypen in einem einzelnen HR-System in Ihrem organization befinden. Mit weniger CSV-Dateien können Sie immer weniger PERSONALconnectors erstellen und verwalten.

Hier sind die Anforderungen für die Konfiguration einer CSV-Datei mit mehreren Datentypen:

• Fügen Sie die erforderlichen Spalten (und ggf. optionale Spalten) für jeden Datentyp und den entsprechenden Spaltennamen in der Kopfzeile hinzu. Wenn ein Datentyp keiner Spalte entspricht, lassen Sie den Wert leer.

• Fügen Sie der CSV-Datei eine HRScenario-Spalte hinzu. Der HR-Connector verwendet diese Spalte, um zu identifizieren, welche Zeilen in der CSV-Datei welchen Typ HR-Daten enthalten. Die Werte in dieser Spalte geben den Typ der Personaldaten in jeder Zeile an. Werte, die den HR-Szenarien entsprechen, könnten beispielsweise "Resignation", "Job level change", "Performance review", "Performance Improvement Plan" und "Employee profile" lauten.

• Wenn Sie über mehrere CSV-Dateien verfügen, die eine HRScenario-Spalte enthalten, stellen Sie sicher, dass jede Datei denselben Spaltennamen und die gleichen Werte verwendet, die die spezifischen HR-Szenarien identifizieren.

Das folgende Beispiel zeigt eine CSV-Datei, die die SPALTE HRScenario enthält. Die Werte in der SPALTE HRScenario geben den Datentyp in der entsprechenden Zeile an. Im folgenden Beispiel werden die vier Hr-Szenarien "Resignation", "Job level change", "Performance Review" und "Performance Improvement Plan" behandelt.

HRScenario,EmailAddress,ResignationDate,LastWorkingDate,EffectiveDate,Remarks,Rating,OldLevel,NewLevel
Resignation,sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,2019-04-29T15:18:02.4675041+05:30,,,,
Resignation,pilarp@contoso.com,2019-04-24T09:15:49Z,2019-04-29T15:18:02.7117540,,,,
Job level change,sarad@contoso.com,2019-04-23T15:18:02.4675041+05:30,,,,,Level 61 Sr. Manager, Level 60 Manager
Job level change,pillarp@contoso.com,2019-04-23T15:18:02.4675041+05:30,,,,,Level 62 Director,Level 60 Sr Manager
Performance review,sarad@contoso.com,,,2019-04-23T15:18:02.4675041+05:30,Met expectation but bad attitude,2 Below expectations,,
Performance review,pillarp@contoso.com,,,2019-04-23T15:18:02.4675041+05:30, Multiple conflicts with the team,,
Performance improvement plan,sarad@contoso.com,,,2019-04-23T15:18:02.4675041+05:30,Met expectations but bad attitude,2 Below expectations,,
Performance improvement plan,pillarp@contoso.com,,,2019-04-23T15:18:02.4675041+05:30,Multiple conflicts with the team,,

Hinzufügen der HRScenario-Spalte zu einer CSV-Datei, die einen einzelnen Datentyp enthält

Basierend auf den HR-Systemen Ihres organization und der Art, wie Sie Hr-Daten in eine CSV-Datei exportieren, müssen Sie möglicherweise mehrere CSV-Dateien erstellen, die jeweils einen einzelnen HR-Datentyp enthalten. In diesem Fall können Sie weiterhin einen einzelnen HR-Connector erstellen, um Daten aus verschiedenen CSV-Dateien zu importieren. Fügen Sie dazu der CSV-Datei eine HRScenario-Spalte hinzu, und geben Sie den HR-Datentyp an. Anschließend können Sie das Skript für jede CSV-Datei ausführen, aber dieselbe Auftrags-ID für den Connector verwenden. Weitere Informationen finden Sie unter Schritt 4.

Schritt 2: Erstellen einer App in Microsoft Entra ID

Erstellen und registrieren Sie als Nächstes eine neue App in Microsoft Entra ID. Die App entspricht dem HR-Connector, den Sie in Schritt 3 erstellen. Wenn Sie diese App erstellen, kann Microsoft Entra-ID den HR-Connector authentifizieren, wenn er ausgeführt wird und versucht, auf Ihre organization zuzugreifen. Diese App authentifiziert auch das Skript, das Sie in Schritt 4 ausführen, um Ihre PERSONAL-Daten in die Microsoft-Cloud hochzuladen. Speichern Sie während der Erstellung dieser Microsoft Entra-App die folgenden Informationen. Sie verwenden diese Werte in Schritt 3 und Schritt 4.

• Microsoft Entra Anwendungs-ID (auch als App-ID oder Client-ID bezeichnet)
• Microsoft Entra Anwendungsgeheimnis (auch als geheimer Clientschlüssel bezeichnet)
• Mandanten-ID (auch verzeichnis-ID genannt)

Schritt-für-Schritt-Anweisungen zum Erstellen einer App in Microsoft Entra-ID finden Sie unter Registrieren einer Anwendung beim Microsoft Identity Platform.

Schritt 3: Erstellen des HR-Connectors

Der nächste Schritt besteht darin, einen HR-Connector im Microsoft Purview-Portal zu erstellen. Nachdem Sie das Skript in Schritt 4 ausgeführt haben, erfasst der hr-Connector, den Sie erstellen, die HR-Daten aus der CSV-Datei in Ihrem Microsoft 365-organization. Bevor Sie einen Connector erstellen, stellen Sie sicher, dass Sie über eine Liste der HR-Szenarien und die entsprechenden CSV-Spaltennamen für jedes Szenario verfügen. Sie müssen die für jedes Szenario erforderlichen Daten den tatsächlichen Spaltennamen in Ihrer CSV-Datei zuordnen, wenn Sie den Connector konfigurieren. Alternativ können Sie beim Konfigurieren des Connectors eine CSV-Beispieldatei hochladen, und der Workflow hilft Ihnen dabei, den Namen der Spalten den erforderlichen Datentypen zuzuordnen.

Kopieren Sie nach Abschluss dieses Schritts unbedingt die Auftrags-ID, die beim Erstellen des Connectors generiert wird. Sie verwenden die Auftrags-ID, wenn Sie das Skript ausführen.

1. Melden Sie sich beim Microsoft Purview-Portal an.

2. Wählen Sie Einstellungen>Datenconnectors aus.

3. Wählen Sie Meine Connectors und dann Connector hinzufügen aus.

4. Wählen Sie in der Liste HR (Vorschau) aus.

5. Führen Sie auf der Seite Verbindung einrichten die folgenden Schritte aus, und wählen Sie dann Weiter aus:

   1. Geben Sie die Microsoft Entra Anwendungs-ID für die Azure-App ein, die Sie in Schritt 2 erstellt haben, oder fügen Sie sie ein.

   2. Geben Sie einen Namen für den HR-Connector ein.

6. Wählen Sie auf der Seite HR-Szenarien ein oder mehrere HR-Szenarien aus, für die Sie Daten importieren möchten, und wählen Sie dann Weiter aus.

   

7. Wählen Sie auf der Seite dateizuordnungsmethode ggf. einen Dateityp aus, wählen Sie dann eine der folgenden Optionen und dann Weiter aus.

   • Laden Sie eine Beispieldatei hoch. Wenn Sie diese Option auswählen, wählen Sie Beispieldatei hochladen aus, um die CSV-Datei hochzuladen, die Sie in Schritt 1 vorbereitet haben. Mit dieser Option können Sie schnell Spaltennamen in Ihrer CSV-Datei aus einer Dropdownliste auswählen, um sie den Datentypen für die zuvor ausgewählten HR-Szenarien zuzuordnen.

   OR

   • Geben Sie die Zuordnungsdetails manuell an. Wenn Sie diese Option auswählen, müssen Sie den Namen der Spalten in Ihrer CSV-Datei eingeben, um sie den Datentypen für die zuvor ausgewählten HR-Szenarien zuzuordnen.

8. Führen Sie auf der Seite Dateizuordnungsdetails eine der folgenden Aktionen aus, je nachdem, ob Sie eine CSV-Beispieldatei hochgeladen haben und ob Sie den Connector für ein einzelnes HR-Szenario oder für mehrere Szenarien konfigurieren. Wenn Sie eine Beispieldatei hochgeladen haben, müssen Sie die Spaltennamen nicht eingeben. Sie wählen sie aus einer Dropdownliste aus.

   • Wenn Sie im vorherigen Schritt ein einzelnes HR-Szenario ausgewählt haben, geben Sie die Spaltenkopfzeilennamen (auch Parameter genannt) aus der CSV-Datei ein, die Sie in Schritt 1 in jedem der entsprechenden Felder erstellt haben. Bei den spaltennamen, die Sie eingeben, wird die Groß-/Kleinschreibung nicht beachtet. Achten Sie jedoch darauf, Leerzeichen einzuschließen, wenn die Spaltennamen in Ihrer CSV-Datei Leerzeichen enthalten. Wie bereits erläutert, müssen die Namen, die Sie in diese Felder eingeben, mit den Parameternamen in Ihrer CSV-Datei übereinstimmen. Der folgende Screenshot zeigt z. B. die Parameternamen aus der CSV-Beispieldatei für das HR-Szenario zum Ausscheiden eines Mitarbeiters, das in Schritt 1 gezeigt wird.

   • Wenn Sie im vorherigen Schritt mehrere Datentypen ausgewählt haben, müssen Sie den Bezeichnerspaltennamen eingeben, der den HR-Datentyp in Ihrer CSV-Datei identifiziert. Nachdem Sie den Spaltennamen des Bezeichners eingegeben haben, geben Sie den Wert ein, der diesen HR-Datentyp identifiziert, und geben Sie die Spaltenüberschriftennamen für ausgewählte Datentypen aus den CSV-Dateien ein, die Sie in Schritt 1 in jedem der entsprechenden Felder für jeden ausgewählten Datentyp erstellt haben. Wie bereits erläutert, müssen die Namen, die Sie in diese Felder eingeben, mit den Spaltennamen in Ihrer CSV-Datei übereinstimmen.

9. Überprüfen Sie auf der Seite Überprüfen Ihre Einstellungen, und wählen Sie dann Fertig stellen aus, um den Connector zu erstellen.

   Eine status Seite wird angezeigt, die bestätigt, dass der Connector erstellt wurde. Diese Seite enthält zwei wichtige Dinge, die Sie zum Ausführen des Beispielskripts zum Hochladen Ihrer Personaldaten im nächsten Schritt ausführen müssen.

   

   1. Auftrags-ID. Sie benötigen diese Auftrags-ID, um das Skript im nächsten Schritt auszuführen. Sie können es von dieser Seite oder von der Connector-Flyoutseite kopieren.

   2. Link zum Beispielskript. Wählen Sie den Link hier aus, um zur GitHub-Website zu wechseln, um auf das Beispielskript zuzugreifen (der Link öffnet ein neues Fenster). Lassen Sie dieses Fenster geöffnet, damit Sie das Skript in Schritt 4 kopieren können. Alternativ können Sie das Ziel mit einem Lesezeichen versehen oder die URL kopieren, damit Sie beim Ausführen des Skripts erneut darauf zugreifen können. Dieser Link ist auch auf der Connector-Flyoutseite verfügbar.

10. Wählen Sie Fertig aus.

    Der neue Connector wird in der Liste auf der Registerkarte Connectors angezeigt.

11. Wählen Sie den HR-Connector aus, den Sie gerade erstellt haben, um die Flyoutseite anzuzeigen, die Eigenschaften und andere Informationen zum Connector enthält.

    

Falls noch nicht geschehen, können Sie die Werte für die Azure-App-ID und die Connectorauftrags-ID kopieren. Sie benötigen diese, um das Skript im nächsten Schritt auszuführen. Sie können das Skript auch von der Flyoutseite herunterladen (oder es über den Link im nächsten Schritt herunterladen).)

Sie können auch Bearbeiten auswählen, um die Azure-App-ID oder die Spaltenüberschriftennamen zu ändern, die Sie auf der Seite Dateizuordnung definiert haben.

Schritt 4: Ausführen des Beispielskripts zum Hochladen Ihrer Personaldaten

Der letzte Schritt beim Einrichten eines HR-Connectors besteht darin, ein Beispielskript auszuführen, das die PERSONAL-Daten in der CSV-Datei (die Sie in Schritt 1 erstellt haben) in die Microsoft-Cloud hochlädt. Insbesondere lädt das Skript die Daten in den HR-Connector hoch. Nachdem Sie das Skript ausgeführt haben, importiert der HR-Connector, den Sie in Schritt 3 erstellt haben, die Personaldaten in Ihre Microsoft 365-organization wo andere Compliancetools wie die Insider-Risikomanagementlösung darauf zugreifen können. Nachdem Sie das Skript ausgeführt haben, sollten Sie eine Aufgabe so planen, dass sie täglich automatisch ausgeführt wird, damit die aktuellen Mitarbeiterbeendigungsdaten in die Microsoft-Cloud hochgeladen werden. Weitere Informationen finden Sie unter Planen der automatischen Ausführung des Skripts.

1. Wechseln Sie zu dem Fenster, das Sie im vorherigen Schritt geöffnet haben, um mit dem Beispielskript auf die GitHub-Website zuzugreifen. Alternativ können Sie die mit Einem Lesezeichen versehene Website öffnen oder die url verwenden, die Sie kopiert haben. Sie können auch hier auf das Skript zugreifen.

2. Wählen Sie die Schaltfläche Roh aus, um das Skript in der Textansicht anzuzeigen.

3. Kopieren Sie alle Zeilen im Beispielskript, und speichern Sie sie in einer Textdatei.

4. Ändern Sie bei Bedarf das Beispielskript für Ihre organization.

5. Speichern Sie die Textdatei als Windows PowerShell Skriptdatei, indem Sie das Dateinamensuffix verwenden.ps1, HRConnector.ps1z. B. . Alternativ können Sie den GitHub-Dateinamen für das Skript verwenden, der ist upload_termination_records.ps1.

6. Öffnen Sie eine Eingabeaufforderung auf Ihrem lokalen Computer, und wechseln Sie zu dem Verzeichnis, in dem Sie das Skript gespeichert haben.

7. Führen Sie den folgenden Befehl aus, um die Personaldaten in der CSV-Datei in die Microsoft-Cloud hochzuladen. Zum Beispiel:

   .\HRConnector.ps1 -tenantId <tenantId> -appId <appId>  -appSecret <appSecret>  -jobId <jobId>  -filePath '<filePath>'
   

   In der folgenden Tabelle werden die Parameter, die mit diesem Skript verwendet werden sollen, und die erforderlichen Werte beschrieben. Die Informationen, die Sie in den vorherigen Schritten erhalten haben, werden in den Werten für diese Parameter verwendet.

   Parameter	Beschreibung
   tenantId	Dies ist die ID für Ihre Microsoft 365-organization, die Sie in Schritt 2 erhalten haben. Sie können die Mandanten-ID für Ihre organization auch auf dem Blatt Übersicht im Microsoft Entra Admin Center abrufen. Dieser Wert identifiziert Ihre organization.
   appId	Dies ist die Microsoft Entra Anwendungs-ID für die App, die Sie in Microsoft Entra ID in Schritt 2 erstellt haben. Dieser Wert wird von Microsoft Entra ID für die Authentifizierung verwendet, wenn das Skript versucht, auf Ihre Microsoft 365-organization zuzugreifen.
   appSecret	Dies ist das Microsoft Entra Anwendungsgeheimnis für die App, die Sie in schritt 2 in Microsoft Entra ID erstellt haben. Dieser Wert wird auch für die Authentifizierung verwendet.
   jobId	Dies ist die Auftrags-ID für den HR-Connector, den Sie in Schritt 3 erstellt haben. Dieser Wert ordnet die HR-Daten, die in die Microsoft-Cloud hochgeladen werden, dem HR-Connector zu.
   filePath	Dies ist der Dateipfad für die Datei (gespeichert auf demselben System wie das Skript), die Sie in Schritt 1 erstellt haben. Versuchen Sie, Leerzeichen im Dateipfad zu vermeiden. verwenden Sie andernfalls einfache Anführungszeichen.

   Hier sehen Sie ein Beispiel für die Syntax für das HR-Connectorskript, das die tatsächlichen Werte für jeden Parameter verwendet:

   .\HRConnector.ps1 -tenantId d5723623-11cf-4e2e-b5a5-01d1506273g9 -appId 29ee526e-f9a7-4e98-a682-67f41bfd643e -appSecret MNubVGbcQDkGCnn -jobId b8be4a7d-e338-43eb-a69e-c513cd458eba -filePath 'C:\Users\contosoadmin\Desktop\Data\employee_termination_data.csv'
   

   Wenn der Upload erfolgreich ist, zeigt das Skript die Meldung Upload Successful (Upload erfolgreich) an .

   Hinweis

   Wenn Sie aufgrund von Ausführungsrichtlinien Probleme beim Ausführen des vorherigen Befehls haben, finden Sie unter Informationen zu Ausführungsrichtlinien und Set-ExecutionPolicy Anleitungen zum Festlegen von Ausführungsrichtlinien.

Schritt 5: Überwachen des HR-Connectors

Nachdem Sie den HR-Connector erstellt und das Skript zum Hochladen Ihrer HR-Daten ausgeführt haben, können Sie den Connector anzeigen und status im Microsoft Purview-Portal hochladen. Wenn Sie die automatische Ausführung des Skripts in regelmäßigen Abständen planen, können Sie auch die aktuelle status nach der letzten Ausführung des Skripts anzeigen.

1. Melden Sie sich beim Microsoft Purview-Portal an.

2. Wählen Sie Einstellungen>Datenconnectors aus.

3. Wählen Sie Meine Connectors und dann den HR-Connector aus, den Sie erstellt haben, um die Flyoutseite anzuzeigen. Diese Seite enthält die Eigenschaften und Informationen zum Connector.

4. Wählen Sie unter Status den Link Protokoll herunterladen aus, um das status Protokoll für den Connector zu öffnen (oder zu speichern). Dieses Protokoll enthält Informationen zu jeder Ausführung des Skripts und lädt die Daten aus der CSV-Datei in die Microsoft-Cloud hoch.

   

   Das RecordsSaved Feld gibt die Anzahl der Zeilen in der CSV-Datei an, die Sie hochgeladen haben. Wenn die CSV-Datei beispielsweise vier Zeilen enthält, ist der Wert der RecordsSaved Felder 4, wenn das Skript erfolgreich alle Zeilen in der CSV-Datei hochlädt.

Wenn Sie das Skript in Schritt 4 nicht ausgeführt haben, wird unter Letzter Import ein Link zum Herunterladen des Skripts angezeigt. Sie können das Skript herunterladen und dann die Schritte zum Ausführen des Skripts ausführen.

(Optional) Schritt 6: Planen der automatischen Ausführung des Skripts

Um sicherzustellen, dass Tools wie die Insider-Risikomanagementlösung immer Zugriff auf die neuesten HR-Daten aus Ihrem organization haben, planen Sie das Skript so, dass es automatisch auf wiederkehrender Basis ausgeführt wird, z. B. einmal pro Tag. Dieser Zeitplan erfordert die Aktualisierung der Personaldaten in der CSV-Datei nach einem ähnlichen (wenn nicht demselben) Zeitplan, sodass er die neuesten Informationen zu Mitarbeitern enthält, die Ihre organization verlassen. Ziel ist es, die aktuellsten HR-Daten hochzuladen, damit der HR-Connector sie der Insider-Risikomanagementlösung zur Verfügung stellen kann.

Verwenden Sie die Taskplaner-App in Windows, um das Skript automatisch täglich auszuführen.

1. Wählen Sie auf Ihrem lokalen Computer die Windows-Schaltfläche Start aus, und geben Sie aufgabenplaner ein.

2. Wählen Sie die App Aufgabenplanung aus, um sie zu öffnen.

3. Wählen Sie im Abschnitt Aktionen die Option Aufgabe erstellen aus.

4. Geben Sie auf der Registerkarte Allgemein einen beschreibenden Namen für die geplante Aufgabe ein, z. B. HR Connector Script. Sie können auch eine optionale Beschreibung hinzufügen.

5. Führen Sie unter Sicherheitsoptionen die folgenden Schritte aus:

   1. Entscheiden Sie, ob das Skript nur ausgeführt werden soll, wenn Sie am Computer angemeldet sind, oder ob es ausgeführt werden soll, wenn Sie angemeldet sind oder nicht.

   2. Stellen Sie sicher, dass das Kontrollkästchen Mit den höchsten Berechtigungen ausführen aktiviert ist.

6. Wählen Sie die Registerkarte Trigger aus , wählen Sie Neu aus, und führen Sie dann die folgenden Schritte aus:

   1. Wählen Sie unter Einstellungen die Option Täglich aus, und wählen Sie dann ein Datum und eine Uhrzeit für die erstmalige Ausführung des Skripts aus. Das Skript wird täglich zur angegebenen Zeit ausgeführt.

   2. Stellen Sie sicher, dass unter Erweiterte Einstellungen das Kontrollkästchen Aktiviert aktiviert ist.

   3. Wählen Sie OK aus.

7. Wählen Sie die Registerkarte Aktionen aus, wählen Sie Neu aus, und führen Sie dann die folgenden Schritte aus:

   

   1. Stellen Sie in der Dropdownliste Aktion sicher, dass Programm starten ausgewählt ist.

   2. Wählen Sie im Feld Programm/Skriptdie Option Durchsuchen aus, wechseln Sie zum folgenden Speicherort, und wählen Sie ihn aus, damit der Pfad im Feld angezeigt wird: C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe.

   3. Fügen Sie im Feld Argumente hinzufügen (optional) den gleichen Skriptbefehl ein, den Sie in Schritt 4 ausgeführt haben. Beispiel: .\HRConnector.ps1 -tenantId "d5723623-11cf-4e2e-b5a5-01d1506273g9" -appId "c12823b7-b55a-4989-faba-02de41bb97c3" -appSecret "MNubVGbcQDkGCnn" -jobId "e081f4f4-3831-48d6-7bb3-fcfab1581458" -filePath "C:\Users\contosoadmin\Desktop\Data\employee_termination_data.csv"

   4. Fügen Sie im Feld Start in (optional) den Ordnerspeicherort des Skripts ein, das Sie in Schritt 4 ausgeführt haben. Beispiel: C:\Users\contosoadmin\Desktop\Scripts.

   5. Wählen Sie OK aus, um die Einstellungen für die neue Aktion zu speichern.

8. Wählen Sie im Fenster Aufgabe erstellendie Option OK aus, um die geplante Aufgabe zu speichern. Möglicherweise werden Sie aufgefordert, Ihre Anmeldeinformationen für Ihr Benutzerkonto einzugeben.

   Die neue Aufgabe wird in der Taskplanerbibliothek angezeigt.

   

   Der Zeitpunkt, zu dem das Skript zuletzt ausgeführt wurde, und die nächste geplante Ausführung wird angezeigt. Sie können die Aufgabe doppelt auswählen, um sie zu bearbeiten.

   Sie können auch überprüfen, zu dem das Skript zuletzt ausgeführt wurde, auf der Flyoutseite des entsprechenden HR-Connectors im Compliance Center.

(Optional) Schritt 7: Hochladen von Daten mithilfe von Power Automate-Vorlagen

Sie können Personaldaten mithilfe von Power Automate-Vorlagen hochladen und Trigger definieren. Sie können beispielsweise eine Power Automate-Vorlage so konfigurieren, dass sie ausgelöst wird, wenn neue HR-Connectordateien an SharePoint- oder OneDrive-Speicherorten verfügbar sind. Sie können diesen Prozess auch optimieren, indem Sie vertrauliche Informationen wie Microsoft Entra Anwendungsgeheimnis (erstellt in Schritt 2) in Azure Key Vault speichern und mit Power Automate für die Authentifizierung verwenden.

Führen Sie die folgenden Schritte aus, um hr-Daten automatisch hochzuladen, wenn neue Dateien auf OneDrive for Business verfügbar werden:

1. Laden Sie das ImportHRDataforIRM.zip-Paket von der GitHub-Website herunter.

2. Wechseln Sie in Power Automate zu Meine Flows.

3. Wählen Sie Importieren aus, und laden Sie das ImportHRDataforIRM.zip-Paket hoch.

4. Nachdem das Paket hochgeladen wurde, aktualisieren Sie den Inhalt (Name und OneDrive for Business Verbindung), und wählen Sie Importieren aus.

   

5. Wählen Sie Flow öffnen aus, und aktualisieren Sie die Parameter. In der folgenden Tabelle werden die Parameter beschrieben, die in diesem Power Automate-Flow verwendet werden sollen, und ihre erforderlichen Werte. Verwenden Sie die Informationen, die Sie in den vorherigen Schritten für diese Werte erhalten haben.

1. Klicken Sie auf Speichern.

2. Wechseln Sie zu Flowübersicht , und wählen Sie Aktivieren aus.

   

3. Testen Sie den Flow manuell, indem Sie eine neue Datei in Ihren OneDrive for Business Ordner hochladen und überprüfen, ob sie erfolgreich ausgeführt wurde. Dieser Prozess kann nach dem Upload einige Minuten dauern, bevor der Flow ausgelöst wird.

   

4. Sie können jetzt den HR-Connector überwachen, wie in Schritt 5 beschrieben.

Bei Bedarf können Sie den Flow aktualisieren, um Trigger basierend auf Dateiverfügbarkeits- und Änderungsereignissen in SharePoint und anderen Datenquellen zu erstellen, die von Power Automate Flows unterstützt werden.

Vorhandene HR-Connectors

Am 13. Dezember 2021 haben wir das Mitarbeiterprofildatenszenario für PERSONALconnectors veröffentlicht. Wenn Sie vor diesem Datum einen HR-Connector erstellt haben, migrieren wir die vorhandenen Instanzen oder die HR-Connectors Ihres organization, damit Ihre HR-Daten weiterhin in die Microsoft-Cloud importiert werden. Sie müssen nichts tun, um diese Funktionalität aufrechtzuerhalten. Sie können diese Connectors weiterhin ohne Unterbrechung verwenden.

Wenn Sie das Mitarbeiterprofildatenszenario implementieren möchten, erstellen Sie einen neuen HR-Connector, und konfigurieren Sie ihn nach Bedarf. Nachdem Sie einen neuen HR-Connector erstellt haben, führen Sie das Skript mithilfe der Auftrags-ID des neuen Connectors und der CSV-Dateien mit den zuvor in diesem Artikel beschriebenen Mitarbeiterprofildaten aus.