Set-PlaceV3
Utilisez l’applet de commande Set-PlaceV3 pour mettre à jour les métadonnées relatives à vos salles, espaces de travail, étages ou bâtiments dans votre répertoire Places.
Remarque
- Mises à jour aux salles de conférence & les espaces de travail peuvent prendre jusqu’à 24 heures pour réfléchir. Si vous avez besoin d’intégrer plusieurs salles et espaces de travail, nous vous recommandons d’utiliser
Initialize-Places, qui peut forcer la réflexion immédiate des modifications. - 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 sur une salle ou un espace de travail.
Syntaxe
Création de rapports
Set-PlaceV3
[-Identity]
[-DisplayName]
[-Label]
[-IsWheelChairAccessible]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-ResourceLinks]
[-Tags]
Floor
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-SortOrder]
[-Tags]
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]
[-Tags]
Bureau
Les bureaux sont un nouveau type d’entité dans Places, qui représentent des bureaux individuels. Ces objets peuvent être réservables ou non réservables (valeur par défaut).
Pour rendre un bureau réservable, vous devez créer une boîte aux lettres Desk et l’associer à l’objet desk en passant la boîte aux lettres Alias au Mailbox paramètre de Set-PlaceV3. Notez que contrairement aux types Salle/Espace de travail, les bureaux ne sont pas provisionnés implicitement par la création de la boîte aux lettres seule. En outre, les métadonnées (telles que les Capacity champs ou DisplayName ) ne sont pas synchronisées avec les métadonnées de boîte aux lettres. La boîte aux lettres est principalement requise pour le moteur de réservation uniquement et les métadonnées sont lues à partir de Places Directory.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-Name]
[-Tags]
[-Mailbox]
Salle ou espace de travail
Set-PlaceV3 prend en charge les paramètres d’emplacement hérités déjà exposés dans l’applet de commande Exchange Set-Place. Toutefois, une fois qu’une salle est liée à un étage/bâtiment à l’aide du paramètre , les -ParentId informations d’emplacement (Street, City, etc.) doivent être gérées sur le bâtiment plutôt que sur la salle ou l’espace de travail.
Set-PlaceV3
[-Identity]
[-DisplayName]
[-ParentId]
[-Label]
[-Capacity]
[-IsWheelChairAccessible]
[-AudioDeviceName]
[-DisplayDeviceName]
[-VideoDeviceName]
[-MTREnabled]
[-GeoCoordinates]
[-Phone]
[-Street]
[-City]
[-State]
[-PostalCode]
[-CountryOrRegion]
[-Building]
[-Floor]
[-FloorLabel]
[-Tags]
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.
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.
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 géocoordinates 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 une boîte aux lettres de bureau et l’affecte à une entité de bureau existante. Notez que vous devez avoir installé ExchangeOnlineManagement le module et exécuté l’applet Connect-ExchangeOnline de commande avant d’exécuter ce qui suit :
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
Set-PlaceV3 {DeskId} -Mailbox $mbx.Alias
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
- Alias
- Nom unique
- Nom unique
- Nom unique canonique
- GUID
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
| Attribut | Description |
|---|---|
| Type : | RecipientIdParameter |
| Position: | 0 |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Vrai |
| Accepter les caractères génériques : | Faux |
-AudioDeviceName, -DisplayDeviceName et VideoDeviceName
Ces paramètres spécifient le nom des périphériques audio, d’affichage 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, d’affichage ou vidéo, utilisez la valeur $null pour le paramètre .
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-Bâtiment
Importante
Le paramètre de génération est déconseillé et fourni ici uniquement à des fins de compatibilité descendante. Les informations de génération sont lues à partir de l’entité Building qui se trouve sur la chaîne parente de la salle ou de l’espace de travail.
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 (").
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-Capacité
Le paramètre Capacity spécifie la capacité de la salle. Une valeur valide est un entier.
| Attribut | Description |
|---|---|
| Type : | System.Int32 |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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.
Nous vous recommandons de gérer les données d’emplacement sur le bâtiment plutôt que sur la salle/espace de travail. Il existe une hiérarchie entre les salles ,> les étages> et les bâtiments, et les salles héritent des attributs d’emplacement de leur bâtiment.
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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.
Nous vous recommandons de gérer les données d’emplacement sur le bâtiment plutôt que sur la salle/espace de travail. Il existe une hiérarchie entre les salles ,> les étages> et les bâtiments, et les salles héritent des attributs d’emplacement de leur bâtiment.
| Attribut | Description |
|---|---|
| Type : | CountryInfo |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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.
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Vrai |
| Accepter les caractères génériques : | Faux |
-DisplayDeviceName
Le paramètre DisplayDeviceName spécifie le nom de l’appareil d’affichage 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 d’affichage, utilisez la valeur $null pour ce paramètre.
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-FloorLabel
Le paramètre FloorLabel spécifie une étiquette descriptive pour le plancher. Si la valeur contient des espaces, placez-la entre guillemets (").
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-Sol
Le paramètre Floor spécifie l’ordre de tri de l’étage dans un bâtiment particulier.
| Attribut | Description |
|---|---|
| Type : | System.Int32 |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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.
Nous vous recommandons de gérer les données d’emplacement sur le bâtiment plutôt que sur la salle/espace de travail. Il existe une hiérarchie entre les salles -> les étages -> les bâtiments, et les salles hériteront des attributs d’emplacement de leur bâtiment.
| Attribut | Description |
|---|---|
| Type : | GeoCoordinates |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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.
| Attribut | Description |
|---|---|
| Type : | Boolean |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-MTREnabled
Remarque
Actuellement, ce paramètre est à information uniquement et n’entraîne aucune fonctionnalité supplémentaire.
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.
| Attribut | Description |
|---|---|
| Type : | Boolean |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-DisplayName
Le paramètre DisplayName spécifie le nom complet de l’emplacement. La longueur maximale est de 200 caractères. Set-PlaceV3 pouvez uniquement mettre à jour le nom des lieux qui n’ont pas d’adresse SMTP associée, tels que les bâtiments et les étages. Pour mettre à jour le nom d’affichage d’un lieu associé à une adresse SMTP telle que des salles de conférence et des espaces de travail, utilisez l’applet de commande Exchange Set-Mailbox.
| Attribut | Description |
|---|---|
| Type : | String |
| Valeur par défaut: | Aucun |
| Obligatoire : | Vrai |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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.
Remarque
Si vous avez besoin d’une compatibilité descendante avec Outlook Roomfinder, veillez également à mettre à jour les propriétés « Floor » /« FloorLabel », en parallèle du parentage de la salle à l’entité floor. Places Finder utilisera la nouvelle hiérarchie, tandis qu’Outlook Roomfinder utilisera les objets « Floor » et « FloorLabel » hérités. Vous devez également vous assurer que la salle est associée à une liste de salles, comme indiqué ici Configurer les salles et les espaces de travail pour la recherche de salles dans Outlook.
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-PostalCode
Le paramètre PostalCode spécifie le code postal du bâtiment.
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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.
Remarque
L’ensemble du jeu sera remplacé lors de la mise à jour. Pour ajouter ou supprimer une valeur, veillez à inclure les valeurs précédentes qui doivent être conservées.
| Attribut | Description |
|---|---|
| Type : | Lien[] |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-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.
| Attribut | Description |
|---|---|
| Type : | System.Int32 |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-État
Le paramètre State spécifie l’état ou la province du bâtiment. La longueur maximale est de 200 caractères.
Nous vous recommandons de gérer les données d’emplacement sur le bâtiment plutôt que sur la salle/espace de travail. Il existe une hiérarchie entre les salles -> les étages -> les bâtiments, et la salle hérite des attributs d’emplacement de leur bâtiment.
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-Rue
Le paramètre Street spécifie l’adresse physique du bâtiment. La longueur maximale est de 200 caractères.
Nous vous recommandons de gérer les données d’emplacement sur le bâtiment plutôt que sur la salle/espace de travail. Il existe une hiérarchie entre les salles ,> les étages> et les bâtiments, et les salles héritent des attributs d’emplacement de leur bâtiment.
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
-É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".
Remarque
L’ensemble du jeu sera remplacé lors de la mise à jour. Pour ajouter ou supprimer une valeur, veillez à inclure les valeurs précédentes qui doivent être conservées.
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Faux |
| Accepter l’entrée de pipeline : | Faux |
| Accepter les caractères génériques : | Faux |
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.