Set-PlaceV3

Set-PlaceV3 コマンドレットを使用して、Places ディレクトリ内のデスク、会議室、ワークスペース、セクション、フロア、または建物に関するメタデータを更新します。

構文

建物

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

Floor

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

Section

セクションは、フロア内のスペース (近傍など) のグループです。 デスクとワークスペースは、セクションに親として配置する必要があります。 必要に応じて、部屋をセクションに親にすることも、フロアに直接親にすることもできます。

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

机

デスクは、Microsoft Placesで新しく導入されたエンティティ型であり、個々のデスク ユニットを表します。 各デスクには、デスクの予約方法を指定する Mode プロパティが含まれています。 詳細については、以下のモードセクションを参照してください。

Desk の場合、モードとメールボックスの間には次のような依存関係があります。

• Mode プロパティが定義されていない場合、デスクは既定で [使用不可] に設定され、デスク メールボックスは自動的に作成されません。
• [予約可能] または [DropIn] モードに設定されているデスクの場合は、デスク メールボックスが必要です。 1 つは、デスクのプロビジョニング時に自動的に作成されます。 または、メールボックス パラメーターに EmailAddress を指定して、既存のメールボックスをリンクすることもできます。
• 割り当て済みまたは使用不可モードのデスクの場合、メールボックスのリンクは省略可能であり、既定ではメールボックスは作成されません。 ただし、必要に応じて、これらのデスクをカスタム メールボックスに手動で関連付けることができます。
• モードが最初に構成されていない場合、デスクは使用不可モードのままです。 メールボックスを後でリンクしても、デスクのモードは自動的に更新されません。

会議室やワークスペースの種類とは異なり、メールボックスを作成するだけでデスクが自動的にプロビジョニングされるわけではありません。 さらに、容量や DisplayName などのメタデータはメールボックスのプロパティと同期されません。 メールボックスは主に予約エンジンによって使用され、メタデータは Places ディレクトリから読み取られます。

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

Room

Set-PlaceV3 では、Exchange Set-Place コマンドレットで既に使用できる従来の場所パラメーターがサポートされています。 ただし、 -ParentId パラメーターを使用して部屋がフロアまたは建物にリンクされたら、個々の部屋やワークスペースではなく、建物レベルで場所の詳細 (Street と City) を管理する必要があります。

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

ワークスペース

Set-PlaceV3 では、Exchange Set-Place コマンドレットで既に使用できる従来の場所パラメーターがサポートされています。 ただし、 -ParentId パラメーターを使用してワークスペースがセクションにリンクされたら、場所の詳細 (Street と City) は、個々の部屋やワークスペースではなく、建物レベルで管理する必要があります。

ワークスペースでは、Mode プロパティがサポートされています。 その詳細については、「パラメーター」セクション Mode 記載されています。

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

説明

Placesは、部屋/ワークスペース、フロア、および建物の間で完全に設定された階層に依存します。 建物とフロアが作成されたら、parentId を使用してそれらをリンクできます。 部屋には親フロアまたはセクションが必要です。 ワークスペースまたはデスクには親セクションが必要です。 セクションには親フロアが必要です。 フロアには親の建物が必要です。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 Exchange 管理 ロールまたは Places TenantPlacesManagement ロールが必要です。

例

例 1

次の使用例は、部屋、フロア、および建物のディレクトリ階層を設定します。

この例では、フロアの PlaceId は f12172b6-195d-4e6e-8f4f-eb72e41de99a で、建物の PlaceId は 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

例 2

この例では、建物の住所を更新します。

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

例 3

次の使用例は、建物の地理座標を更新します。

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

例 4

次の使用例は、リソース リンクを使用して建物のリソース リンクを更新します。 更新時にセット全体が置き換えられます。 値を追加または削除するには、保存する必要がある以前の値を必ず含めます。

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

例 5

この例では、メールボックスの詳細を指定せずに、セクションの下に予約可能なデスクを作成します。 デスク メールボックスが自動的に作成され、リンクされ、MailboxOID プロパティが設定されます。 デスクはPlaces Finder に表示され、誰でも予約できます。

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

例 6

次の使用例は、モード値を DropIn モードに更新します。

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

例 7

次の使用例は、モード値を [割り当て済みモード] に更新します。

デスクが既に割り当てられたモード デスクである場合でも、変更はメタデータ フィールドのみであることに注意してください。 新しいモード オブジェクト全体を作成し、古いオブジェクトを置き換える必要があります。

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

パラメーター

-Identity

ID パラメーターは、更新する場所を指定します。 場所を一意に識別する任意の値を使用できます。

たとえば、メールボックス (会議室とワークスペース) に基づく場所の場合は、次のようになります。

• 名前 [非推奨]
• エイリアス [非推奨]
• 識別名 (DN) [非推奨]
• 正規 DN [非推奨]
• GUID [非推奨]
• 電子メール アドレス

たとえば、メールボックス (建物、フロア、セクション、デスク) に基づいていない場所の場合は、次のようになります。

• Name
• GUID

-AudioDeviceName、および -VideoDeviceName

これらのパラメーターは、ルーム内のオーディオ デバイスとビデオ デバイスの名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

既定値はブランク ($null) です。 このルームにオーディオまたはビデオ デバイスがないことを示すには、パラメーターに$null値を使用します。

-建物

Building パラメーターは、部屋の建物名または建物番号を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

-能力

Capacity パラメーターは、会議室またはワークスペースの容量を指定します。 有効な値は整数です。

-都市

City パラメーターは、建物の都市を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。 最大長は 200 文字です。

-CountryOrRegion

CountryOrRegion パラメーターは、建物の国または地域を指定します。 有効な値は、有効な ISO 3166-1 の 2 文字の国コード (オーストラリアの場合は AU など) または国の対応するフレンドリ名 (公式の ISO 3166 メンテナンスエージェンシーの短い名前とは異なる場合があります) です。

2 文字の国コードのリファレンスは、 国コード一覧で入手できます。

-Label

Label パラメーターは、場所のわかりやすいラベルを指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。 最大長は 200 文字です。

会議室とワークスペースの場合、コマンドは Exchange Set-Place の -Label という名前の値を更新します。

-DisplayDeviceName

DisplayDeviceName パラメーターは、場所 (会議室、デスク、またはワークスペース) 内のディスプレイ デバイスの名前を指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

既定値はブランク ($null) です。 この場所にディスプレイ デバイスがないことを示すには、このパラメーターに$null値を使用します。

-FloorLabel

FloorLabel パラメーターは、フロアの説明ラベルを指定します。 値にスペースが含まれている場合は、値を二重引用符 (") で囲んでください。

-床

Floor パラメーターは、特定の建物内のフロアの並べ替え順序を指定します。

-GeoCoordinates

GeoCoordinates パラメーターは、緯度、経度、(必要に応じて) 高度座標で建物の位置を指定します。 このパラメーターの有効な値は、次のいずれかの形式を使用します。

• 緯度と経度: たとえば、"47.644125;-122.122411"
• 緯度、経度、高度: "47.644125;-122.122411;161.432"

ピリオド区切り記号が機能しない場合は、代わりにコンマを使用します。

-IsWheelChairAccessible

IsWheelChairAccessible パラメーターは、場所が車椅子でアクセスできるかどうかを指定します。 有効な値は次のとおりです。

• $true:場所は車椅子でアクセス可能です。
• $false: 場所は車椅子でアクセスできません。 これは既定の値です。

-MTREnabled

MTREnabled パラメーターは、Microsoft Teams ルーム システムで構成された部屋を識別します。 Teams ルーム システムは、会議室を含む Teams 会議のオーディオ ソースとして追加できます。 有効な値は次のとおりです。

• $true: 会議室には Teams ルーム システムがあります。 会議室のオーディオを使用して会議に参加することを選択するときに、Teams 会議室システムを会議Microsoft Teamsに追加できます。
• $false: 会議室には Teams ルーム システムがありません。 ユーザーは、会議室のオーディオを使用する代わりに、PC またはモバイル デバイスのオーディオを使用して Teams 会議に参加できます。 これは既定の値です。

Microsoft Teams Roomsの詳細については、「Microsoft Teams Rooms」を参照してください。

-DisplayName

DisplayName パラメーターは、場所の表示名を指定します。 最大長は 200 文字です。 SMTP アドレスが関連付けられている会議室またはワークスペースの場所の表示名を更新するには、場所管理者、Exchange 管理者、またはグローバル 管理 ロールが必要です。

-ParentId

ParentId パラメーターは、Microsoft Placesの親場所階層の Place の ID を指定します。 部屋には親フロアまたはセクションが必要です。 ワークスペースまたはデスクには親セクションが必要です。 セクションには親フロアが必要です。 フロアには親の建物が必要です。

-PostalCode

PostalCode パラメーターは、建物の郵便番号を指定します。

-ResourceLinks

ResourceLinks パラメーターは、ダイニング メニュー、サービスへのリンク、訪問者管理用 の Teams アプリ など、この建物に関連付ける必要がある外部リンクまたは Teams アプリ ID を指定します。 Placesでサービスを設定する方法の詳細については、「Placesのサービス」を参照してください。

値は、 例 4 に示すように、リンクの配列として指定する必要があります。 各リンクには、Name、Value、Type の各プロパティが含まれている必要があります。 たとえば、リンクは @{name="TestLink"; value="https://contoso.com/"; type="Url"} として書き込まれます。

• 名前

  • この文字列は、Places アプリでのリンクまたはアプリ名の表示方法を示すために使用されます。

  • 最大長は 200 文字です。

• 値

  • この値は、URL リンクまたは Teams アプリ ID である必要があります。 Teams アプリ ID は、Teams 管理センターの [アプリの管理] ページにあるアプリの [ アプリ の詳細] ページにあります。

  • 最大長は 1,000 文字です。

• 型 は、サポートされている型のいずれかである必要があります。

  • Url - これが URL リンクであることを示します。

  • MetaOsApp - このリンクが Teams アプリであることを示します。

-SortOrder

SortOrder パラメーターは、フロアの並べ替え順序を指定します。 たとえば、並べ替え順序が 0 の "ロビー" という名前のフロアは、順序付きリストで最初にこのフロアを表示します。

-状態

State パラメーターは、建物の状態または都道府県を指定します。 最大長は 200 文字です。

-通り

Street パラメーターは、建物の物理アドレスを指定します。 最大長は 200 文字です。

-モード

Mode パラメーターは、場所を使用または予約する方法を定義します。 現時点では、モードはデスクとデスク プール (ワークスペース) でのみ使用できます。

現在、合計で 4 つのモードがあります。

• 予約可能 - 予約可能なデスクは、事前または現場で予約できるように構成されたデスクです。
• 立ち寄り- デスクはオンザスポットで利用でき、事前の予約はできません。 Microsoft Teamsの機能を使用して、これらのデスクに存在する周辺機器をディレクトリ内の個々のデスク オブジェクトにリンクできます。
• 割り当て済み - 割り当てられたデスクは、特定のユーザーに永続的にリンクされ、他のユーザーが予約することはできません。 割り当てられたすべてのデスクには、常に指定されたユーザーが必要です。
• 利用不可 - メンテナンスのため、またはその他の理由により、デスクは予約できません。

モード値には、 例 6 に示すように、Name プロパティと Metadata プロパティが含まれている必要があります。 名前は文字列で、メタデータはディクショナリ オブジェクトです。

• 名前: [名前] フィールドは、場所のアクティブ モードを指定します。 列挙値が使用され、使用可能なオプションは場所の種類によって異なります。 デスクの場合、サポートされているモードには、 Reservable、 DropIn、 Assigned 、 Unavailableが含まれます。 デスク プールの場合、サポートされるモードは Reservable、 DropIn 、および Unavailableです。

• メタデータ: [メタデータ] フィールドは、選択したモードに関連する追加情報を格納するために使用されるディクショナリです。 このメタデータは、特定の予約シナリオに関連付けられたビジネス ロジックをサポートします。

  • 予約可能モードと DropIn モードのPlacesでは、メタデータ フィールドはサポートされていません。
  • 使用不可モードのPlacesでは、デスクが使用できない理由を説明するReason フィールド (文字列) がサポートされます。 値には、新しく作成されたデスクのNewと、サービスを受けるPlacesのMaintenanceが含まれます。
  • 割り当てモードでは、 AssignedPersonEmailAddress と AssignedPersonIdの 2 つのメタデータ フィールドがサポートされます。 これにより、デスクに割り当てられたユーザーが識別されます。 割り当てられたモードを有効にするには、いずれかのフィールドを指定するだけで十分です。

-タグ

Tags パラメーターは、部屋の追加機能 (たとえば、ビューの種類や家具の種類など) を指定します。 現在、最大長はありません。

複数のラベルをコンマで区切って指定できます。 ラベルにスペースが含まれている場合は、値を引用符で囲みます: "Label 1","Label 2",..."Label N"。

トラブルシューティング

アクセス許可拒否エラーが発生しています。

Set-PlaceV3 には、TenantPlacesManagement、GlobalAdmin、または MailRecepients のいずれかのロールが必要です。 ロールはさまざまな方法で割り当てられるため、ロールのアクセス許可を割り当てるためにサポートされている方法は次のとおりです。

• アクセス許可が Exchange 管理 Center を通じて割り当てられている場合 (永続的なアクセス許可のみがサポートされます)、Places コマンドレットの使用に問題はありません。 [アクセス許可が拒否されました] エラーが表示されることはありません。
• 権限が Entra を介してユーザーに直接 (永続的または一時的なロールとして) 割り当てられている場合は、Places コマンドレットの使用に問題はありません。 [アクセス許可が拒否されました] エラーが表示されることはありません。 ただし、Entra と Exchange の間の同期に若干の遅延が生じる可能性があります。
• ユーザーが参加している Entra 内のグループに Entra を通じてアクセス許可が割り当てられている場合、これは Exchange ではサポートされていないため、ロールスルー グループは尊重されません。 Exchange コマンドレットとPlaces コマンドレットはどちらもアクセス許可が拒否され、失敗します。 この予期される動作については、 こちらを参照してください。

ParentId をリソースに割り当てたが、Places Finder にはまだ表示されない。

リソースとその親 Floor の間の相関関係がPlacesエクスペリエンスに表示されるまでに最大 24 時間かかることがあります。 この遅延の解消に取り組んでいます。

リソースに写真を設定操作方法?

Set-UserPhoto は 2024 年 4 月に 非推奨 となりました。 Set-PlaceV3 を使用する場合は、このコマンドレットにパラメーターを追加して、会議室とワークスペースに写真を設定します。 その間、 次の手順 に従って、部屋またはワークスペースに写真を設定してください。

現在、建物やフロアに写真を設定することはできません。