Set-PlaceV3

Utilisez l’applet de commande Set-PlaceV3 pour mettre à jour les métadonnées relatives à vos bureaux, salles, espaces de travail, sections, étages ou bâtiments dans votre répertoire Places.

Syntaxe

Création de rapports

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-Label]
 [-IsWheelChairAccessible]
 [-GeoCoordinates]
 [-Phone]
 [-Street]
 [-City]
 [-State]
 [-PostalCode]
 [-CountryOrRegion]
 [-ResourceLinks]

Floor

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-SortOrder]

Section

Une section est un regroupement d’espaces au sein d’un étage, par exemple un quartier. Les bureaux et les espaces de travail doivent être parents d’une section. Les chambres peuvent également être parentées d’une section ou être directement parentées à un étage.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]

Bureau

Les bureaux sont un type d’entité nouvellement introduit dans Microsoft Places, représentant des unités de bureau individuelles. Chaque bureau inclut une propriété Mode qui spécifie comment le bureau peut être réservé. Pour plus d’informations, reportez-vous à la section mode ci-dessous.

Pour Desk, il existe certaines dépendances entre le mode et la boîte aux lettres, comme suit :

• Si la propriété Mode n’est pas définie, la valeur par défaut du bureau est Indisponible et aucune boîte aux lettres de bureau n’est créée automatiquement.
• Pour les bureaux définis en mode Réservé ou DropIn, une boîte aux lettres de bureau est requise. Un est créé automatiquement lorsque le bureau est approvisionné. Vous pouvez également lier une boîte aux lettres existante en spécifiant emailAddress dans le paramètre Mailbox.
• Pour les bureaux en mode Affecté ou Non disponible, la liaison d’une boîte aux lettres est facultative et aucune boîte aux lettres n’est créée par défaut. Toutefois, vous pouvez associer manuellement ces bureaux à des boîtes aux lettres personnalisées si nécessaire.
• Si aucun mode n’est initialement configuré, le bureau reste en mode Non disponible. La liaison d’une boîte aux lettres par la suite ne met pas automatiquement à jour le mode du bureau.

Contrairement aux types Salle ou Espace de travail, les bureaux ne sont pas automatiquement approvisionnés en créant simplement une boîte aux lettres. En outre, les métadonnées telles que Capacity ou DisplayName ne sont pas synchronisées avec les propriétés de boîte aux lettres. La boîte aux lettres est principalement utilisée par le moteur de réservation, tandis que les métadonnées sont lues à partir du répertoire Places.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-IsWheelChairAccessible]
 [-DisplayDeviceName]
 [-Tags]
 [-Mailbox]
 [-Mode]

Room

Set-PlaceV3 prend en charge les paramètres d’emplacement hérités qui sont déjà disponibles dans l’applet de commande Exchange Set-Place. Toutefois, une fois qu’une pièce est liée à un étage ou à un bâtiment à l’aide du -ParentId paramètre , les détails de l’emplacement (Street et City) doivent être gérés au niveau du bâtiment, et non sur la pièce ou l’espace de travail individuel.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]

Espace de travail

Set-PlaceV3 prend en charge les paramètres d’emplacement hérités qui sont déjà disponibles dans l’applet de commande Exchange Set-Place. Toutefois, une fois qu’un espace de travail est lié à une section à l’aide du -ParentId paramètre , les détails de l’emplacement (Street et City) doivent être gérés au niveau du bâtiment, et non sur la salle ou l’espace de travail individuel.

L’espace de travail prend en charge la propriété Mode. Les détails de la même opération sont documentés dans la Mode section paramètre.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]
 [-Mode]

Description

Places dépend d’une hiérarchie entièrement configurée entre vos salles/espaces de travail, étages et bâtiments. Une fois les bâtiments et les étages créés, vous pouvez les lier à l’aide de parentId. Une pièce doit avoir un étage parent ou une section. Un espace de travail ou un bureau doit avoir une section parente. Une section doit avoir un étage parent. Un étage doit avoir un bâtiment parent.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Vous devez avoir le rôle Exchange Administration ou le rôle Places TenantPlacesManagement.

Exemples

Exemple 1

Cet exemple montre comment configurer la hiérarchie de répertoires pour une salle, un étage et un bâtiment.

Dans cet exemple, le PlaceId de l’étage est f12172b6-195d-4e6e-8f4f-eb72e41de99a, et le PlaceId du bâtiment est daa2f89b-75c4-4eb7-adcc-ff249233338d.

Set-PlaceV3 -Identity 'room@contoso.com' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ParentId daa2f89b-75c4-4eb7-adcc-ff249233338d

Exemple 2

Cet exemple met à jour l’adresse d’un bâtiment.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052

Exemple 3

Cet exemple met à jour les coordonnées géographiques d’un bâtiment.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -GeoCoordinates "47.644125;-122.122411"

Exemple 4

Cet exemple met à jour les liens de ressources pour un bâtiment avec des liens de ressources. L’ensemble est remplacé lors de la mise à jour. Pour ajouter ou supprimer une valeur, veillez à inclure les valeurs précédentes qui doivent être conservées.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}

Exemple 5

Cet exemple crée un bureau réservable sous une section sans spécifier les détails de la boîte aux lettres. Une boîte aux lettres de bureau est automatiquement créée et liée, et la propriété MailboxOID est remplie. Le bureau apparaît dans Places Finder et est disponible pour la réservation par tout le monde.

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Reservable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Reservable'}

Exemple 6

Cet exemple met à jour la valeur du mode en mode DropIn.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -Mode @{Name='DropIn'}

Exemple 7

Cet exemple met à jour la valeur du mode en mode Affecté.

Notez que même si le bureau est déjà un bureau en mode affecté, la modification est uniquement le champ de métadonnées. Un tout nouvel objet de mode doit être créé et remplacer l’ancien objet.

$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a Mode @{Name='Assigned';Metadata=$modemetadata}

Paramètres

- Identité

Le paramètre identity spécifie l’emplacement à mettre à jour. Vous pouvez utiliser n’importe quelle valeur qui identifie un emplacement de manière unique.

Par exemple, pour les emplacements basés sur une boîte aux lettres (salles de conférence et espaces de travail) :

• Nom [déconseillé]
• Alias [déconseillé]
• Nom unique (DN) [déconseillé]
• DN canonique [déconseillé]
• GUID [déconseillé]
• Adresse électronique

Par exemple, pour les lieux qui ne sont pas basés sur une boîte aux lettres (bâtiments, étages, sections et bureaux) :

• Nom
• GUID

-AudioDeviceName et -VideoDeviceName

Ces paramètres spécifient le nom des périphériques audio et vidéo dans la salle. Si la valeur contient des espaces, placez-la entre guillemets (").

La valeur par défaut est vide ($null). Pour indiquer que cette salle n’a pas de périphérique audio ou vidéo, utilisez la valeur $null pour le paramètre .

-Bâtiment

Le paramètre Building spécifie le nom ou le numéro de bâtiment dans lequel se trouve la salle. Si la valeur contient des espaces, placez-la entre guillemets (").

-Capacité

Le paramètre Capacity spécifie la capacité de la salle ou de l’espace de travail. Une valeur valide est un entier.

-Ville

Le paramètre City spécifie la ville du bâtiment. Si la valeur contient des espaces, placez-la entre guillemets ("). La longueur maximale est de 200 caractères.

-CountryOrRegion

Le paramètre CountryOrRegion spécifie le pays ou la région du bâtiment. Une valeur valide est un code de pays à deux lettres ISO 3166-1 valide (par exemple, AU pour l’Australie) ou le nom convivial correspondant pour le pays (qui peut être différent du nom court officiel de l’Agence de maintenance ISO 3166).

Une référence pour les codes pays à deux lettres est disponible dans La liste des codes pays.

-Label

Le paramètre Label spécifie une étiquette descriptive pour l’emplacement. Si la valeur contient des espaces, placez-la entre guillemets ("). La longueur maximale est de 200 caractères.

Pour les salles et les espaces de travail, la commande met à jour la valeur nommée -Label dans Exchange Set-Place.

-DisplayDeviceName

Le paramètre DisplayDeviceName spécifie le nom de l’appareil d’affichage à l’emplacement (salle, bureau ou espace de travail). Si la valeur contient des espaces, placez-la entre guillemets (").

La valeur par défaut est vide ($null). Pour indiquer que cet emplacement n’a pas de périphérique d’affichage, utilisez la valeur $null pour ce paramètre.

-FloorLabel

Le paramètre FloorLabel spécifie une étiquette descriptive pour le plancher. Si la valeur contient des espaces, placez-la entre guillemets (").

-Sol

Le paramètre Floor spécifie l’ordre de tri de l’étage dans un bâtiment particulier.

-GeoCoordinates

Le paramètre GeoCoordinates spécifie l’emplacement du bâtiment en coordonnées de latitude, longitude et (éventuellement) altitude. Une valeur valide pour ce paramètre utilise l’un des formats suivants :

• Latitude et longitude : par exemple, « 47.644125 ;-122.122411 »
• Latitude, longitude et altitude : par exemple, « 47.644125 ;-122.122411 ; 161.432"

Si les séparateurs de points ne fonctionnent pas pour vous, utilisez plutôt des virgules.

-IsWheelChairAccessible

Le paramètre IsWheelChairAccessible spécifie si l’endroit est accessible en fauteuil roulant. Les valeurs valides sont les suivantes :

• $true : L’endroit est accessible en fauteuil roulant.
• $false : L’endroit n’est pas accessible en fauteuil roulant. Il s’agit de la valeur par défaut.

-MTREnabled

Le paramètre MTREnabled identifie la salle comme configurée avec un système de salle Microsoft Teams. Vous pouvez ajouter des systèmes de salle Teams en tant que sources audio dans les réunions Teams qui impliquent la salle. Les valeurs valides sont les suivantes :

• $true : la salle dispose d’un système de salle Teams. Vous pouvez ajouter le système de salle Teams aux réunions Microsoft Teams lorsque vous choisissez de participer à une réunion avec l’audio de salle.
• $false : la salle n’a pas de système de salle Teams. Les utilisateurs peuvent participer à des réunions Teams à l’aide de l’audio de leur PC ou de leur appareil mobile au lieu d’utiliser l’audio de salle. Il s’agit de la valeur par défaut.

Pour plus d’informations sur Salles Microsoft Teams, consultez Salles Microsoft Teams.

-DisplayName

Le paramètre DisplayName spécifie le nom complet de l’emplacement. La longueur maximale est de 200 caractères. Pour mettre à jour le nom complet d’une salle ou d’un espace de travail associé à une adresse SMTP, vous avez besoin du rôle Administrateur de place, Administrateur Exchange ou Administration général.

-ParentId

Le paramètre ParentId spécifie l’ID d’un emplacement dans la hiérarchie d’emplacement parent dans Microsoft Places. Une pièce doit avoir un étage parent ou une section. Un espace de travail ou un bureau doit avoir une section parente. Une section doit avoir un étage parent. Un étage doit avoir un bâtiment parent.

-PostalCode

Le paramètre PostalCode spécifie le code postal du bâtiment.

-ResourceLinks

Le paramètre ResourceLinks spécifie des liens externes ou des ID d’application Teams qui doivent être associés à ce bâtiment, tels qu’un menu de salle à manger, un lien vers des services ou une application Teams pour la gestion des visiteurs. Pour plus d’informations sur la configuration des services dans Places, consultez Services dans Places.

La valeur doit être fournie sous forme de tableau de liens, comme indiqué dans l’exemple 4. Chaque lien doit contenir les propriétés suivantes : Name, Value et Type. Par exemple, un lien est écrit sous la forme @{name="TestLink » ; value= »https://contoso.com/" ;; type="Url"}.

• Name

  • Cette chaîne est utilisée pour montrer comment votre lien ou nom d’application est affiché dans l’application Places.

  • La longueur maximale est de 200 caractères.

• Valeur

  • Cette valeur doit être un lien d’URL ou un ID d’application Teams. Les ID d’application Teams se trouvent dans la page Détails de l’application de la page Gérer les applications du Centre d’administration Teams.

  • La longueur maximale est de 1 000 caractères.

• Le type doit être l’un des types pris en charge :

  • Url : indique qu’il s’agit d’un lien URL.

  • MetaOsApp : indique que ce lien est une application Teams.

-SortOrder

Le paramètre SortOrder spécifie l’ordre de tri de l’étage. Par exemple, un étage peut être nommé « Lobby » avec un ordre de tri de 0 pour afficher cet étage en premier dans les listes triées.

-État

Le paramètre State spécifie l’état ou la province du bâtiment. La longueur maximale est de 200 caractères.

-Rue

Le paramètre Street spécifie l’adresse physique du bâtiment. La longueur maximale est de 200 caractères.

-Mode

Le paramètre Mode définit la façon dont un lieu est destiné à être utilisé ou réservé. Actuellement, le mode n’est disponible que pour les bureaux et les pools de bureaux (espaces de travail).

Actuellement, il existe quatre modes au total.

• Réservable : les bureaux réservables sont les bureaux configurés pour être réservés à l’avance ou sur place.
• Le bureau est disponible sur place et ne peut pas être réservé à l’avance. Vous pouvez utiliser la fonctionnalité de Microsoft Teams pour lier les appareils périphériques présents sur ces bureaux à l’objet de bureau individuel dans le répertoire.
• Affecté : un bureau affecté est lié de manière permanente à un utilisateur spécifique et ne peut pas être réservé par d’autres personnes. Chaque bureau affecté doit toujours avoir un utilisateur désigné.
• Non disponible : le bureau n’est pas disponible pour la réservation en raison d’une maintenance ou pour toute autre raison.

La valeur du mode doit contenir les propriétés suivantes : Name et Metadata, comme indiqué dans l’exemple 6. Name est une chaîne et les métadonnées sont un objet de dictionnaire.

• Nom : le champ Nom spécifie le mode actif d’un emplacement. Il utilise une valeur d’énumération, et les options disponibles varient selon le type de lieu. Pour les bureaux, les modes pris en charge incluent Reservable, DropInAssigned et Unavailable. Pour les pools de bureaux, les modes pris en charge sont Reservable, DropIn et Unavailable.

• Métadonnées : le champ Métadonnées est un dictionnaire utilisé pour stocker des informations supplémentaires pertinentes pour le mode sélectionné. Ces métadonnées prennent en charge la logique métier liée à des scénarios de réservation spécifiques.

  • Places en mode Réservé et DropIn ne prennent pas en charge les champs de métadonnées.
  • Places en mode Non disponible prennent en charge un Reason champ (chaîne) qui explique pourquoi le bureau n’est pas disponible. Les valeurs incluent New pour les bureaux nouvellement créés et Maintenance pour les Places en cours de service.
  • Le mode affecté prend en charge deux champs de métadonnées : AssignedPersonEmailAddress et AssignedPersonId. Ceux-ci identifient l’utilisateur affecté au bureau. Le fait de fournir l’un ou l’autre champ est suffisant pour activer le mode attribué.

-Étiquettes

Le paramètre Tags spécifie des fonctionnalités supplémentaires de la pièce (par exemple, des détails tels que le type de vue ou le type de mobilier). Il n’existe actuellement aucune longueur maximale.

Vous pouvez spécifier plusieurs étiquettes séparées par des virgules. Si les étiquettes contiennent des espaces, placez les valeurs entre guillemets : "Label 1","Label 2",..."Label N".

Résolution des problèmes

Je reçois une erreur d’autorisation refusée.

Set-PlaceV3 nécessite l’un des rôles suivants : TenantPlacesManagement, GlobalAdmin ou MailRecepients. Étant donné que les rôles peuvent être attribués de différentes façons, voici les méthodes prises en charge pour attribuer des autorisations de rôle :

• Si l’autorisation est attribuée via exchange Administration Center (qui prend uniquement en charge les autorisations permanentes), vous ne devriez avoir aucun problème avec l’utilisation des applets de commande Places. Il n’est pas normal que vous voyiez une erreur Autorisation refusée.
• Si l’autorisation est attribuée directement à l’utilisateur via Entra (en tant que rôle permanent ou temporaire), vous ne devriez avoir aucun problème avec l’utilisation des applets de commande Places. Il n’est pas normal que vous voyiez une erreur Autorisation refusée. Toutefois, il peut y avoir un certain retard dans la synchronisation entre Entra et Exchange.
• Si l’autorisation est attribuée via Entra à un groupe dans Entra, dont l’utilisateur fait partie, cela n’est pas pris en charge par Exchange et le rôle via le groupe ne sera pas respecté. Les applets de commande Exchange et les applets de commande Places échouent tous les deux avec l’autorisation refusée. Ce comportement attendu est décrit ici.

J’ai affecté un ParentId à une ressource, mais je ne le vois pas encore dans Places Finder.

Jusqu’à 24 heures peuvent être nécessaires pour que la corrélation entre la ressource et son parent Floor apparaisse dans Places expériences. Nous travaillons à l’élimination de ce délai.

Comment faire définir une photo sur une ressource ?

La Set-UserPhoto a été déconseillée en avril 2024. Nous travaillons à l’ajout d’un paramètre à cette applet de commande pour définir une photo sur les salles et les espaces de travail lors de l’utilisation de Set-PlaceV3. En attendant, suivez ces instructions pour définir la photo dans une salle ou un espace de travail.

Il n’est actuellement pas possible de placer des photos sur un bâtiment ou sur un étage.