Initialize-Places

Das Initialize-Places Cmdlet ist eine vereinfachte, schnell erstellte Benutzeroberfläche, die anstelle der New-PlaceCmdlets , und Set-PlaceV3 verwendet werden kann.

Initialize-Places analysiert vorhandene Räume und Arbeitsbereiche in Ihrem Mandanten und leitet Gebäude-, Boden- und Abschnittsnamen ab. Sie können diese Informationen überprüfen, bearbeiten und dann eine vollständige Hierarchie von Gebäuden > Etagen > Räume und Arbeitsbereiche in Ihrem Mandanten erstellen. Diese Hierarchie wird manchmal als Places Directory bezeichnet.

Diese Seite enthält Details zur Cmdletsyntax und zu den Optionen. Eine schritt-für-Schritt-Anleitung zur Verwendung dieses Cmdlets finden Sie unter Konfigurieren von Gebäuden und Etagen.

Wichtig

Am 14. November 2024 wurden wichtige Updates am MicrosoftPlaces-Cmdlet-Modul vorgenommen. Wenn Sie vor diesem Datum dem Vorschauprogramm beigetreten sind, rufen Sie die neueste Version des Moduls ab, indem Sie ausführen Run Install-Module -Name MicrosoftPlaces -Force, und schließen Sie powerShell, und starten Sie es neu.

Syntax

Wird ausgeführt Initialize-Places , wird eine Liste der 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, die derzeit jedoch nicht unterstützt werden. Es wird nicht empfohlen, Parameter zu verwenden, die auf dieser Seite nicht dokumentiert sind.

Option 1

Diese Option analysiert Räume und Arbeitsbereiche, die in Ihrem Mandanten konfiguriert sind, und generiert eine CSV-Datei mit dem NamenResourceAccountsMapped.csv. Diese CSV-Datei enthält andere Daten wie Gebäude-, Boden- und Abschnittsnamen, die aus den Daten "rooms", "workplace" und "RoomList" abgeleitet werden.

Die CSV-Datei enthält nur Räume und Arbeitsbereiche in Exchange Online, die einer RoomList zugeordnet sind und noch nicht mit einer Etage oder einem Abschnitt in Places Directory übergeordnet sind.

Zum Beispiel:

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

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

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

Anleitungen zum Exportieren anderer Räume und Arbeitsbereiche finden Sie unter Konfigurieren von Gebäuden und Etagen, manuelle Einrichtung.

Option 2

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

Alle neuen Gebäude, Stockwerke oder Abschnitte in der CSV-Datei werden Ihrem Places Directory hinzugefügt, und neue Räume und Arbeitsplätze werden den Etagen/Abschnitten zugeordnet.

Sie können die Arbeit nach Gebäude, Stadt oder anderen Kriterien aufteilen. Mit diesem Ansatz können Sie kleinere CSV-Dateien iterativ hochladen, die eine Teilmenge von Räumen und Arbeitsplätzen enthalten, die Sie Ihrem Places Directory hinzufügen möchten. Jedes Mal, wenn Sie eine neue CSV-Datei hochladen, werden Gebäude, Stockwerke und Abschnitte, die sich noch nicht in Ihrem Places Directory 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 diesem Stadium steht eine vollständige Hierarchie räumlicher Daten zur Verfügung, die von Microsoft Places in Ihrem Mandanten verwendet werden kann.

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

• Arbeitspläne (d. h. Outlook-Arbeitszeiten und Standort)

• Präsenz am Arbeitsplatz

• andere Erfahrungen, wie in Microsoft Places Übersicht beschrieben.

Wichtig

Stellen Sie sicher, dass jedes Gebäude, jede Etage und alle Abschnitte in der CSV-Datei und in allen CSV-Dateien genau auf die gleiche Weise geschrieben sind, wenn Sie sie iterativ hochladen. Unterschiede führen dazu, dass zusätzliche Gebäude, Etagen oder Abschnitte erstellt werden.

Option 3

Mit dieser erweiterten Option können Sie das PowerShell-Skript überprüfen, mit dem Ihr Places Directory konfiguriert wird, bevor Sie es ausführen. 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 zwischen mehreren Personen trennen müssen.

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

Hinweis

In der Cmdlet-Beschreibung wird für Option 3 nicht ordnungsgemäß der Begriff "import" verwendet, aber diese Option erstellt nichts in Ihrem Places Directory. 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, den Gebäudenamen für diesen Raum/Arbeitsbereich basierend auf der Gebäudeeigenschaft des Raums/Arbeitsbereichs und der zugehörigen Raumliste abzuleiten (vorzuschlagen). Diese Spalte sollte vor dem Importieren überprüft & mit dem richtigen Wert aktualisiert werden (Option 2 oder 3).
InferredFloorName	Microsoft Places versucht, abzuleiten (vorzuschlagen), was seiner Meinung nach der Bodenname für diesen Raum/Arbeitsbereich ist, basierend auf der floorLabel-Eigenschaft des Raums/Arbeitsbereichs und der zugehörigen Raumliste. Diese Spalte sollte vor dem Importieren überprüft & mit dem richtigen Wert aktualisiert werden (Option 2 oder 3).
InferredSectionName	Microsoft Places schlägt den Bodennamen (InferredFloorName) als Abschnittsnamen für Arbeitsbereiche vor und lässt ihn für Räume leer. Diese Spalte sollte vor dem Importieren überprüft & mit dem richtigen Wert aktualisiert werden (Option 2 oder 3)
CurrentBuildingLabel	Der aktuelle Zeichenfolgenwert der Erstellung , die für die Metadaten des Raums oder Arbeitsbereichs festgelegt wurde
CurrentFloorNumber	Der aktuelle ganzzahlige Wert des Bodens , der für die Metadaten des Raums oder Arbeitsbereichs festgelegt ist
CurrentFloorLabel	Der aktuelle Zeichenfolgenwert von floorLabel , der für die Metadaten des Raums oder Arbeitsbereichs festgelegt ist
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 es sich bei der Ressource um einen Raum oder einen Raum (Arbeitsbereich) handelt.
StreetAddress	Die Adresse des Raumes/Arbeitsbereichs
Stadt	Die Stadt des Raumes/Arbeitsbereichs
StateOrProvince	Bundesland/Provinz des Raums/Arbeitsbereichs
CountryOrRegion	Land/Region des Raums/Arbeitsbereichs
Konfidenz	Die Zuverlässigkeitsstufe im abgeleiteten Gebäudenamen und abgeleiteten Stockwerksnamen

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 des Bodens verwendet.
InferredSectionName	Dieser Name wird beim Erstellen des Abschnitts verwendet (eine Zone oder Nachbarschaft auf dem Boden). Dieser Name ist für Arbeitsbereiche erforderlich, für Räume jedoch optional.
PrimarySmtpAddress	(erforderlich) Die SMTP-Adresse des Raums oder Arbeitsbereichs