Set-PlaceV3

[アーティクル]
10/30/2024

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

注:

会議室へのUpdates & ワークスペースの反映には最大 24 時間かかることがあります。複数の会議室とワークスペースをオンボードする必要がある場合は、変更を強制的にすぐに反映できる Initialize-Placesを使用することをお勧めします。
Set-UserPhoto は 2024 年 4 月に非推奨となりました。 Set-PlaceV3 を使用する場合は、このコマンドレットにパラメーターを追加して、会議室とワークスペースに写真を設定します。その間、次の手順に従って、部屋またはワークスペースに写真を設定します。

構文

建物

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

Floor

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

Section

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

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

机

デスクは、個々のデスクを表すPlacesの新しいエンティティ型です。これらのオブジェクトは、予約可能でも予約不可でもかまいません (既定値)。

デスクを予約可能にするには、デスクメールボックスを作成し、メールボックス Aliasを Set-PlaceV3 の Mailbox パラメーターに渡して、デスクオブジェクトに関連付ける必要があります。会議室/ワークスペースの種類とは異なり、デスクはメールボックスを単独で作成することによって暗黙的にプロビジョニングされないことに注意してください。また、メタデータ ( Capacity や DisplayName フィールドなど) はメールボックスメタデータと同期されません。メールボックスは主に予約エンジンにのみ必要であり、メタデータは Places Directory から読み取られます。

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-Name]
 [-Tags]
 [-Mailbox]

会議室またはワークスペース

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

Set-PlaceV3
 [-Identity]
 [-DisplayName]
 [-ParentId]
 [-Label]
 [-Capacity]
 [-IsWheelChairAccessible]
 [-AudioDeviceName]
 [-DisplayDeviceName]
 [-VideoDeviceName]
 [-MTREnabled]
 [-GeoCoordinates]
 [-Phone]
 [-Street]
 [-City]
 [-State]
 [-PostalCode]
 [-CountryOrRegion]
 [-Building]
 [-Floor]
 [-FloorLabel]
 [-Tags]

説明

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

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

注意

PowerShell コマンドレットには追加のパラメーターが含まれている場合がありますが、現在サポートされていません。このページに記載されていないパラメーターは使用しないことをお勧めします。

例

例 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

この例では、デスクメールボックスを作成し、既存のデスクエンティティに割り当てます。次を実行する前に、モジュール ExchangeOnlineManagement インストールし、 Connect-ExchangeOnline コマンドレットを実行する必要があることに注意してください。

$mbx = New-Mailbox -Room <DeskMailboxName>
Set-Mailbox $mbx.Identity -Type Desk -HiddenFromAddressListsEnabled $true
Set-PlaceV3 {DeskId} -Mailbox $mbx.Alias

パラメーター

-Identity

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

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

名前
Alias
識別名 (DN)
正規 DN
電子メールアドレス
GUID

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

名前
GUID

属性	説明
種類:	RecipientIdParameter
立場：	0
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	はい
ワイルドカード文字を受け入れます。	False

-AudioDeviceName、-DisplayDeviceName、VideoDeviceName

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

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

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-建物

重要

ビルドパラメーターは非推奨であり、下位互換性のみを目的としてここで提供されています。建物情報は、部屋またはワークスペースの親チェーンにある Building エンティティから読み取られます。

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

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-能力

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

属性	説明
種類:	System.Int32
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-都市

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

会議室/ワークスペースではなく、建物の場所データを管理することをお勧めします。部屋 -> 階 -> 建物の間には階層があり、部屋は建物の場所属性を継承します。

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-CountryOrRegion

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

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

属性	説明
種類:	CountryInfo
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-Label

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

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

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	はい
ワイルドカード文字を受け入れます。	False

-DisplayDeviceName

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

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

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-FloorLabel

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

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-床

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

属性	説明
種類:	System.Int32
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-GeoCoordinates

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

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

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

会議室/ワークスペースではなく、建物の場所データを管理することをお勧めします。部屋 -> 階 -> 建物の間には階層があり、部屋のは建物の場所属性を継承します。

属性	説明
種類:	GeoCoordinates
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-IsWheelChairAccessible

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

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

属性	説明
種類:	ブール型
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-MTREnabled

注:

現時点では、このパラメーターは情報提供のみを行っており、追加機能はありません。

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

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

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

属性	説明
種類:	ブール型
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-DisplayName

DisplayName パラメーターは、場所の表示名を指定します。最大長は 200 文字です。 Set-PlaceV3 は、建物やフロアなど、SMTP アドレスが関連付けられていない場所の名前のみを更新できます。会議室やワークスペースなどの SMTP アドレスが関連付けられている場所の表示名を更新するには、 Exchange Set-Mailbox コマンドレットを使用します。

属性	説明
種類:	文字列
既定値:	なし
必須:	はい
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-ParentId

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

注:

Outlook Roomfinder との下位互換性が必要な場合は、"Floor"/"FloorLabel" プロパティも、ルームを floor エンティティに親化するのと並行して更新してください。 Places Finder は新しい階層を使用し、Outlook Roomfinder では従来の "Floor" オブジェクトと "FloorLabel" オブジェクトを使用します。「Outlook で会議室とワークスペースを構成する」で説明されているように、会議室が Roomlist に関連付けられていることも確認する必要があります。

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-PostalCode

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

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-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 アプリであることを示します。

注:

セット全体は更新時に置き換えられます。値を追加または削除するには、保存する必要がある以前の値を必ず含めます。

属性	説明
種類:	Link[]
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-SortOrder

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

属性	説明
種類:	System.Int32
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-状態

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

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-通り

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

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

-タグ

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

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

注:

セット全体は更新時に置き換えられます。値を追加または削除するには、保存する必要がある以前の値を必ず含めます。

属性	説明
種類:	文字列
立場：	と言う
既定値:	なし
必須:	False
パイプライン入力を受け入れる:	False
ワイルドカード文字を受け入れます。	False

トラブルシューティング

アクセス許可拒否エラーを受け取っています。

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 を使用する場合は、このコマンドレットにパラメーターを追加して、会議室とワークスペースに写真を設定します。その間、次の手順に従って、部屋またはワークスペースに写真を設定してください。

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

次の方法で共有