Set-PlaceV3

Verwenden Sie das Cmdlet Set-PlaceV3, um Metadaten zu Ihren Schreibtischen, Räumen, Arbeitsbereichen, Abschnitten, Etagen oder Gebäuden in Ihrem Places-Verzeichnis zu aktualisieren.

Syntax

Gebäude

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-Label]
 [-IsWheelChairAccessible]
 [-GeoCoordinates]
 [-Phone]
 [-Street]
 [-City]
 [-State]
 [-PostalCode]
 [-CountryOrRegion]
 [-ResourceLinks]

Untergrenze

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-SortOrder]

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.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]

Schreibtisch

Desks sind ein neu eingeführter Entitätstyp in Microsoft Places, der einzelne Schreibtischeinheiten darstellt. Jeder Schreibtisch verfügt über eine Mode-Eigenschaft, die angibt, wie der Schreibtisch gebucht werden kann. Weitere Informationen finden Sie im Abschnitt modus weiter unten.

Für Desk gibt es einige Abhängigkeiten zwischen Modus und Postfach wie folgt:

• Wenn die Mode-Eigenschaft nicht definiert ist, wird der Schreibtisch standardmäßig auf Nicht verfügbar festgelegt, und es wird kein Deskpostfach automatisch erstellt.
• Für Schreibtische, die auf den Modus Reservable oder DropIn festgelegt sind, ist ein Schreibtischpostfach erforderlich. Eine wird automatisch erstellt, wenn der Schreibtisch bereitgestellt wird. Alternativ können Sie ein vorhandenes Postfach verknüpfen, indem Sie die EmailAddress im Parameter Mailbox angeben.
• Für Schreibtische im Modus Zugewiesen oder Nicht verfügbar ist das Verknüpfen eines Postfachs optional, und es wird standardmäßig kein Postfach erstellt. Sie können diese Schreibtische jedoch bei Bedarf benutzerdefinierten Postfächern manuell zuordnen.
• Wenn anfänglich kein Modus konfiguriert ist, verbleibt der Schreibtisch im Modus Nicht verfügbar. Durch das anschließende Verknüpfen eines Postfachs wird der Modus des Schreibtischs nicht automatisch aktualisiert.

Im Gegensatz zu Raum- oder Arbeitsbereichstypen werden Schreibtische nicht automatisch durch einfaches Erstellen eines Postfachs bereitgestellt. Darüber hinaus werden Metadaten wie Capacity oder DisplayName nicht mit Postfacheigenschaften synchronisiert. Das Postfach wird hauptsächlich von der Reservierungs-Engine verwendet, während Metadaten aus dem Places Directory gelesen werden.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-IsWheelChairAccessible]
 [-DisplayDeviceName]
 [-Tags]
 [-Mailbox]
 [-Mode]

Raum

Set-PlaceV3 unterstützt Legacyspeicherortparameter, die bereits im Exchange Set-Place-Cmdlet verfügbar sind. Sobald ein Raum jedoch mithilfe des -ParentId Parameters mit einer Etage oder einem Gebäude verknüpft ist, sollten die Standortdetails (Street und City) auf Gebäudeebene verwaltet werden – nicht auf dem einzelnen Raum oder Arbeitsbereich.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]

Arbeitsbereich

Set-PlaceV3 unterstützt Legacyspeicherortparameter, die bereits im Exchange Set-Place-Cmdlet verfügbar sind. Sobald ein Arbeitsbereich jedoch mithilfe des -ParentId Parameters mit einem Abschnitt verknüpft ist, sollten die Standortdetails (Street und City) auf Gebäudeebene verwaltet werden– nicht auf dem einzelnen Raum oder Arbeitsbereich.

Der Arbeitsbereich unterstützt die Mode-Eigenschaft. Die Details dazu sind im Mode Parameterabschnitt dokumentiert.

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Tags]
 [-Mode]

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.

Beispiele

Beispiel 1

In diesem Beispiel wird die Verzeichnishierarchie für einen Raum, eine Etage und ein Gebäude eingerichtet.

In diesem Beispiel lautet die PlaceId des Bodens f12172b6-195d-4e6e-8f4f-eb72e41de99a, und die PlaceId des Gebäudes lautet 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

Beispiel 2

In diesem Beispiel wird die Adresse eines Gebäudes aktualisiert.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -CountryOrRegion US -State WA -City Redmond -Street 'Street 3' -PostalCode 98052

Beispiel 3

In diesem Beispiel werden die Geokoordinaten eines Gebäudes aktualisiert.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -GeoCoordinates "47.644125;-122.122411"

Beispiel 4

In diesem Beispiel werden die Ressourcenlinks für ein Gebäude mit Ressourcenlinks aktualisiert. 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.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -ResourceLinks @{name="TestLink";value="https://contoso.com/";type="Url"}

Beispiel 5

In diesem Beispiel wird ein reservierbarer Schreibtisch unter einem Abschnitt ohne Angabe von Postfachdetails erstellt. 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 6

In diesem Beispiel wird der Wert des Modus in den DropIn-Modus aktualisiert.

Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a -Mode @{Name='DropIn'}

Beispiel 7

In diesem Beispiel wird der Moduswert in Zugewiesener Modus aktualisiert.

Beachten Sie, dass die Änderung nur das Metadatenfeld ist, auch wenn der Schreibtisch bereits zugewiesen ist. Ein ganz neues Modusobjekt muss erstellt werden und das alte ersetzen.

$modemetadata = New-Object 'System.Collections.Generic.Dictionary[String,object]'
$modemetadata.Add("AssignedPersonEmailAddress","someUserEmailAddress")
Set-PlaceV3 -Identity f12172b6-195d-4e6e-8f4f-eb72e41de99a Mode @{Name='Assigned';Metadata=$modemetadata}

Parameter

-Identity

Der Identity-Parameter gibt den Ort an, den Sie aktualisieren möchten. Sie können einen beliebigen Wert verwenden, der einen Ort eindeutig identifiziert.

Beispielsweise für Orte, die auf einem Postfach basieren (Konferenzräume und Arbeitsbereiche):

• Name [veraltet]
• Alias [veraltet]
• Distinguished Name (DN) [veraltet]
• Kanonische DN [veraltet]
• GUID [veraltet]
• E-Mail-Adresse

Beispielsweise für Orte, die nicht auf einem Postfach basieren (Gebäude, Etagen, Abschnitte und Schreibtische):

• Name
• GUID

-AudioDeviceName und -VideoDeviceName

Diese Parameter geben den Namen der Audio- und Videogeräte im Raum an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Der Standardwert ist leer ($null). Um anzugeben, dass dieser Raum über kein Audio- oder Videogerät verfügt, verwenden Sie den Wert $null für den Parameter.

-Gebäude

Der Parameter Building gibt den Gebäudenamen oder die Gebäudenummer an, in dem sich der Raum befindet. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

-Fassungsvermögen

Der Kapazitätsparameter gibt die Kapazität des Raums oder Arbeitsbereichs an. Ein gültiger Wert ist eine ganze Zahl.

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

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

Für Räume und Arbeitsbereiche aktualisiert der Befehl den Wert -Label in Exchange Set-Place.

-DisplayDeviceName

Der Parameter DisplayDeviceName gibt den Namen des Anzeigegeräts am Ort an (Raum, Schreibtisch oder Arbeitsbereich). Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

Der Standardwert ist leer ($null). Um anzugeben, dass dieser Ort über kein Anzeigegerät verfügt, verwenden Sie den Wert $null für diesen Parameter.

-FloorLabel

Der FloorLabel-Parameter gibt eine beschreibende Bezeichnung für den Boden an. Wenn der Wert Leerzeichen enthält, setzen Sie ihn in Anführungszeichen (").

-Boden

Der Floor-Parameter gibt die Sortierreihenfolge des Bodens in einem bestimmten Gebäude an.

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

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

-IsWheelChairAccessible

Der Parameter IsWheelChairAccessible gibt an, ob der Ort für Rollstuhlfahrer zugänglich ist. Gültige Werte sind:

• $true: Der Platz ist für Rollstuhlfahrer zugänglich.
• $false: Der Platz ist nicht für Rollstuhlfahrer zugänglich. Dies ist der Standardwert.

-MTREnabled

Der MTREnabled-Parameter identifiziert den Raum, der mit einem Microsoft Teams-Raumsystem konfiguriert wurde. Sie können Teams-Raumsysteme als Audioquellen in Teams-Besprechungen hinzufügen, die den Raum betreffen. Gültige Werte sind:

• $true: Der Raum verfügt über ein Teams-Raumsystem. Sie können das Teams-Raumsystem zu Microsoft Teams-Besprechungen hinzufügen, wenn Sie sich für die Teilnahme an einer Besprechung mit Raumaudio auswählen.
• $false: Der Raum verfügt nicht über ein Teams-Raumsystem. Benutzer können an Teams-Besprechungen mit ihrem PC- oder Mobilgerät-Audio teilnehmen, anstatt Raumaudio zu verwenden. Dies ist der Standardwert.

Weitere Informationen zu Microsoft Teams-Räume finden Sie unter Microsoft Teams-Räume.

-DisplayName

Der DisplayName-Parameter gibt den Anzeigenamen des Orts an. Die maximale Länge beträgt 200 Zeichen. Um den Anzeigenamen eines Raums oder Arbeitsbereichs mit einer zugeordneten SMTP-Adresse zu aktualisieren, benötigen Sie die Rolle "Platzadministrator", "Exchange-Administrator" oder "Globaler Admin".

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

-ResourceLinks

Der Parameter ResourceLinks 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 1.000 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.

-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 6 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, AssignedDropInund Unavailable. Für Schreibtischpools sind Reservabledie unterstützten Modi , DropIn 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 in den Modi Reservable und DropIn 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.

-Schilder

Der Parameter Tags gibt zusätzliche 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".

Problembehandlung

Ich erhalte einen Berechtigungsverweigerungsfehler.

Set-PlaceV3 erfordert eine der folgenden Rollen: TenantPlacesManagement, GlobalAdmin oder MailRecepients. Da Rollen auf unterschiedliche Weise zugewiesen werden können, werden die folgenden Möglichkeiten zum Zuweisen von Rollenberechtigungen unterstützt:

• Wenn die Berechtigung über Exchange Admin Center zugewiesen wird (das nur permanente Berechtigungen unterstützt), sollten Sie keine Probleme mit der Verwendung der Places-Cmdlets haben. Es wäre nicht zu erwarten, dass Sie den Fehler Berechtigung verweigert sehen.
• Wenn die Berechtigung über Entra direkt dem Benutzer zugewiesen wird (als permanente oder temporäre Rolle), sollten Sie keine Probleme mit der Verwendung der Places-Cmdlets haben. Es wäre nicht zu erwarten, dass Sie den Fehler Berechtigung verweigert sehen. Es kann jedoch zu einer gewissen Verzögerung bei der Synchronisierung zwischen Entra und Exchange kommen.
• Wenn die Berechtigung über Entra einer Gruppe in Entra zugewiesen wird, zu der der Benutzer gehört, wird dies von Exchange nicht unterstützt, und die rollenbasierte Gruppe wird nicht berücksichtigt. Exchange-Cmdlets und Places-Cmdlets schlagen fehl, wenn die Berechtigung verweigert wird. Dieses erwartete Verhalten wird hier beschrieben.

Ich habe einer Ressource eine ParentId zugewiesen, aber sie wird noch nicht in Places Finder angezeigt.

Es kann bis zu 24 Stunden dauern, bis die Korrelation zwischen der Ressource und ihrem übergeordneten Floor in Places Erfahrungen angezeigt wird. Wir arbeiten daran, diese Verzögerung zu beseitigen.

Gewusst wie ein Foto für eine Ressource festlegen?

Die Set-UserPhoto wurde im April 2024 eingestellt . Wir arbeiten daran, diesem Cmdlet einen Parameter hinzuzufügen, um ein Foto in Räumen und Arbeitsbereichen festzulegen, wenn Set-PlaceV3 verwendet wird. Befolgen Sie in der Zwischenzeit diese Anweisungen , um das Foto in einem Raum oder Arbeitsbereich festzulegen.

Es ist derzeit nicht möglich, Fotos auf einem Gebäude oder auf einer Etage zu setzen.