New-Place
Utilisez l’applet de commande New-Place pour créer des bâtiments, des étages, des sections ou des bureaux dans votre répertoire Places.
Remarque
Pour créer des salles ou des espaces de travail, vous devez continuer à utiliser l’applet de commande New-Mailbox documentée ici.
Syntaxe
Création de rapports
New-Place
[-DisplayName]
[-Type]
[-Label]
[-PostalCode]
[-CountryOrRegion]
[-State]
[-City]
[-Street]
[-GeoCoordinates]
[-ResourceLinks]
[-Tags]
Floor
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
[-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.
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
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 (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 en créant la boîte aux lettres uniquement. 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.
New-Place
[-DisplayName]
[-Type]
[-Label]
[-ParentId]
[-GeoCoordinates]
[-Mailbox]
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 crée un bâtiment et un étage dans ce bâtiment.
New-Place -Type Building -Name 'Building 3'
Une fois le bâtiment 3 créé, lisez son PlaceId à utiliser lors de la définition du ParentId sur les étages.
New-Place -Type Floor -Name 'Lobby' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
New-Place -Type Floor -Name '1' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
Exemple 2
Cet exemple crée un bâtiment avec des informations d’adresse.
New-Place -Name 'Building 3' -Type Building -Description 'Building 3 in North of Redmond Campus' -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052
Exemple 3
Cet exemple crée un bâtiment avec des liens de ressources.
New-Place -Name 'Building 3' -Type Building -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}'
Exemple 4
Cet exemple crée une section parentée à un étage, puis crée une boîte aux lettres de bureau et l’affecte à une entité de bureau existante. Notez que vous avez ExchangeOnlineManagement installé le module et que vous exécutez l’applet de Connect-ExchangeOnline commande avant d’exécuter cet exemple de script.
$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
New-Place -Name 'Desk101' -Type Desk -ParentId $section.PlaceId -Mailbox $mbx.Alias
Paramètres
-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.
| 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.
Les informations d’adresse sont utilisées par la page Explorer Places pour afficher les bâtiments à proximité.
| 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.
| 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 |
-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"
Remarque
Si les séparateurs de points ne fonctionnent pas pour vous, utilisez plutôt des virgules.
| 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 |
-DisplayName
Le paramètre DisplayName spécifie le nom complet de l’emplacement. La longueur maximale est de 200 caractères.
Le nom d’affichage d’un bâtiment est visible :
- Dans Outlook, lorsque les utilisateurs configurent leurs heures de travail et leur emplacement, ils peuvent sélectionner un bâtiment.
- Dans Places page Explorer qui montre qui se trouve dans le même bâtiment, les bâtiments à proximité, etc.
- Dans Places Finder, en tant que filtre lors de la recherche d’une salle de conférence ou d’un espace de travail.
Le nom d’affichage d’un étage est visible dans Places Finder en tant que filtre lors de la recherche d’une salle de conférence ou d’un espace de travail.
| 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 », parallèlement au parentage de la pièce à l’entité floor. Places Finder utilise la nouvelle hiérarchie, tandis qu’Outlook Roomfinder continue d’utiliser 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 des salles et des 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. La longueur maximale est de 200 caractères.
| 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 les liens externes ou les 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 entier est remplacé. Pour ajouter ou supprimer une valeur, veillez à inclure les valeurs précédentes qui doivent être conservées.
| Attribut | Description |
|---|---|
| Type : | ResourceLink[] |
| 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.
| 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.
| 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 d’autres fonctionnalités 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 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.
| 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 |
-Type
Le paramètre Type spécifie le type de l’emplacement en cours de création. Les valeurs valides sont les suivantes :
- Création de rapports
- Floor
- Section
- Bureau
| Attribut | Description |
|---|---|
| Type : | String |
| Position: | Nommé |
| Valeur par défaut: | Aucun |
| Obligatoire : | Vrai |
| Accepter l’entrée de pipeline : | Vrai |
| Accepter les caractères génériques : | Faux |