Set-PlaceV3

Utilisez l’applet de commande Set-PlaceV3 pour mettre à jour les métadonnées relatives à vos bureaux, pièces, 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 rattachés à une section. Les pièces peuvent également être parentes à une section ou elles peuvent être directement parentes à 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, consultez la section mode ci-dessous.

Pour les bureaux, les dépendances suivantes existent entre le mode et la configuration de boîte aux lettres :

• Si la propriété Mode n’est pas définie, le bureau est indisponible par défaut et aucune boîte aux lettres de bureau n’est créée automatiquement.
• Pour les bureaux définis en mode Réservable ou DropIn, une boîte aux lettres de bureau est requise. Un est automatiquement créé lorsque le bureau est provisionné. Vous pouvez également lier une boîte aux lettres existante en spécifiant EmailAddress dans le paramètre Boîte aux lettres.
• Pour les bureaux en mode Attribué ou Indisponible, 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 configuré initialement, le bureau reste en mode indisponible. La liaison d’une boîte aux lettres par la suite ne met pas automatiquement à jour le mode du bureau.

Contrairement aux types de salles ou d’espaces de travail, les bureaux ne sont pas automatiquement configurés en créant simplement une boîte aux lettres. En outre, les métadonnées telles que la capacité ou DisplayName ne sont pas synchronisées avec les propriétés de la 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 salle est liée à un étage ou à un bâtiment à l’aide du paramètre, les détails de l’emplacement -ParentId (Street et City) doivent être gérés au niveau du bâtiment, et non au niveau de la salle ou de 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 paramètre, les détails de l’emplacement -ParentId (Street et City) doivent être gérés au niveau du bâtiment, et non au niveau de la salle ou de l’espace de travail individuel.

L’espace de travail prend en charge la propriété Mode. Les détails de celui-ci sont documentés dans -Mode la 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 ou une section parent. Un espace de travail ou un bureau doit avoir une section parent. 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 configure la hiérarchie de répertoire pour une pièce, 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 d’un bâtiment avec des liens de ressource. 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 renseignée. Le bureau apparaît dans Places Finder et est disponible à la réservation pour 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 <DeskOrWorkspacePlaceId> -Mode @{Name='DropIn'}

Exemple 7

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

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

$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
Set-PlaceV3 -Identity <DeskPlaceId> -Mode @{Name='Assigned';Metadata=$modemetadata}

Paramètres

- Identité

Le paramètre d’identité spécifie l’emplacement que vous souhaitez mettre à jour. Vous pouvez utiliser n’importe quelle valeur qui identifie un lieu 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 e-mail

Par exemple, pour les emplacements 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 de 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 ne dispose d’aucun périphérique audio ou vidéo, utilisez la valeur $null du paramètre.

-Bâtiment

Le paramètre Building spécifie le nom ou le numéro du bâtiment dans lequel se trouve la pièce. 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 abrégé officiel de l’Agence de maintenance ISO 3166).

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

-Label

Le paramètre Label spécifie une étiquette descriptive pour le lieu. 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 du périphérique d’affichage dans 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.

-Étiquette au sol

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

-Plancher

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

-Coordonnées géographiques

Le paramètre GeoCoordinates spécifie l’emplacement du bâtiment en coordonnées de latitude, de longitude et (éventuellement) d’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 aux fauteuils roulants. Les valeurs valides sont les suivantes :

• $true : L’endroit est accessible aux fauteuils roulants.
• $false : L’endroit n’est pas accessible aux fauteuils roulants. Il s’agit de la valeur par défaut.

-MTREnabled

Le paramètre MTREnabled identifie la salle telle qu’elle est configurée avec un système de salle Microsoft Teams. Vous pouvez ajouter des systèmes de salle Teams comme sources audio dans les réunions Teams impliquant 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 sélectionnez de rejoindre une réunion avec l’audio de la salle.
• $false : la salle ne dispose pas d’un système de salle Teams. Les utilisateurs peuvent rejoindre les 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 les Salles Microsoft Teams, consultez Salles Microsoft Teams.

-DisplayName

Le paramètre DisplayName spécifie le nom d’affichage du lieu. La longueur maximale est de 200 caractères. Pour mettre à jour le nom d’affichage d’une salle ou d’un espace de travail auquel une adresse SMTP est associée, vous avez besoin du rôle Administrateur de lieu, Administrateur Exchange ou Administration global.

-ParentId

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

-Code postal

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

-ResourceLinks

Le paramètre ResourceLinks spécifie les liens externes ou les ID d’application Teams qui doivent être associés à ce bâtiment, tels qu’un menu de restauration, 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, voir Services dans Places.

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

• Nom

  • 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 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 d’URL.

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

-SortOrder

Le paramètre SortOrder spécifie l’ordre de tri du plancher. Par exemple, un étage peut être nommé « Salle d’attente » avec un ordre de tri de 0 pour afficher cet étage en premier dans les listes organisé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 est uniquement disponible pour les bureaux et les pools de bureaux (espaces de travail).

Actuellement, il existe quatre modes en tout.

• Réservable- Les bureaux réservables sont les bureaux configurés pour être réservés à l’avance ou sur place.
• DropIn - 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 périphériques présents sur ces bureaux à l’objet de bureau individuel dans le répertoire.
• Attribué : un bureau attribué est lié en permanence à un utilisateur spécifique et ne peut pas être réservé par d’autres. Chaque bureau affecté doit toujours avoir un utilisateur désigné.
• Non disponible - Le bureau n’est pas disponible pour réservation en raison de l’entretien ou pour toute autre raison.

La valeur Mode contient une propriété Name et, pour les modes qui le prennent en charge, un dictionnaire Metadata. Consultez l’exemple 7 pour un exemple de mode attribué incluant des métadonnées.

• Nom : le champ Nom spécifie le mode actif d’un lieu. 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 sont 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 relatives au mode sélectionné. Ces métadonnées prennent en charge la logique métier liée à des scénarios de réservation spécifiques.

  • Les Places en modes Reservable et DropIn ne prennent en charge aucun champ de métadonnées.
  • Les 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. Il suffit de fournir l’un ou l’autre champ pour activer le mode affecté.

-Balises

Le paramètre Tags spécifie des caractéristiques 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 requiert l’un des rôles suivants : TenantPlacesManagement, GlobalAdmin ou MailRecipients. Les rôles pouvant être attribués de différentes manières, voici les méthodes prises en charge pour attribuer des autorisations de rôle :

• Si l’autorisation est attribuée via le Centre d’administration Exchange (qui ne prend en charge que les autorisations permanentes), vous ne devriez rencontrer aucun problème avec l’utilisation des applets de commande Places. On ne s’attend pas à ce qu’une erreur d’autorisation refusée s’affiche.
• Si l’autorisation est attribuée via Entra directement à l’utilisateur (en tant que rôle permanent ou temporaire), vous ne devriez rencontrer aucun problème avec l’utilisation des applets de commande Places. On ne s’attend pas à ce qu’une erreur d’autorisation refusée s’affiche. 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 groupe ne sera pas respecté. Les applets de commande Exchange et les applets de commande Places échouent avec l’autorisation refusée. Ce comportement attendu est décrit ici.

J’ai attribué un ParentId à une ressource, mais je ne le vois pas encore dans la fonction Recherche de Places.

Il peut s’écouler jusqu’à 24 heures avant que la corrélation entre la ressource et son étage parent n’apparaisse dans les expériences Places. Nous nous efforçons d’éliminer ce retard.

Comment faire placer une photo sur une ressource ?

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

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