New-Place

New-Place コマンドレットを使用して、Places ディレクトリ内に建物、フロア、セクション、会議室、ワークスペース、またはデスクを作成します。

構文

建物

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

Floor

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

Section

セクションは、近傍などのフロア内のスペースの論理的なグループです。

• デスクとワークスペースはセクションに属している必要があります。
• 部屋は、セクションに割り当てることも、フロアに直接関連付けることもできます。

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

Room

会議室を作成すると、関連付けられているメールボックスが自動的にプロビジョニングされます。 Mailbox パラメーターに EmailAddress を指定すると、その名前で新しいメールボックスが作成され、会議室にリンクされます。

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

ワークスペース

ワークスペース (デスク プール) を作成すると、関連付けられているメールボックスが自動的にプロビジョニングされます。 Mailbox パラメーターに EmailAddress を指定すると、その名前で新しいメールボックスが作成され、ワークスペースにリンクされます。

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

机

デスクは個別のデスク ユニットを表します。 各デスクには、その使用方法を定義する Mode プロパティがあります。

• 予約可能 – 事前にご予約いただけます。
• Drop-In – オンザスポットでのみ使用できます。
• 割り当て済み – 特定のユーザーに割り当てられます。
• 利用不可 – 予約できません。

デスク モードとメールボックスは次のように動作します。

• 既定の動作: Mode が定義されていない場合、デスクは既定で [使用不可] に設定されます。 メールボックスは作成されません。
• 予約可能モードまたは DropIn モード: デスク メールボックスが必要です。 デスクがプロビジョニングされると自動的に作成されるか、既存のデスクにリンクできます。
  • メールボックス パラメーターに既存の EmailAddress を指定した場合、デスクはそのメールボックスにリンクします。
  • 存在しない EmailAddress を指定すると、その名前で新しいメールボックスが作成され、デスクにリンクされます。
  • EmailAddress が指定されていない場合、メールボックスはシステムによって生成された名前で自動作成され、デスクにリンクされます。
• 割り当て済みモードまたは使用不可モード: メールボックスのリンクは省略可能であり、メールボックスは作成されません。 ただし、必要に応じて、これらのデスクをカスタム メールボックスに手動で関連付けることができます。
• 後でモードを変更する: デスクが使用不可モードで起動し、メールボックスがリンクされていない場合は、Set-PlacesV3 コマンドレットを使用してデスクを予約可能に切り替えると、メールボックスが自動的に作成およびリンクされます。 ただし、メールボックスをデスクにリンクしても、デスクのモードは自動的に更新されません。

会議室やワークスペースとは異なり、デスクは容量や DisplayName などのメタデータをメールボックスのプロパティと同期しません。 メールボックスは主に予約エンジンによって使用され、メタデータは Places ディレクトリから読み取られます。

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

説明

Microsoft Placesには、建物、フロア、セクション、部屋、ワークスペース、デスクの完全な階層が必要です。

• フロアは建物に属している必要があります。
• セクションはフロアに属している必要があります。
• 部屋はフロアまたはセクションに属している必要があります。
• ワークスペースまたはデスクはセクションに属している必要があります。

ParentId プロパティを使用して、エンティティをリンクします。

このコマンドレットを実行するには、次のいずれかの役割が必要です。Places管理者、Exchange 管理者、または TenantPlacesManagement アクセス許可を持つカスタム ロールです。

例

例 1

次の使用例は、その建物内に新しい建物とフロアを作成します。

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

建物 3 が正常に作成されたら、床に ParentId を設定するときに使用する PlaceId を読み取ります。

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

例 2

この例では、住所情報を含む新しい建物を作成します。

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

例 3

この例では、リソース リンクを含む新しい建物を作成します。

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

例 4

次の使用例は、メールボックスの詳細を指定せずに、セクションを親にして容量 10 の新しい会議室を作成します。 会議室メールボックスが自動的に作成され、リンクされます。

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

例 5

次の使用例は、セクションの親となる新しい会議室を作成し、メールボックスの詳細を指定します

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

例 6

次の使用例は、セクションに親される新しいワークスペース (デスク プール) を作成し、メールボックスの詳細を指定します

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

例 7

この例では、メールボックスの詳細を指定せずに、セクションを親にして予約可能なデスクを作成します。 デスク メールボックスが自動的に作成され、リンクされ、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'}

例 8

次の使用例は、セクションに親として予約可能なデスクを作成し、メールボックスを提供します。 メールボックスが存在する場合、デスクはそれにリンクします。それ以外の場合は、指定された名前で新しいデスク メールボックスが自動的に作成されます。

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

例 9

次の使用例は、セクションに親として割り当てられたモード デスクを作成し、それを人に割り当てます。 割り当てられたユーザーのみがこのデスクを使用できます。 他のユーザーは予約できなくなります。

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

パラメーター

-都市

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

-CountryOrRegion

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

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

住所情報は、[Places探索] ページで近くの建物を表示するために使用されます。

-Label

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

-GeoCoordinates

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

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

-DisplayName

DisplayName パラメーターは、場所の表示名を指定します。 最大長は 200 文字です。

建物の表示名が表示されます。

• Outlook では、ユーザーが勤務時間と場所を設定すると、建物を選択できます。
• [Places探索] ページで、同じ建物、近くの建物など、他のユーザーを表示します。
• Places Finder で、会議室またはワークスペースを検索するときのフィルターとして。

会議室またはワークスペースを検索するときに、フロアの表示名がフィルターとしてPlaces Finder に表示されます。

-ParentId

ParentId パラメーターは、Microsoft Placesの親場所階層の Place の ID を指定します。

• 部屋には親フロアまたはセクションが必要です。
• ワークスペースまたはデスクには親セクションが必要です。
• セクションには親フロアが必要です。
• フロアには親の建物が必要です。

-PostalCode

PostalCode パラメーターは、建物の郵便番号を指定します。 最大長は 200 文字です。

-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 文字です。

-タグ

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

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

-モード

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

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

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

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

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

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

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

-Type

Type パラメーターは、作成する場所の型を指定します。 有効な値は次のとおりです。

• 建物
• Floor
• Section
• Room
• ワークスペース
• 机