Initialize-Places
L’applet Initialize-Places de commande est une expérience de création rapide simplifiée qui peut être utilisée à la New-Placeplace des applets de commande , et Set-PlaceV3 .
Initialize-Places analyse les salles et les espaces de travail existants dans votre locataire, et déduit les noms des bâtiments, des étages et des sections. Il vous permet de vérifier, de modifier ces informations, puis de générer une hiérarchie complète des salles et des espaces de travail des étages > des bâtiments > dans votre locataire. Cette hiérarchie est parfois appelée répertoire Places.
Cette page fournit des détails sur la syntaxe de l’applet de commande et les options. Un guide pas à pas pour utiliser cette applet de commande est fourni dans Configurer des bâtiments et des étages.
Importante
Des mises à jour importantes ont été apportées au module d’applet de commande MicrosoftPlaces le 14 novembre 2024. Si vous avez rejoint le programme Preview avant cette date, obtenez la dernière version du module en exécutant Run Install-Module -Name MicrosoftPlaces -Force, puis fermez et relancez PowerShell.
Syntaxe
L’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 pouvez trouver des paramètres supplémentaires dans l’applet de commande PowerShell, mais ils ne sont pas pris en charge actuellement. 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 locataire, 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 room, workplace et RoomList.
Le fichier CSV inclut uniquement les salles et les espaces de travail trouvés dans Exchange Online qui sont associés à une liste roomlist et qui ne sont pas encore parents d’un étage ou d’une section dans Places Directory.
Par exemple :
Places non associées à roomlist ne sont pas incluses 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 Places Finder, sauf si vous les ajoutez manuellement par la suite.
Places associées à au moins deux RoomList sont incluses. Toutefois, le nom du bâtiment déduit est laissé vide. Vous devez écrire dans le nom de bâtiment correct.
Places déjà parentés à un étage, ou une section n’est pas incluse dans le fichier CSV. Vous pouvez exécuter le script de manière itérative lorsque de nouvelles salles et espaces de travail sont ajoutés dans Exchange Online, et que le fichier CSV de sortie doit inclure uniquement les nouvelles salles et espaces de travail.
Pour obtenir des conseils sur l’exportation d’autres salles et espaces de travail, consultez Configurer des bâtiments et des étages, configuration manuelle.
Option 2
Une fois que les informations relatives à la salle et à l’espace de travail générées par l’option 1 sont validées, vous devez supprimer les colonnes inutiles telles qu’elles sont descriptibles dans Configurer les bâtiments et les étages et les enregistrer dans un nouveau fichier CSV. Vous êtes maintenant prêt à réécrire 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 de Places, et les nouvelles salles et espaces de travail sont parents d’étages/sections.
Vous pouvez décomposer le travail par bâtiment, ville ou tout autre critère. Cette approche vous permet de charger de manière itérative des fichiers CSV plus petits qui contiennent un sous-ensemble de salles et d’espaces de travail que vous souhaitez ajouter à votre répertoire Places. Chaque fois que vous chargez un nouveau fichier CSV, des bâtiments, des étages et des sections qui ne se trouvent pas encore dans votre répertoire Places sont ajoutés à la hiérarchie.
Après avoir chargé le fichier CSV, 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 pendant le chargement. À ce stade, une hiérarchie complète de données spatiales devient disponible pour être utilisée par Microsoft Places dans votre locataire.
Le chargement d’un fichier CSV entraîne la visibilité 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
d’autres expériences décrites dans Microsoft Places vue d’ensemble.
Importante
Assurez-vous que chaque bâtiment, étage et section est exactement orthographié de la même façon dans le fichier CSV et dans 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 de fichier du fichier exporté (option 1)
| Nom de colonne | Description |
|---|---|
| InferredBuildingName | Microsoft Places tente de déduire (suggérer) ce qu’il croit être le nom du bâtiment pour cette salle/espace de travail, en fonction de la propriété du bâtiment de la salle/des 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 croit être le nom d’étage de cette salle/espace de travail, en fonction de la propriété floorLabel de room/workspaces et de la liste de salle 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 de l’étage définie sur les métadonnées de la salle ou de l’espace de travail |
| CurrentFloorLabel | Valeur de chaîne actuelle de floorLabel définie sur les métadonnées de la salle ou de l’espace de travail |
| PrimarySmtpAddress | Adresse smtp de la salle ou de l’espace de travail |
| Nom | Nom complet de la salle/de l’espace de travail |
| RoomList | Liste de salles associée des 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/de l’espace de travail |
| Confidence | Niveau de confiance dans le nom du bâtiment déduit et le nom de l’étage déduit |
Format de fichier requis pour l’importation (option 2 et 3)
Le fichier importé doit avoir uniquement 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 de l’étage. |
| InferredSectionName | Ce nom est utilisé lors de la création de la section (une zone ou un quartier à l’étage). Ce nom est obligatoire pour les espaces de travail, mais est facultatif pour les salles. |
| PrimarySmtpAddress | (obligatoire) Adresse smtp de la salle ou de l’espace de travail |