Freigeben über

New-Place

  • Artikel

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

Hinweis

Zum Erstellen von Räumen oder Arbeitsbereichen müssen Sie weiterhin das hier dokumentierte Cmdlet New-Mailbox verwenden .

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 Gruppierung von Räumen innerhalb einer Etage, z. B. einer Nachbarschaft. Schreibtische und Arbeitsbereiche müssen einem Abschnitt zugeordnet werden. Räume können optional auch einem Abschnitt zugeordnet werden, oder sie können direkt zu einer Etage übergeordnet werden.

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

Schreibtisch

Schreibtische sind ein neuer Entitätstyp in Places, die einzelne Schreibtische darstellen. Diese Objekte können entweder buchbar oder nicht buchbar sein (Standardeinstellung).

Damit ein Schreibtisch buchbar ist, müssen Sie ein Desk-Postfach erstellen und es dem Desk-Objekt zuordnen, indem Sie das Postfach Alias an den Mailbox Parameter von Set-PlaceV3übergeben. Beachten Sie, dass Schreibtische im Gegensatz zu den Raum-/Arbeitsbereichstypen nicht implizit bereitgestellt werden, indem das Postfach allein erstellt wird. Außerdem werden die Metadaten (z. B. die Capacity Felder oder DisplayName ) nicht mit Postfachmetadaten synchronisiert. Postfach ist in erster Linie nur für die Reservierungs-Engine erforderlich, und Metadaten werden aus Places Directory gelesen.

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

Beschreibung

Places hängt von einer vollständig eingerichteten Hierarchie zwischen Ihren Räumen/Arbeitsbereichen, Etagen und Gebäuden ab. Nachdem Gebäude und Etagen erstellt wurden, können Sie sie mit parentId verknüpfen. 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.

Bevor Sie dieses Cmdlet ausführen können, müssen Ihnen die entsprechenden Berechtigungen zugewiesen werden. Sie müssen entweder über die Rolle Exchange Admin oder Places TenantPlacesManagement verfügen.

Achtung

Möglicherweise finden Sie zusätzliche Parameter im PowerShell-Cmdlet, die derzeit jedoch nicht unterstützt werden. Es wird nicht empfohlen, Parameter zu verwenden, die auf dieser Seite nicht dokumentiert sind.

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 Abschnitt erstellt, der einem Stockwerk zugeordnet ist, und dann ein Schreibtischpostfach erstellt und es einer vorhandenen Schreibtischentität zugewiesen. Beachten Sie, dass Sie das Modul installiert haben ExchangeOnlineManagement und das Connect-ExchangeOnline Cmdlet ausführen, bevor Sie dieses Beispielskript ausführen.

$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

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.

Attribut Beschreibung
Typ: String
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

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

Attribut Beschreibung
Typ: CountryInfo
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

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

Attribut Beschreibung
Typ: String
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: Wahr
Platzhalterzeichen akzeptieren: False

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

Hinweis

Wenn Punkttrennzeichen für Sie nicht funktionieren, verwenden Sie stattdessen Kommas.

Attribut Beschreibung
Typ: GeoCoordinates
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

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

Attribut Beschreibung
Typ: String
Standardwert: Keine
Erforderlich: Wahr
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

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

Hinweis

Wenn Sie Abwärtskompatibilität mit Outlook Roomfinder benötigen, sollten Sie auch die Eigenschaften "Floor"/"FloorLabel" aktualisieren, indem Sie den Raum parallel zur Entität floor übergeordnet haben. Places Finder verwendet die neue Hierarchie, während Outlook Roomfinder weiterhin die Legacyobjekte "Floor" und "FloorLabel" verwendet. Sie müssen auch sicherstellen, dass der Raum einer Raumliste zugeordnet ist, wie hier beschrieben : Konfigurieren von Räumen und Arbeitsbereichen für die Raumsuche in Outlook.

Attribut Beschreibung
Typ: String
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-Postal Code

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

Attribut Beschreibung
Typ: String
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

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

Hinweis

Der gesamte Satz wird ersetzt. Um einen Wert hinzuzufügen oder zu entfernen, müssen Sie vorherige Werte einschließen, die beibehalten werden sollen.

Attribut Beschreibung
Typ: ResourceLink[]
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

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

Attribut Beschreibung
Typ: System.Int32
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-Zustand

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

Attribut Beschreibung
Typ: String
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-Straße

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

Attribut Beschreibung
Typ: String
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

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

Hinweis

Der gesamte Satz wird beim Update ersetzt. Um einen Wert hinzuzufügen oder zu entfernen, müssen Sie vorherige Werte einschließen, die beibehalten werden sollen.

Attribut Beschreibung
Typ: String
Position: Benannt
Standardwert: Keine
Erforderlich: False
Pipelineeingabe akzeptieren: False
Platzhalterzeichen akzeptieren: False

-Art

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

  • Gebäude
  • Untergrenze
  • Abschnitt
  • Schreibtisch
Attribut Beschreibung
Typ: String
Position: Benannt
Standardwert: Keine
Erforderlich: Wahr
Pipelineeingabe akzeptieren: Wahr
Platzhalterzeichen akzeptieren: False