Initialize-Places

L’applet Initialize-Places de commande est une expérience simplifiée et rapide qui peut être utilisée à la place des New-Placeapplets de commande et Set-PlaceV3 .

Initialize-Places analyse les salles et espaces de travail existants dans votre locataire et déduit les noms des bâtiments, des étages et des sections. Il vous permet d’examiner et de modifier les informations déduites avant de créer une hiérarchie de bâtiments, d’étages, de sections, de pièces et d’espaces de travail dans le répertoire Places.

Cette page fournit des détails sur la syntaxe et les options de l’applet de commande. Un guide pas à pas pour utiliser cette applet de commande est fourni dans Configurer des bâtiments et des étages.

Importante

Utilisez la dernière version du module PowerShell de Microsoft Places. Si le module n’est pas installé ou si Initialize-Places n’affiche pas les options documentées sur cette page, exécutez :
Install-Module -Name MicrosoftPlaces -Force

Ensuite, fermez et rouvrez PowerShell avant de vous connecter à Microsoft Places.

Syntaxe

En cours d’exécution Initialize-Places affiche une liste d’options :

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.

Attention

Vous trouverez peut-être d’autres paramètres dans l’applet de commande PowerShell, mais ceux-ci ne sont pas pris en charge pour le moment. Il n’est pas recommandé d’utiliser un paramètre qui n’est pas documenté sur cette page.

Option 1

Cette option analyse les salles et les espaces de travail configurés dans votre client, et génère un fichier CSV nommé ResourceAccountsMapped.csv. Ce fichier CSV contient d’autres données telles que les noms de bâtiment, d’étage et de section, qui sont déduites des données des salles, du lieu de travail et de la liste des pièces.

Le fichier CSV inclut uniquement les salles et espaces de travail trouvés dans Exchange Online qui sont associés à une liste de salles et qui ne sont pas encore associés à un étage ou une section dans le répertoire des Places.

Par exemple :

  • Les Places qui ne sont pas associés à une RoomList ne sont pas inclus dans le fichier CSV. Ces salles ne sont pas visibles dans la recherche de salles et sont exclues par défaut pour s’assurer qu’elles n’apparaissent pas dans la recherche de Places, sauf si vous les ajoutez manuellement ultérieurement.

  • Places associés à deux ou plusieurs RoomList sont inclus. Cependant, le nom du bâtiment déduit est laissé vide. Vous devez écrire le nom correct du bâtiment.

  • Places déjà parentes à un étage ou à une section ne sont pas inclus dans le CSV. Vous pouvez exécuter le script de façon itérative lorsque de nouvelles salles et de nouveaux espaces de travail sont ajoutés dans Exchange Online. Le fichier CSV de sortie ne doit inclure que les nouvelles salles et espaces de travail.

Pour obtenir des instructions sur l’exportation d’autres salles et espaces de travail, consultez Configurer des bâtiments et des étages, configuration manuelle.

Option 2

Une fois les informations de salle et d’espace de travail générées par l’option 1 validées, vous devez supprimer les colonnes inutiles comme indiqué dans Configurer les bâtiments et les étages et les enregistrer en tant que nouveau fichier CSV. Vous êtes maintenant prêt à réinscrire ces informations dans votre répertoire Places à l’aide de l’option 2.

Tout nouveau bâtiment, étage ou section trouvé dans le fichier CSV est ajouté à votre répertoire Places, et les nouvelles salles et les nouveaux lieux de travail sont associés aux étages/sections.

Vous pouvez décomposer le travail par bâtiment, ville ou tout autre critère. Cette approche vous permet de charger de façon itérative des fichiers CSV plus petits qui contiennent un sous-ensemble de salles et de lieux de travail que vous souhaitez ajouter à votre répertoire Places. Chaque fois que vous chargez un nouveau fichier CSV, les bâtiments, les étages et les sections qui ne figurent pas encore dans votre répertoire Places sont ajoutés à la hiérarchie.

Une fois le fichier CSV chargé, un fichier nommé fileToImport-ImportResults.csv est généré et enregistré dans le même dossier. Ce fichier indique si des problèmes ont été rencontrés lors du chargement. À ce stade, une hiérarchie complète de données spatiales devient disponible pour être utilisée par Microsoft Places dans votre client.

Le chargement d’un fichier CSV entraîne l’affichage des noms des bâtiments dans l’expérience Microsoft 365. En pratique, cela signifie que les utilisateurs peuvent voir et choisir ces bâtiments dans

  • Plans de travail (c’est-à-dire les heures de travail et l’emplacement Outlook)

  • Présence sur le lieu de travail

  • autres expériences, comme décrit dans la présentation de Microsoft Places.

Importante

Vérifiez que chaque bâtiment, étage et section sont orthographiés exactement de la même façon dans le fichier CSV, et entre les fichiers CSV si vous les chargez de manière itérative. Les différences entraînent la création de bâtiments, d’étages ou de sections supplémentaires.

Option 3

Cette option avancée vous permet de passer en revue le script PowerShell qui configure votre répertoire Places avant de l’exécuter. Avec cette option, le script PowerShell est téléchargé sur votre ordinateur, mais n’est pas exécuté. L’option 3 peut être utile si vous devez séparer les tâches administratives entre plusieurs personnes.

Le script PowerShell est appelé PlacesOnboardingScript.ps1 et est enregistré dans le même dossier que le fichier CSV chargé. Vous devez exécuter manuellement le script PowerShell pour configurer votre répertoire Places.

Remarque

La description de l’applet de commande utilise incorrectement le terme « importer » pour l’option 3, mais cette option ne crée rien dans votre répertoire Places. Il génère uniquement le script que vous devez exécuter manuellement.

Formats de fichiers

Format du fichier exporté (option 1)

Nom de colonne Description
InferredBuildingName Microsoft Places tente de déduire (suggérer) ce qu’il pense être le nom du bâtiment pour cette salle/espace de travail, en fonction de la propriété de bâtiment de la salle/espaces de travail et de la liste de salles associée. Cette colonne doit être examinée & mise à jour avec la valeur correcte avant l’importation (option 2 ou 3).
InferredFloorName Microsoft Places tente de déduire (suggérer) ce qu’il pense être le nom de l’étage de cette salle/espace de travail, en fonction de la propriété floorLabel de la salle/espaces de travail et de la liste de salles associée. Cette colonne doit être examinée & mise à jour avec la valeur correcte avant l’importation (option 2 ou 3).
InferredSectionName Microsoft Places suggère le nom de l’étage (InferredFloorName) comme nom de section pour les espaces de travail et le laisse vide pour les salles. Cette colonne doit être examinée & mise à jour avec la valeur correcte avant l’importation (Option 2 ou 3)
CurrentBuildingLabel Valeur de chaîne actuelle du bâtiment définie sur les métadonnées de la salle ou de l’espace de travail
CurrentFloorNumber Valeur entière actuelle du sol défini sur les métadonnées de la salle ou de l’espace de travail
CurrentFloorLabel La valeur de chaîne actuelle de floorLabel définie sur les métadonnées de la salle ou de l’espace de travail
PrimarySmtpAddress L’adresse SMTP de la salle ou de l’espace de travail
Nom Nom d’affichage de la salle/de l’espace de travail
RoomList Liste des salles associées aux salles/espaces de travail
ResourceType Définit si la ressource est une salle ou un espace (espace de travail)
StreetAddress Adresse postale de la salle/de l’espace de travail
Ville Ville de la salle/de l’espace de travail
StateOrProvince État/province de la salle/de l’espace de travail
CountryOrRegion Pays/région de la salle/espace de travail
Confidence Niveau de confiance dans le nom du bâtiment déduit et le nom d’étage déduit

Format de fichier requis pour l’importation (Option 2 et 3)

Le fichier importé ne doit comporter que les quatre colonnes suivantes :

Nom de colonne Description
InferredBuildingName (obligatoire) Ce nom est utilisé lors de la création du bâtiment
InferredFloorName (obligatoire) Ce nom est utilisé lors de la création du plancher.
InferredSectionName Ce nom est utilisé lors de la création de la section (une zone ou un voisinage sur le plancher). Ce nom est obligatoire pour les espaces de travail, mais il est facultatif pour les salles.
PrimarySmtpAddress (obligatoire) L’adresse SMTP de la salle ou de l’espace de travail