Raumanalyse

Raumreservierungen bieten in Kombination mit Belegungssensordaten wichtige Erkenntnisse für Immobilien- und Facility-Manager, um die Raumnutzung besser zu verstehen, zu analysieren und zu optimieren. Durch die Analyse von Reservierungsdaten, die die beabsichtigte Raumnutzung zusammen mit Sensordaten zur tatsächlichen Belegung widerspiegeln, können Manager Belegungs- und Buchungsverhalten verstehen und hohe No-Show-Raten identifizieren. Diese Daten helfen Managern, bessere Entscheidungen über die Raumverfügbarkeit zu treffen.

Raumnutzung basierend auf der Verwendungsabsicht

Die Raumanalyse verwendet Raumreservierungsdaten, um die beabsichtigte Nutzung von Räumen nachzuverfolgen und einblicke in die geplante Raumbelegung zu erhalten.

Die Reservierungsdaten werden aus allen Raumpostfächern in Exchange gesammelt, die einem Mandanten zugeordnet sind, über einen Dienst, der täglich ausgeführt wird.

Raumnutzung basierend auf der tatsächlichen Belegung

Die Raumanalyse verwendet Belegungssignale, um die tatsächliche Anwesenheit von Personen zu erkennen und so die tatsächliche Raumnutzung zu messen.

Derzeit unterstützt Microsoft die folgenden Belegungssignale:

• CRS (Anrufaufzeichnungszusammenfassungen aus Teams-Besprechungen)
• Andere Belegungs- oder Personenzählungssensoren

Onboarding von CRS-Daten

Das zusammengefasste Anrufaufzeichnungssignal enthält die Start- und Endzeit der Teams-Besprechung, die verwendet werden kann, um die Raumbelegung abzuleiten. CRS-Daten werden vom SIP-Team (Substrate Intelligence Platform) im SIGS-Dataset veröffentlicht.

Das CallRecordSummarized-Signal ist 4 Tage nach der Ereigniszeit im SIGS-Dataset verfügbar. Und es bleibt 28 Tage verfügbar.

Prozess zum Aktivieren von CRS

CRS wird derzeit in diesen Hauptregionen unterstützt: NAM, EUR, JPN und APAC. Wenn sich Ihre organization in einer dieser unterstützten Regionen befindet, ist der CRS-Daten-Onboardingprozess vollständig automatisiert.

Für die Datenintegration ist keine manuelle Aktion erforderlich. Sobald das System erkennt, dass Sie sich in einer unterstützten Region befinden, wird der Datenfluss automatisch gestartet.

Datasetschema

Verbinden von Belegungssensordaten

Die Verbindung von Belegungs- und Personenzählungssensoren erfolgt in vier Schritten.

1. Geräte-Onboarding.
2. Hochladen von Telemetriedaten.
3. Erfassung von Echtzeittelemetriedaten.
4. Vergewissern Sie sich, dass Daten in Places verfügbar sind.

Geräte-Onboarding

Der erste Schritt umfasst das Hochladen einer CSV-Datei mit den Gerätemetadaten, einschließlich der Zuordnung von Geräten zu einer PlaceId in Microsoft Places. Dieser Schritt hilft bei der Kontextualisierung der Telemetriedaten, wenn sie Places erreichen.

Das folgende Diagramm zeigt, wie Sie Geräte und Sensoren in Places integrieren können.

Zunächst müssen die Gerätedaten vorbereitet werden.

1. Laden Sie Ortsinformationen von Microsoft Places herunter. Installieren Sie zunächst PowerShell 7 , indem Sie das folgende PowerShell-Cmdlet ausführen. Weitere Informationen zu PowerShell unter Windows finden Sie unter Installieren von PowerShell unter Windows.

   Install-Module -Name ExchangeOnlineManagement  
   
   Import-Module -Name ExchangeOnlineManagement  
   
   Connect-ExchangeOnline
   

2. Öffnen Sie PowerShell als Administrator, und führen Sie den folgenden ExchangeOnline PowerShell-Befehl aus, um zu überprüfen, ob Ihr Konto über die erforderliche Rolle TenantPlacesManagement verfügt, und um sicherzustellen, dass Ihr Benutzername aufgeführt ist.

   Get-ManagementRoleAssignment -Role TenantPlacesManagement -GetEffectiveUsers
   

3. Wenn Sie über die richtigen Berechtigungen verfügen, sollten der folgende Name und die zugewiesene Rolle angezeigt werden.

   • Name: PlacesAdmin
   • Zugewiesene Rolle: TenantPlacesManagement

4. Um die PlaceId von Gebäuden abzurufen, öffnen Sie ein neues PowerShell-Fenster, und führen Sie das folgende Windows PowerShell-Cmdlet aus.

   Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force  
   
   Connect-MicrosoftPlaces
   

5. Führen Sie die folgenden Befehle aus, um die Liste der Etagen und Räume herunterzuladen.

   $buildingName = “” 
   $allPlaces = Get-PlaceV3 | Select-Object PlaceId, DisplayName, Type, ParentId 
   $building = $allPlaces | Where-Object { $_.DisplayName -eq $buildingName -and $_.Type -eq "Building" } 
   $floors = $allPlaces | Where-Object { $_.ParentId -eq $building.PlaceId } 
   $spacesAndRooms = $floors | ForEach-Object { 
   $floor = $_; 
   $allPlaces | Where-Object { $_.ParentId -eq $floor.PlaceId }   
   } 
   $places = @() 
   $floors | ForEach-Object { $places += $_ } 
   $spacesAndRooms | ForEach-Object { $places += $_ } 
   $outputPath = 'C:\places.csv' 
   $places | Select-Object PlaceId, DisplayName, Type | Export-Csv -Path $outputPath -NoTypeInformation
   

6. Die Ausgabedatei im CSV-Dateipfad sollte die folgenden Informationen enthalten:

   PlaceId	DisplayName	Typ
   5d275bba-5d7d-487f-855e-75cd2943204f	Etage 1	Untergrenze
   0fa1b1eb-6066-45ea-8f7c-09b4e8cc4e74	Conf Room 1202/3455 (9)	Raum

7. Laden Sie die Gerätemetadaten aus einer Partnerlösung oder von Ihrem System herunter, einschließlich aller Geräte.

8. Verwenden Sie ein Skript, oder ordnen Sie Ihre Geräte mit dem folgenden Datenformat für PlacesDevice manuell PlaceId zu.

Allgemeine Richtlinien für Geräte und Sensoren

• Es wird empfohlen, die DeviceId als Manufacturer_DeviceUniqueId anzugeben. In Fällen, in denen Ihre Partner keine Telemetriedaten auf Geräteebene senden können (z. B. kombinieren sie Telemetriedaten von mehreren Geräten), kann eine virtuelle DeviceId als Manufacturer_Building_VirtualDeviceId erstellt werden. In diesem Fall kann VirtualDeviceId ein natürlicher Schlüssel eines Raums sein. Wenn Ihr Kunde die VirtualDeviceId bereitstellt, sollten Sie Informationen zu den physischen Geräten angeben, von denen die Telemetriedaten berechnet werden. Informationen zu physischen Geräten können sich in Tags befinden.

• Wenn Sensor.SensorType für ein Gerät eindeutig ist, müssen Sie nur SensorType angeben. In Fällen, in denen mehrere Datenströme für einen bestimmten Sensortyp für ein Gerät vorhanden sind, ist eine eindeutige SensorId erforderlich. SensorType und SensorId sind in den meisten Fällen PeopleCount, Occupancy usw., es sei denn, SensorType ist für ein Gerät eindeutig. In diesem Fall ist SensorId SensorType_SomeUnique Bezeichner.

Nachdem die Gerätemetadaten vorbereitet wurden, können Geräteinformationen auf folgende Weise in Microsoft Places hochgeladen werden.

• Verwenden von PowerShell-Cmdlets
• Verwenden von Microsoft Graph-APIs

Verwenden von PowerShell-Cmdlets

Zum individuellen Verwalten von Geräten können die Microsoft Places PowerShell-Cmdlets direkt verwendet werden. Weitere Informationen zu Places Cmdlets finden Sie im Modul Microsoft Places Cmdlets für PowerShell.

1. Öffnen Sie PowerShell 7 (nicht als Administrator).

2. Installieren Sie Microsoft Places, indem Sie das folgende Windows PowerShell-Cmdlet ausführen. Weitere Informationen zur installation Microsoft Places finden Sie im Microsoft Places PowerShell-Katalog.

   Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
   

3. Importieren Sie das Microsoft Places-Modul, indem Sie das folgende Windows PowerShell-Cmdlet ausführen.

   Import-Module -Name MicrosoftPlaces 
   

4. Stellen Sie nach dem Installieren und Importieren des Moduls eine Verbindung mit dem Microsoft Places Modul her, indem Sie das folgende Places PowerShell-Cmdlet ausführen.

   Connect-MicrosoftPlaces
   

5. Verwenden Sie New-PlaceDevice unten gezeigten Cmdlet-Beispiel, um ein Gerät hinzuzufügen. Der Sensors-Parameter ist ein Objekt vom Typ MicrosoftPlaces.PlacesDevices.Sensor mit den oben genannten Feldern.

   New-PlaceDevice -DeviceId "contoso_9D6816" -DisplayName "Contoso 9D6816 Device" -Description "Contoso 9D6816 Device" -MACAddress "00:0A:95:9D:68:16" -Manufacturer "Contoso" -IPV4Address "192.168.1.100" -IPV6Address "2001:db8::ff00:42:8329" -PlaceId "acfa3bc0- 2b83-425b-8910-84a0250e9671" -Tags "BuildingA" -Sensors (New-Object MicrosoftPlaces.PlacesDevices.Sensor -Property @{SensorType="occupancy"})
   

6. Verwenden Sie Get-PlaceDevice, um eine Liste der Geräte anzuzeigen. Standardmäßig werden 10 Geräte zurückgegeben. Um weitere Geräte zurückzugeben, fügen Sie den Parameter -top wie unten gezeigt hinzu.

   Get-PlaceDevice -top 100
   

7. Verwenden Sie Set-PlaceDevice, um ein Gerät mit der vorhandenen ID zu aktualisieren.

   Set-PlaceDevice -Id "e5a216ff-1d32-4647-8dab-a2523ee5796e" -DeviceId "contoso_7D6816" -DisplayName "Contoso 7D6816 Device" -Description "Contoso 9D6816 Device" -MACAddress "00:0A:95:9D:68:16" -Manufacturer "Contoso" -IPV4Address "192.168.1.100" -IPV6Address "2001:db8::ff00:42:8329" -PlaceId "acfa3bc0- 2b83-425b-8910-84a0250e9671" -Tags "BuildingA" -Sensors (New-Object MicrosoftPlaces.PlacesDevices.Sensor -Property @{SensorType="peopleCount"}) 
   

8. Verwenden Sie Remove-PlaceDevice, um ein Gerät zu löschen.

   Remove-PlaceDevice -Id "e5a216ff-1d32-4647-8dab-a2523ee5796e" 
   

Verwenden von Microsoft Graph-APIs

Um den Prozess zu ändern oder vorhandene Systeme zu automatisieren und in vorhandene Systeme zu integrieren, können Microsoft Graph-APIs verwendet werden.

Führen Sie die folgenden Schritte aus, um APIs zu verwenden.

1. Erstellen Sie eine App-Registrierung in Microsoft Entra.im. Weitere Informationen zu den Berechtigungen PlaceDeviceRead.All und PlaceDevice.ReadWrite.All finden Sie in der Microsoft Graph-Berechtigungsreferenz.

2. Erstellen und bereitstellen Sie eine Anwendung, um Geräteinformationen über Microsoft Places und Ihre Partner hinweg zu synchronisieren.

Weitere Informationen zu Sensorgeräten finden Sie in den folgenden Microsoft Graph-APIs und der Gerätedokumentation:

• Auflisten von sensorGeräte
• Erstellen von workplaceSensorDevice
• workplaceSensorDevice abrufen
• aktualisieren workplaceSensorDevice
• workplaceSensorDevice löschen
• Weitere Informationen zum Anzeigen von Geräten finden Sie unter Auflisten von sensorGeräte.
• Weitere Informationen zum Erstellen eines neuen Geräts finden Sie unter Erstellen von workplaceSensorDevice.

Beispielgerät:

POST https://graph.microsoft.com/beta/workplace/sensorDevices

{ 
            "deviceId": "contoso_9D6821_occ_new", 
            "displayName": "Contoso 9D6816 Device", 
            "description": "Contoso 9D6816 Device", 
            "macAddress": "00:0A:95:9D:68:16", 
            "manufacturer": "Contoso", 
            "ipV4Address": "192.168.1.100", 
            "ipV6Address": "2001:db8::ff00:42:8329", 
            "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", 
            "tags": [ 
                "BuildingA", 
                "Floor 3", 
                "Room 300", 
                "Conference Room" 
            ], 
            "sensors": [ 
                { 
                    "sensorId": "Occupancy", 
                    "displayName": null, 
                    "sensorType": "occupancy", 
                    "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" 
                } 
            ] 
        } 

• Informationen zum Anzeigen eines bestimmten Geräts finden Sie unter Abrufen von workplaceSensorDevice.

Beispiel:

GET
https://graph.microsoft.com/beta/workplace/sensorDevices/<workplacesensordevice-id> 

GET 
https://graph.microsoft.com/beta/workplace/sensorDevices/8e404458-e9b1-4153-b6b5-4858ccee1486 

Beispielantwort:

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices/$entity", 
    "@microsoft.graph.tips": "Use $select to choose only the properties your app needs, as this can lead to performance improvements. For example: GET workplace/sensorDevices('<guid>')?$select=description,deviceId", 
    "id": "8e404458-e9b1-4153-b6b5-4858ccee1486", 
    "deviceId": "contoso_9D6821_occ_new", 
    "displayName": "Contoso 9D6816 Device", 
    "description": "Contoso 9D6816 Device", 
    "macAddress": "00:0A:95:9D:68:16", 
    "manufacturer": "Contoso", 
    "ipV4Address": "192.168.1.100", 
    "ipV6Address": "2001:db8::ff00:42:8329", 
    "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", 
    "tags": [ 
        "BuildingA", 
        "Floor 3", 
        "Room 300", 
        "Conference Room" 
    ], 
    "sensors": [ 
        { 
            "sensorId": "Occupancy", 
            "displayName": null, 
            "sensorType": "occupancy", 
            "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" 
        } 
    ] 
}

• Weitere Informationen zum Aktualisieren eines vorhandenen Geräts finden Sie unter Aktualisieren von workplaceSensorDevice.

Beispiel:

PATCH https://graph.microsoft.com/beta/workplace/sensorDevices/8e404458-e9b1-4153-b6b5-4858ccee1486 

{ 
            "deviceId": "contoso_9D6821_occ_new", 
            "displayName": "Contoso 9D6816 Device New", 
            "description": "Contoso 9D6816 Device", 
            "macAddress": "00:0A:95:9D:68:16", 
            "manufacturer": "Contoso", 
            "ipV4Address": "192.168.1.100", 
            "ipV6Address": "2001:db8::ff00:42:8329", 
            "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", 
            "tags": [ 
                "BuildingA", 
                "Floor 3", 
                "Room 300", 
                "Conference Room" 
            ], 
            "sensors": [ 
                { 
                    "sensorId": "Occupancy", 
                    "displayName": null, 
                    "sensorType": "occupancy", 
                    "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" 
                } 
            ] 
        } 

Beispielantwort:

{ 
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#workplace/sensorDevices/$entity", 
    "id": "8e404458-e9b1-4153-b6b5-4858ccee1486", 
    "deviceId": "contoso_9D6821_occ_new", 
    "displayName": "Contoso 9D6816 Device New", 
    "description": "Contoso 9D6816 Device", 
    "macAddress": "00:0A:95:9D:68:16", 
    "manufacturer": "Contoso", 
    "ipV4Address": "192.168.1.100", 
    "ipV6Address": "2001:db8::ff00:42:8329", 
    "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671", 
    "tags": [ 
        "BuildingA", 
        "Floor 3", 
        "Room 300", 
        "Conference Room" 
    ], 
    "sensors": [ 
        { 
            "sensorId": "Occupancy", 
            "displayName": null, 
            "sensorType": "occupancy", 
            "placeId": "acfa3bc0-2b83-425b-8910-84a0250e9671" 
        } 
    ] 
}

• Weitere Informationen zum Löschen eines Geräts finden Sie unter Löschen von workplaceSensorDevice.

Beispiel:

DELETE https://graph.microsoft.com/beta/workplace/sensorDevices/<workplaceSensorDevice-Id>

DELETE https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b

Hochladen von Telemetriedaten

Nachdem Sie Ihre Geräte in Microsoft Places integriert haben, können Sie einen einmaligen Nachfüllvorgang mit Verlaufsdaten durchführen, um Places mit Verlaufstelemetriedaten aufzufüllen. Anschließend können Sie Places so konfigurieren, dass fortlaufende Telemetriedaten von Ihren Geräten empfangen werden, um auf dem neuesten Stand zu bleiben. Das folgende Diagramm zeigt den Uploadflow für Die Ausfülldatei (obere Hälfte) und den fortlaufenden Gerätetelemetrieflow (untere Hälfte).

Option 1: Verwenden des Cmdlets Push-Dataset

Microsoft Places akzeptiert Verlaufsdaten in einem bestimmten CSV-Dateiformat und -Schema. Sie müssen diese Daten aus einem vorhandenen System exportieren und dann das folgende PowerShell-Cmdlet verwenden, um die Daten hochzuladen.

1. Öffnen Sie PowerShell 7 (nicht als Administrator).

2. Installieren Sie Microsoft Places, indem Sie das folgende Windows PowerShell-Cmdlet ausführen. Weitere Informationen zur installation Microsoft Places finden Sie im Microsoft Places PowerShell-Katalog.

   Install-Module –Name MicrosoftPlaces –AllowPrerelease –Force
   

3. Importieren Sie das Microsoft Places-Modul, indem Sie das folgende Windows PowerShell-Cmdlet ausführen.

   Import-Module -Name MicrosoftPlaces 
   

4. Stellen Sie eine Verbindung mit dem Microsoft Places-Modul her, indem Sie das folgende Places PowerShell-Cmdlet ausführen.

   Connect-MicrosoftPlaces 
   

5. Laden Sie das Dataset aus dem Speicherort auf Ihrem Gerät hoch (unter Verwendung des Ordners und Pfads), indem Sie das folgende Places PowerShell-Cmdlet ausführen.

   Push-Dataset -Type RoomOccupancy -Path <folder path> 
   

Das CSV-Dateiformat für PeopleCount

CSV-Beispiel:

19966d8e-4434-477a-a38a-2df5651cd90f,6afe1ea7-82aa-451c-b2e1-48e48ca39ec0,5, 2023-06-27T18:24:20.808Z,building1 

19966d8e-4434-477a-a38a-2df5651cd90f,6afe1ea7-82aa-451c-b2e1-48e48ca39ec0,5, 2023-06-27T18:24:20.808Z,building1 

457702f3-c58d-44fa-9d26-f153fcd27452,a7387ed0-b540-47b0-8170-bc9c80f6c5b9,5, 2023-06-27T18:24:20.808Z,building1 

457702f3-c58d-44fa-9d26-f153fcd27452,a7387ed0-b540-47b0-8170-bc9c80f6c5b9,5, 2023-06-27T18:24:20.808Z,building1 

Das CSV-Dateiformat für die Belegung

CSV-Beispiel:

19966d8e-4434-477a-a38a-2df5651cd90f,6afe1ea7-82aa-451c-b2e1-48e48ca39ec0,true, 2023-06-27T18:24:20.808Z,building1 

19966d8e-4434-477a-a38a-2df5651cd90f,6afe1ea7-82aa-451c-b2e1-48e48ca39ec0,true, 2023-06-27T18:30:20.808Z,building1 

457702f3-c58d-44fa-9d26-f153fcd27452,a7387ed0-b540-47b0-8170-bc9c80f6c5b9,false, 2023-06-27T18:40:20.808Z,building1 

457702f3-c58d-44fa-9d26-f153fcd27452,a7387ed0-b540-47b0-8170-bc9c80f6c5b9,true, 2023-06-27T18:45:20.808Z,building1 

Option 2: Automatisieren mit dem Microsoft Graph-API

ApIs stehen über Microsoft Graph zur Verfügung, um eine Anwendung zum Automatisieren des Uploads von Telemetriedaten zu erstellen und eine Anwendung zum Automatisieren der Registrierung und des Onboardings von Geräten zu erstellen. Führen Sie die folgenden Schritte aus, um APIs zu verwenden.

1. Erstellen Sie eine App-Registrierung in Microsoft Entra. Weitere Informationen zu den Berechtigungen PlaceDeviceRead.All und PlaceDevice.ReadWrite.All finden Sie in der Microsoft Graph-Berechtigungsreferenz.

2. Erstellen Sie eine Anwendung, und stellen Sie sie bereit, um Telemetriedaten über Microsoft Places und Ihre Partner hinweg zu synchronisieren.

3. Verwenden Sie die IngestTelemetry-API, um Belegungs- und Personenzählungsdaten per Push an Microsoft Places.

Weitere Informationen zur Erfassung von Sensortelemetriedaten für einen Arbeitsplatzsensor und weitere Informationen zur IngestTelemetry-API finden Sie unter workplaceSensorDevice: ingestTelemetry.

So pushen Sie Belegungs- und Personenzählungsdaten mithilfe des Microsoft-Graph-API an Microsoft Places

1. Laden Sie Daten aus vorhandenen Systemen herunter, wie weiter oben beschrieben.
2. Bereiten Sie Telemetriedaten basierend auf dem folgenden Signaldatenformat für Auslastungsdaten vor.

Belegungsdatensignal-Datenformat

Personen Daten zählen Signal-Daten-Format

• Führen Sie die API aus, um die Daten per Push an Microsoft Places.

Der folgende Befehl ist eine API-Beispielanforderung für die Auslastung.

{     
"telemetry": [     
        {    
            "deviceId": "19966d8e-4434-477a-a38a-2df5651cd90f", 
            "sensorid":"6afe1ea7-82aa-451c-b2e1-48e48ca39ec0",   
            "sensorType": "occupancy",    
            "boolValue": false,    
            "timestamp": "2021-03-31T09:36:05.144Z",  
            "locationHint":"building1"    
        }    
    ]     
} 

Der folgende Befehl ist eine API-Beispielanforderung für die Personenanzahl:

{     
"telemetry": [     
        {    
            "deviceId": "457702f3-c58d-44fa-9d26-f153fcd27452", 
            "sensorid":"a7387ed0-b540-47b0-8170-bc9c80f6c5b9",   
            "sensorType": "peopleCount",   
            "intValue": 5,    
            "timestamp": "2023-06-27T18:24:20.808Z",  
            "locationHint":"building1"    
        }    
    ]     
}

Erfassung von Echtzeittelemetriedaten

Die unter Bereich beschriebenen Connectors benötigen die folgende Berechtigung, um den Echtzeittelemetrieerfassungsdienst anzufordern.

• PlaceDeviceTelemetry.ReadWrite.All

Sie müssen die Administratoreinwilligung abschließen oder eine Microsoft Entra Anwendung mit der Berechtigung basierend auf der ausgewählten Architektur erstellen. Weitere Informationen zur Berechtigung "PlaceDeviceTelemetry.ReadWrite.All" finden Sie in der Microsoft Graph-Berechtigungsreferenz.

Das folgende Diagramm zeigt die Architektur für die Telemetrieerfassung.

Admin Zustimmung: Typ A Architektur, Hardwarepartner-eigener Connector (SaaS)

Für Kunden, die diese Integrationstypen auswählen, müssen Sie die mandantenweite Administratoreinwilligung abschließen, um den Partnerdiensten die Berechtigungen zum Erfassen von Telemetriedaten in ihrem Namen zu erteilen.

1. Dies gilt, wenn Hardwareanbieter mehrinstanzenfähige SaaS-Connectors (einzelinstanzenfähige oder mehrinstanzenfähige Apps) erstellt haben. Weitere Informationen zu mehrinstanzenfähigen Connectors finden Sie unter Mandantenfähigkeit in Microsoft Entra ID.

2. Rufen Sie die App-ID (GUID) vom Partner ab, der Telemetriedaten im Auftrag Ihres Diensts erfasst.

3. Erstellen Sie einen Dienstprinzipal mit der App-ID. Es stehen mehrere Optionen zur Auswahl. Weitere Informationen finden Sie unter Erstellen einer Unternehmensanwendung aus einer mehrinstanzenfähigen Anwendung in Microsoft Entra ID.

Wenn Sie Microsoft Graph PowerShell, Graph oder die Azure CLI verwenden, ersetzen Sie die ID oder App-ID (der genannten Befehle) auf den Seiten, um einen Dienstprinzipal zu erstellen, und erteilen Sie dann die Administratoreinwilligung im Dienstprinzipal in Azure.

Wenn Sie eine URL für die Administratoreinwilligung verwenden, ersetzen Sie die App-ID auf der Seite durch die Partner-App-ID, und öffnen Sie sie dann in einem Browser. Es erstellt einen Dienstprinzipal und fordert Sie auf, die Administratoreinwilligung zu erteilen. Um die Administratoreinwilligung zu erteilen, wählen Sie Akzeptieren aus.

Admin Zustimmung: Architektur vom Typ B und C, Connector, der in einer Kundenumgebung vor Ort ausgeführt wird

Microsoft Places stellt eine API zur Verfügung, die Telemetriedaten in einem Standardformat akzeptiert, das über Microsoft Graph verfügbar gemacht wird. Die API akzeptiert einen Batch von Telemetrienachrichten.

• Bei der Typ-B-Architektur verlassen sich Kunden auf eine Integration, die von ihren Hardwarepartnern bereitgestellt wird, die vor Ort in der Umgebung des Kunden gehostet werden.

• Bei der Architektur vom Typ C können Kunden mithilfe von Azure-Funktionen einen Prozess mit langer Ausführungsdauer oder einen ereignisbasierten Prozess erstellen, um Microsoft Places APIs zum Senden von Gebäudetelemetriedaten aufzurufen.

• Sowohl für Integrationsarchitekturen vom Typ B als auch für C müssen Kunden eine App-Registrierung in Microsoft Entra erstellen, wie in der folgenden Abbildung dargestellt, und die Administratoreinwilligung mit PlaceDeviceTelemetry.ReadWrite.All erteilen. Weitere Informationen zu Berechtigungen, die von Microsoft Graph verfügbar gemacht werden, finden Sie in der Microsoft Graph-Berechtigungsreferenz.

Überprüfen, ob Daten in Microsoft Places verfügbar sind

Sobald Ihre Geräte integriert sind und die API Livesensordaten erfasst, beginnen die Microsoft Places Analyseberichte aufzufüllen. Um Erkenntnisse zu gewinnen, die zur Optimierung Ihres Arbeitsbereichs beitragen, überprüfen Sie, ob die Daten innerhalb von 72 Stunden in Ihre Analyse-Dashboard fließen.