New-Place

Verwenden Sie das Cmdlet New-Place, um Gebäude, Etagen, Abschnitte, Räume, Arbeitsbereiche oder Schreibtische in Ihrem Places Verzeichnis zu erstellen.

Syntax

Gebäude

New-Place
 [-DisplayName]
 [-Type]
 [-Label]
 [-PostalCode]
 [-CountryOrRegion]
 [-State]
 [-City]
 [-Street]
 [-GeoCoordinates]
 [-ResourceLinks]
 [-Tags]

Untergrenze

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

Abschnitt

Ein Abschnitt ist eine logische Gruppierung von Räumen innerhalb einer Etage, z. B. einer Nachbarschaft.

• Schreibtische und Arbeitsbereiche müssen zu einem Abschnitt gehören.
• Räume können entweder einem Abschnitt oder direkt einer Etage zugeordnet werden.

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

Raum

Beim Erstellen eines Raums wird automatisch ein zugeordnetes Postfach bereitgestellt. Wenn Sie eine EmailAddress im Parameter Mailbox angeben, wird ein neues Postfach mit diesem Namen erstellt und mit dem Raum verknüpft.

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

Arbeitsbereich

Beim Erstellen eines Arbeitsbereichs (Schreibtischpools) wird automatisch ein zugeordnetes Postfach bereitgestellt. Wenn Sie eine EmailAddress im Parameter Mailbox angeben, wird ein neues Postfach mit diesem Namen erstellt und mit dem Arbeitsbereich verknüpft.

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

Schreibtisch

Ein Schreibtisch stellt eine einzelne Schreibtischeinheit dar. Jeder Schreibtisch verfügt über eine Mode-Eigenschaft, die definiert, wie er verwendet werden kann:

• Reservierbar – Kann im Voraus reserviert werden.
• Drop-In : Nur für die Verwendung vor Ort verfügbar.
• Zugewiesen : Einem bestimmten Benutzer zugewiesen.
• Nicht verfügbar : Nicht für Reservierungen verfügbar.

Der Schreibtischmodus und das Postfach funktionieren wie folgt:

• Standardverhalten: Wenn der Modus nicht definiert ist, wird der Schreibtisch standardmäßig auf Nicht verfügbar festgelegt. Es wird kein Postfach erstellt.
• Reservierungs- oder DropIn-Modus: Ein Schreibtischpostfach ist erforderlich. Eine wird automatisch erstellt, wenn der Schreibtisch bereitgestellt wird, oder Sie können eine Verknüpfung mit einem vorhandenen erstellen.
  • Wenn Sie eine vorhandene EmailAddress im Parameter Mailbox angeben, verknüpft der Desk mit diesem Postfach.
  • Wenn Sie eine EmailAddress angeben, die nicht vorhanden ist, wird ein neues Postfach mit diesem Namen erstellt und mit dem Schreibtisch verknüpft.
  • Wenn keine EmailAddress angegeben wird, wird automatisch ein Postfach mit einem vom System generierten Namen erstellt und mit dem Schreibtisch verknüpft.
• Zugewiesener oder nicht verfügbarer Modus: Das Verknüpfen eines Postfachs ist optional, und es wird kein Postfach erstellt. Sie können diese Schreibtische jedoch bei Bedarf benutzerdefinierten Postfächern manuell zuordnen.
• Modus später ändern: Wenn der Schreibtisch im Modus "Nicht verfügbar" gestartet wird und kein Postfach verknüpft ist, wird ein Postfach automatisch erstellt und verknüpft, wenn der Schreibtisch mithilfe des Cmdlets Set-PlacesV3 auf Reservable umgeschaltet wird. Durch das Verknüpfen eines Postfachs mit einem Schreibtisch wird der Modus des Schreibtischs jedoch nicht automatisch aktualisiert.

Im Gegensatz zu Räumen oder Arbeitsbereichen synchronisieren Schreibtische keine Metadaten wie Capacity oder DisplayName mit Postfacheigenschaften. Das Postfach wird hauptsächlich von der Reservierungs-Engine verwendet, während Metadaten aus dem Places Directory gelesen werden.

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

Beschreibung

Microsoft Places erfordert eine vollständige Hierarchie für Gebäude, Etagen, Abschnitte, Räume, Arbeitsbereiche und Schreibtische.

• Ein Boden muss zu einem Gebäude gehören.
• Ein Abschnitt muss zu einer Etage gehören.
• Ein Raum muss zu einer Etage oder einem Abschnitt gehören.
• Ein Arbeitsbereich oder Schreibtisch muss zu einem Abschnitt gehören.

Verwenden Sie die ParentId-Eigenschaft, um Entitäten zu verknüpfen.

Zum Ausführen dieses Cmdlets benötigen Sie eine der folgenden Rollen: Places Administrator, Exchange-Administrator oder eine benutzerdefinierte Rolle mit TenantPlacesManagement-Berechtigungen.

Beispiele

Beispiel 1

In diesem Beispiel werden ein neues Gebäude und eine Etage in diesem Gebäude erstellt.

New-Place -Type Building -Name 'Building 3'

Nachdem Gebäude 3 erfolgreich erstellt wurde, lesen Sie die PlaceId, die beim Festlegen der ParentId auf den Etagen verwendet werden soll.

New-Place -Type Floor -Name 'Lobby' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a
New-Place -Type Floor -Name '1' -ParentId f12172b6-195d-4e6e-8f4f-eb72e41de99a

Beispiel 2

In diesem Beispiel wird ein neues Gebäude mit Adressinformationen erstellt.

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

Beispiel 3

In diesem Beispiel wird ein neues Gebäude mit Ressourcenlinks erstellt.

New-Place -Name 'Building 3' -Type Building -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}'

Beispiel 4

In diesem Beispiel wird ein neuer Raum erstellt, der einem Abschnitt zugeordnet ist und eine Kapazität von 10 aufweist, ohne Postfachdetails anzugeben. Ein Raumpostfach wird automatisch erstellt und verknüpft.

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

Beispiel 5

In diesem Beispiel wird ein neuer Raum erstellt, der einem Abschnitt zugeordnet ist, und es werden Postfachdetails bereitgestellt.

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

Beispiel 6

In diesem Beispiel wird ein neuer Arbeitsbereich (Schreibtischpool) erstellt, der einem Abschnitt zugeordnet ist, und eine Postfachdetails angegeben.

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

Beispiel 7

In diesem Beispiel wird ein reservierbarer Schreibtisch erstellt, der einem Abschnitt übergeordnet ist, ohne Postfachdetails anzugeben. Ein Schreibtischpostfach wird automatisch erstellt und verknüpft, und die MailboxOID-Eigenschaft wird aufgefüllt. Der Schreibtisch erscheint in Places Finder und kann von jedem gebucht werden.

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

Beispiel 8

In diesem Beispiel wird ein reservierter Schreibtisch erstellt, der einem Abschnitt zugeordnet ist, und stellt ein Postfach bereit. Wenn das Postfach vorhanden ist, wird der Schreibtisch mit dem Postfach verknüpft, andernfalls wird automatisch ein neues Schreibtischpostfach mit dem angegebenen Namen erstellt.

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

Beispiel 9

In diesem Beispiel wird ein Schreibtisch im zugewiesenen Modus erstellt, der einem Abschnitt zugeordnet ist, und ihn einer Person zuweist. Nur die zugewiesene Person kann diesen Schreibtisch nutzen. Andere können es nicht mehr reservieren.

$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}

Parameter

-Stadt

Der Parameter City gibt die Stadt des Gebäudes an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen ("). Die maximale Länge beträgt 200 Zeichen.

-CountryOrRegion

Der CountryOrRegion-Parameter gibt das Land oder die Region des Gebäudes an. Ein gültiger Wert ist ein gültiger aus zwei Buchstaben bestehender ISO 3166-1-Ländercode (z. B. AU für Australien) oder der entsprechende Anzeigename für das Land (der sich vom offiziellen Kurznamen der ISO 3166 Maintenance Agency unterscheiden kann).

Eine Referenz für zweistellige Ländercodes finden Sie unter Ländercodeliste.

Adressinformationen werden von der Places Seite Erkunden verwendet, um Gebäude in der Nähe anzuzeigen.

-Label (Kennzeichnung)

Der Parameter Label gibt eine beschreibende Bezeichnung für den Ort an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen ("). Die maximale Länge beträgt 200 Zeichen.

-GeoCoordinates

Der GeoCoordinates-Parameter gibt die Lage des Gebäudes in Breiten-, Längen- und (optional) Höhenkoordinaten an. Ein gültiger Wert für diesen Parameter verwendet eines der folgenden Formate:

• Breiten- und Längengrad: Beispiel: "47,644125;-122.122411"
• Breitengrad, Längengrad und Höhe: Beispiel: "47,644125;-122.122411; 161.432"

-DisplayName

Der DisplayName-Parameter gibt den Anzeigenamen des Orts an. Die maximale Länge beträgt 200 Zeichen.

Der Anzeigename eines Gebäudes ist sichtbar:

• Wenn Benutzer in Outlook ihre Arbeitszeiten und ihren Standort einrichten, können sie ein Gebäude auswählen.
• Auf Places Seite Erkunden, auf der angezeigt wird, wer sich im selben Gebäude, in der Nähe von Gebäuden und mehr befindet.
• In Places Finder als Filter bei der Suche nach einem Konferenzraum oder Arbeitsbereich.

Der Anzeigename einer Etage wird in Places Finder als Filter angezeigt, wenn nach einem Konferenzraum oder Arbeitsbereich gesucht wird.

-ParentId

Der Parameter ParentId gibt die ID eines Platzes in der übergeordneten Standorthierarchie in Microsoft Places an.

• Ein Raum sollte eine übergeordnete Etage oder einen übergeordneten Abschnitt haben.
• Ein Arbeitsbereich oder Schreibtisch sollte über einen übergeordneten Abschnitt verfügen.
• Ein Abschnitt sollte eine übergeordnete Etage aufweisen.
• Ein Stockwerk sollte ein Übergeordnetes Gebäude haben.

-Postal Code

Der Parameter PostalCode gibt die Postleitzahl des Gebäudes an. Die maximale Länge beträgt 200 Zeichen.

-ResourceLinks

Der ResourceLinks-Parameter gibt externe Links oder Teams-App-IDs an, die diesem Gebäude zugeordnet werden sollen, z. B. ein Menü für Restaurants, einen Link zu Diensten oder eine Teams-App für die Besucherverwaltung. Weitere Informationen zum Einrichten von Diensten in Places finden Sie unter Dienste in Places.

Der Wert muss als Array von Links bereitgestellt werden, wie in Beispiel 4 gezeigt. Jeder Link sollte die folgenden Eigenschaften enthalten: Name, Wert und Typ.  Beispielsweise würde ein Link als @{name="TestLink"; value="https://contoso.com/"; type="Url"} geschrieben werden.

• Name
  • Diese Zeichenfolge wird verwendet, um anzuzeigen, wie Ihr Link oder App-Name in der Places App angezeigt wird.
  • Die maximale Länge beträgt 200 Zeichen.
• Wert
  • Dieser Wert sollte entweder ein URL-Link oder eine Teams-App-ID sein. Teams-App-IDs finden Sie auf der Seite App-Details der App auf der Seite Apps verwalten im Teams Admin Center.
  • Die maximale Länge beträgt 1000 Zeichen.
• Typ muss einer der unterstützten Typen sein:
  • URL: Gibt an, dass es sich um einen URL-Link handelt.
  • MetaOsApp: Gibt an, dass dieser Link eine Teams-App ist.

-SortOrder

Der Parameter SortOrder gibt die Sortierreihenfolge der Etage an. Beispielsweise könnte eine Etage den Namen "Lobby" mit der Sortierreihenfolge 0 haben, um diese Etage zuerst in sortierten Listen anzuzeigen.

-Zustand

Der Parameter State gibt den Bundesstaat oder die Provinz des Gebäudes an. Die maximale Länge beträgt 200 Zeichen.

-Straße

Der Street-Parameter gibt die physische Adresse des Gebäudes an. Die maximale Länge beträgt 200 Zeichen.

-Schilder

Der Parameter Tags gibt weitere Features des Raums an (z. B. Details wie ansichts- oder möbeltyp). Derzeit gibt es keine maximale Länge.

Sie können mehrere Bezeichnungen angeben, die durch Kommas getrennt sind. Wenn die Bezeichnungen Leerzeichen enthalten, schließen Sie die Werte in Anführungszeichen ein: "Label 1","Label 2",..."Label N".

-Modus

Der Parameter Mode definiert, wie ein Ort verwendet oder gebucht werden soll. Derzeit ist der Modus nur für Schreibtische und Schreibtischpools (Arbeitsbereiche) verfügbar.

Derzeit gibt es insgesamt vier Modi.

• Reservable- Reservable Desks sind die Schreibtische, die so konfiguriert sind, dass sie im Voraus oder vor Ort gebucht werden.
• Drop-in: Der Schreibtisch steht vor Ort zur Verfügung und kann nicht im Voraus reserviert werden. Sie können die Funktion von Microsoft Teams verwenden, um die auf diesen Pulten vorhandenen Peripheriegeräte mit dem einzelnen Desk-Objekt im Verzeichnis zu verknüpfen.
• Zugewiesen : Ein zugewiesener Schreibtisch ist dauerhaft mit einem bestimmten Benutzer verknüpft und kann nicht von anderen gebucht werden. Jeder zugewiesene Schreibtisch muss immer über einen bestimmten Benutzer verfügen.
• Nicht verfügbar: Der Schreibtisch ist aufgrund von Wartungsarbeiten oder aus einem anderen Grund nicht für die Reservierung verfügbar.

Der Moduswert sollte die folgenden Eigenschaften enthalten: Name und Metadaten, wie in Beispiel 5 gezeigt. Name ist Zeichenfolge und Metadaten sind ein Wörterbuchobjekt.

• Name: Das Feld Name gibt den aktiven Modus für einen Ort an. Es wird ein Enumerationswert verwendet, und die verfügbaren Optionen variieren je nach Ortstyp. Zu den unterstützten Modi für Schreibtische gehören Reservable, AssignedDrop-Inund Unavailable. Für Schreibtischpools sind Reservabledie unterstützten Modi , Drop-In und Unavailable.

• Metadaten: Das Metadatenfeld ist ein Wörterbuch, das zum Speichern zusätzlicher Informationen verwendet wird, die für den ausgewählten Modus relevant sind. Diese Metadaten unterstützen Geschäftslogik, die an bestimmte Buchungsszenarien gebunden ist.

  • Places im Modus Reservable und Drop-In unterstützen keine Metadatenfelder.
  • Places im Modus "Nicht verfügbar" unterstützen ein Reason Feld (Zeichenfolge), das erklärt, warum der Schreibtisch nicht verfügbar ist. Die Werte umfassen New für neu erstellte Schreibtische und Maintenance für Places, die serviceiert werden.
  • Der zugewiesene Modus unterstützt zwei Metadatenfelder: AssignedPersonEmailAddress und AssignedPersonId. Diese identifizieren den Benutzer, der dem Schreibtisch zugewiesen ist. Die Angabe eines der beiden Felder reicht aus, um den zugewiesenen Modus zu aktivieren.

-Art

Der Type-Parameter gibt den Typ des Orts an, der erstellt wird. Gültige Werte sind:

• Gebäude
• Untergrenze
• Abschnitt
• Raum
• Arbeitsbereich
• Schreibtisch