Initialize-Places

Das Initialize-Places Cmdlet ist eine vereinfachte, schnell erstellbare Benutzeroberfläche, die anstelle der Cmdlets New-Placeverwendet Set-PlaceV3 werden kann.

Initialize-Places analysiert vorhandene Räume und Arbeitsbereiche in Ihrem Mandanten und leitet die Namen von Gebäuden, Etagen und Abschnitten ab. Sie können die abgeleiteten Informationen überprüfen und bearbeiten, bevor Sie eine Hierarchie von Gebäuden, Stockwerken, Abschnitten, Räumen und Arbeitsbereichen im Verzeichnis "Places" erstellen.

Diese Seite enthält Details zur Cmdlet-Syntax und den Optionen. Eine schrittweise Anleitung zur Verwendung dieses Cmdlets finden Sie unter Konfigurieren von Gebäuden und Stockwerken.

Wichtig

Verwenden Sie die neueste Version des Microsoft Places PowerShell-Moduls. Wenn das Modul nicht installiert ist oder wenn Initialize-Places die auf dieser Seite dokumentierten Optionen nicht anzeigt, führen Sie Folgendes aus:
Install-Module -Name MicrosoftPlaces -Force

Schließen Sie PowerShell, und öffnen Sie es erneut, bevor Sie eine Verbindung mit Microsoft Places herstellen.

Syntax

Beim Ausführen Initialize-Places wird eine Liste mit Optionen angezeigt:

Initialize-Places
Please choose the desired option before continuing:
 1. Export suggested mapping CSV of rooms to buildings/floors.
 2. Import mapping CSV to automatically create buildings/floors and room mappings.
 3. Export PowerShell script with commands to manually create buildings/floors and room mappings based on an imported CSV.

Achtung

Möglicherweise finden Sie zusätzliche Parameter im PowerShell-Cmdlet, aber diese werden derzeit nicht unterstützt. Es wird davon abgeraten, Parameter zu verwenden, die nicht auf dieser Seite dokumentiert sind.

Option 1

Diese Option analysiert die in Ihrem Mandanten konfigurierten Räume und Arbeitsbereiche und generiert eine CSV-Datei mit dem Namen ResourceAccountsMapped.csv. Diese CSV-Datei enthält weitere Daten wie Gebäude-, Etagen- und Abschnittsnamen, die aus den Daten der Räume, des Arbeitsplatzes und der Raumliste abgeleitet werden.

Die CSV-Datei enthält nur Räume und Arbeitsbereiche in Exchange Online, die einer Raumliste zugeordnet sind und noch keinem Stockwerk oder Abschnitt im Places-Verzeichnis zugeordnet sind.

Beispiel:

  • Places, die keiner RoomList zugeordnet sind, sind nicht in der CSV-Datei enthalten. Diese Räume sind in der Raumsuche nicht sichtbar und standardmäßig ausgeschlossen, um sicherzustellen, dass sie nicht in der Places-Suche angezeigt werden, es sei denn, Sie fügen sie später manuell hinzu.

  • Places, die zwei oder mehr RoomList zugeordnet sind, werden einbezogen. Der abgeleitete Gebäudename bleibt jedoch leer. Sie müssen den richtigen Gebäudenamen eingeben.

  • Places, die bereits einem Stockwerk oder einem Abschnitt übergeordnet sind, sind nicht in der CSV-Datei enthalten. Sie können das Skript iterativ ausführen, wenn neue Räume und Arbeitsbereiche in Exchange Online hinzugefügt werden, und die Ausgabe-CSV-Datei sollte nur die neuen Räume und Arbeitsbereiche enthalten.

Eine Anleitung zum Exportieren anderer Räume und Arbeitsbereiche finden Sie unter Konfigurieren von Gebäuden und Stockwerken, Manuelles Setup.

Option 2

Nachdem die von Option 1 generierten Raum- und Arbeitsbereichsinformationen validiert wurden, sollten Sie unnötige Spalten entfernen, wie unter Konfigurieren von Gebäuden und Etagen beschrieben, und als neue CSV-Datei speichern. Jetzt können Sie diese Informationen mit Option 2 wieder in Ihr Places-Verzeichnis schreiben.

Jedes neue Gebäude, jede Etage oder jeder neue Abschnitt, der in der CSV-Datei gefunden wird, wird Ihrem Places-Verzeichnis hinzugefügt, und neue Räume und Arbeitsplätze werden Etagen/Abschnitten übergeordnet.

Du kannst die Arbeit nach Gebäude, Stadt oder beliebigen anderen Kriterien aufschlüsseln. Auf diese Weise können Sie kleinere CSV-Dateien, die eine Teilmenge der Räume und Arbeitsplätze enthalten, die Sie Ihrem Places-Verzeichnis hinzufügen möchten, wiederholt hochladen. Jedes Mal, wenn Sie eine neue CSV-Datei hochladen, werden Gebäude, Stockwerke und Abschnitte, die sich noch nicht in Ihrem Places-Verzeichnis befinden, der Hierarchie hinzugefügt.

Nachdem Sie die CSV-Datei hochgeladen haben, wird eine Datei mit dem Namen fileToImport-ImportResults.csv generiert und im selben Ordner gespeichert. Diese Datei dokumentiert, ob während des Uploads Probleme aufgetreten sind. In dieser Phase wird eine vollständige Hierarchie räumlicher Daten verfügbar, die von Microsoft Places in Ihrem Mandanten verwendet werden können.

Das Hochladen einer CSV-Datei führt dazu, dass Gebäudenamen in der Microsoft 365-Oberfläche sichtbar werden. Praktisch bedeutet dies, dass Benutzer diese Gebäude sehen und auswählen können

Wichtig

Stellen Sie sicher, dass jedes Gebäude, jede Etage und alle Abschnitte in der CSV-Datei und in allen CSV-Dateien genau gleich geschrieben sind, wenn Sie sie iterativ hochladen. Differenzen führen dazu, dass zusätzliche Gebäude, Stockwerke oder Abschnitte entstehen.

Option 3

Mit dieser erweiterten Option können Sie das PowerShell-Skript, das Ihr Places Directory konfiguriert, vor dessen Ausführung überprüfen. Mit dieser Option wird das PowerShell-Skript auf Ihren Computer heruntergeladen, aber nicht ausgeführt. Option 3 kann nützlich sein, wenn Sie administrative Aufgaben auf mehrere Personen aufteilen müssen.

Das PowerShell-Skript heißt PlacesOnboardingScript.ps1 und wird im selben Ordner wie die hochgeladene CSV-Datei gespeichert. Sie müssen das PowerShell-Skript manuell ausführen, um Ihr Verzeichnis "Places" zu konfigurieren.

Hinweis

In der Cmdlet-Beschreibung wird fälschlicherweise der Begriff "Import" für Option 3 verwendet, aber mit dieser Option wird nichts in Ihrem Places-Verzeichnis erstellt. Es generiert nur das Skript, das Sie manuell ausführen müssen.

Dateiformate

Dateiformat der exportierten Datei (Option 1)

Spaltenname Beschreibung
InferredBuildingName Microsoft Places versucht, basierend auf der Gebäudeeigenschaft des Raums/Arbeitsbereichs und der zugehörigen Raumliste abzuleiten (vorzuschlagen), was es für den Gebäudenamen für diesen Raum/Arbeitsbereich hält. Diese Spalte sollte überprüft & vor dem Importieren mit dem richtigen Wert aktualisiert werden (Option 2 oder 3).
InferredFloorName Microsoft Places versucht, basierend auf der floorLabel-Eigenschaft des Raums/Arbeitsbereichs und der zugehörigen Raumliste abzuleiten (vorzuschlagen), was es für den Etagennamen für diesen Raum/Arbeitsbereich hält. Diese Spalte sollte überprüft & vor dem Importieren mit dem richtigen Wert aktualisiert werden (Option 2 oder 3).
InferredSectionName Microsoft Places schlägt den Etagennamen (InferredFloorName) als Abschnittsnamen für Arbeitsbereiche vor und lässt ihn für Räume leer. Diese Spalte sollte überprüft & vor dem Importieren mit dem richtigen Wert aktualisiert werden (Option 2 oder 3)
CurrentBuildingLabel Der aktuelle Zeichenfolgenwert des Gebäudesatzes auf Basis der Metadaten des Raums oder Arbeitsbereichs
CurrentFloorNumber Der aktuelle ganzzahlige Wert der Etage, die in den Metadaten des Raums oder Arbeitsbereichs festgelegt wurde
CurrentFloorLabel Der aktuelle Zeichenfolgenwert von floorLabel , das für die Metadaten des Raums oder Arbeitsbereichs festgelegt wurde
PrimarySmtpAddress Die SMTP-Adresse des Raums oder Arbeitsbereichs
Name Der Anzeigename des Raums/Arbeitsbereichs
RoomList Die zugeordnete Raumliste der Räume/Arbeitsbereiche
ResourceType Definiert, ob die Ressource ein Raum oder ein Raum (Arbeitsbereich) ist
StreetAddress Die Straße des Raums/Arbeitsbereichs
Stadt Die Stadt des Raums/Arbeitsbereichs
StateOrProvince Das Bundesland/die Provinz des Raums/Arbeitsbereichs
CountryOrRegion Das Land/die Region des Raums/Arbeitsbereichs
Konfidenz Das Konfidenzniveau für den abgeleiteten Gebäudenamen und den abgeleiteten Etagennamen

Für den Import erforderliches Dateiformat (Option 2 und 3)

Die importierte Datei darf nur die folgenden vier Spalten enthalten:

Spaltenname Beschreibung
InferredBuildingName (erforderlich) Dieser Name wird beim Erstellen des Gebäudes verwendet
InferredFloorName (erforderlich) Dieser Name wird beim Erstellen der Etage verwendet.
InferredSectionName Dieser Name wird beim Erstellen des Abschnitts verwendet (eine Zone oder Nachbarschaft auf der Etage). Dieser Name ist für Arbeitsbereiche erforderlich, aber für Räume optional.
PrimarySmtpAddress (erforderlich) Die SMTP-Adresse des Raums oder Arbeitsbereichs
  • Zuletzt aktualisiert um