New-Place

Utilisez l’applet de commande New-Place pour créer des bâtiments, des étages, des sections, des salles, des espaces de travail ou des bureaux dans votre annuaire Places.

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 logique d’espaces au sein d’un étage, tel qu’un quartier.

• Les bureaux et les espaces de travail doivent appartenir à une section.
• Les salles peuvent être affectées à une section ou directement associées à un étage.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]

Room

La création d’une salle provisionne automatiquement une boîte aux lettres associée. Si vous fournissez un EmailAddress dans le paramètre Mailbox, une nouvelle boîte aux lettres est créée avec ce nom et liée à la salle.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-Capacity]

Espace de travail

La création d’un espace de travail (pool de bureaux) provisionne automatiquement une boîte aux lettres associée. Si vous fournissez un EmailAddress dans le paramètre Mailbox, une nouvelle boîte aux lettres est créée avec ce nom et liée à l’espace de travail.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-Capacity]

Bureau

Un bureau représente une unité de bureau individuelle. Chaque bureau a une propriété Mode qui définit la façon dont il peut être utilisé :

• Réservable : peut être réservé à l’avance.
• Drop-In : disponible pour une utilisation sur place uniquement.
• Affecté : affecté à un utilisateur spécifique.
• Non disponible : non disponible pour la réservation.

Le mode bureau et la boîte aux lettres fonctionnent comme suit :

• Comportement par défaut : Si le mode n’est pas défini, la valeur par défaut du bureau est Indisponible. Aucune boîte aux lettres n’est créée.
• Mode Réservé ou DropIn : Une boîte aux lettres de bureau est requise. Un est créé automatiquement lorsque le bureau est approvisionné ou que vous pouvez le lier à un bureau existant.
  • Si vous fournissez un EmailAddress existant dans le paramètre Mailbox, le bureau est lié à cette boîte aux lettres.
  • Si vous fournissez un EmailAddress qui n’existe pas, une boîte aux lettres est créée avec ce nom et liée au bureau.
  • Si aucune adresse e-mail n’est fournie, une boîte aux lettres est créée automatiquement avec un nom généré par le système et liée au bureau.
• 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. Toutefois, vous pouvez associer manuellement ces bureaux à des boîtes aux lettres personnalisées si nécessaire.
• Changement de mode ultérieurement : Si le bureau démarre en mode Non disponible et qu’aucune boîte aux lettres n’est liée, le basculement du bureau vers Réservable à l’aide de l’applet de commande Set-PlacesV3 crée et lie automatiquement une boîte aux lettres. Toutefois, la liaison d’une boîte aux lettres à un bureau ne met pas automatiquement à jour le mode du bureau.

Contrairement aux salles ou aux espaces de travail, les bureaux ne synchronisent pas les métadonnées telles que Capacity ou DisplayName 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.

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-ParentId]
 [-GeoCoordinates]
 [-Mailbox]
 [-Mode]

Description

Microsoft Places nécessite une hiérarchie complète pour les bâtiments, les étages, les sections, les salles, les espaces de travail et les bureaux.

• Un étage doit appartenir à un bâtiment.
• Une section doit appartenir à un étage.
• Une pièce doit appartenir à un étage ou à une section.
• Un espace de travail ou un bureau doit appartenir à une section.

Utilisez la propriété ParentId pour lier des entités.

Pour exécuter cette applet de commande, vous avez besoin de l’un de ces rôles : administrateur Places, administrateur Exchange ou un rôle personnalisé avec les autorisations TenantPlacesManagement.

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 salle parentée à une section et avec une capacité de 10, sans spécifier les détails de la boîte aux lettres. Une boîte aux lettres de salle est automatiquement créée et liée.

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Capacity 10

Exemple 5

Cet exemple crée une salle parentée à une section et fournit les détails d’une boîte aux lettres

New-Place -Name 'Room a' -Type Room -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

Exemple 6

Cet exemple crée un espace de travail (pool de bureaux) parenté d’une section et fournit les détails d’une boîte aux lettres

New-Place -Name 'Deskpool A' -Type Workspace -ParentId -ParentId $SectionId -Mailbox <mailboxAddress>

Exemple 7

Cet exemple crée un bureau réservable parenté d’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 8

Cet exemple crée un bureau réservable parenté d’une section et fournit une boîte aux lettres. Si la boîte aux lettres existe, le bureau y est lié, sinon une nouvelle boîte aux lettres de bureau est créée automatiquement avec le nom fourni.

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

Exemple 9

Cet exemple crée un bureau en mode attribué parenté à une section et l’affecte à une personne. Seule la personne affectée peut utiliser ce bureau. D’autres ne peuvent plus la réserver.

$section = New-Place -Name 'Section1' -Type Section -ParentId 'someFloorId'
$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
New-Place -Name 'Bookable Desk101' -Type Desk -ParentId $section.PlaceId -Mode @{Name='Assigned';Metadata=$modemetadata}

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.

-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é.

-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.

-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"

-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.

-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. La longueur maximale est de 200 caractères.

-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.

-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.

-É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".

-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 façon 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 de la maintenance ou pour toute autre raison.

La valeur du mode doit contenir les propriétés suivantes : Nom et Métadonnées, comme indiqué dans l’exemple 5. 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, Drop-InAssigned et Unavailable. Pour les pools de bureaux, les modes pris en charge sont Reservable, Drop-In 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 Drop-In 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é.

-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
• Room
• Espace de travail
• Bureau