次の方法で共有

New-Place

  • [アーティクル]

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

注:

会議室またはワークスペースを作成するには、ここに記載されている New-Mailbox コマンドレットを引き続き使用する必要 があります。

構文

建物

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]

机

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

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

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

説明

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

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

注意

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

例

例 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

次の使用例は、フロアに親付きのセクションを作成し、デスク メールボックスを作成し、既存のデスク エンティティに割り当てます。 このサンプル スクリプトを実行する前に、 ExchangeOnlineManagement モジュールがインストールされ、 Connect-ExchangeOnline コマンドレットが実行されていることに注意してください。

$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

パラメーター

-都市

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

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

-CountryOrRegion

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

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

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

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

-Label

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

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

-GeoCoordinates

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

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

注:

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

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

-DisplayName

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

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

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

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

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

-ParentId

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

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

注:

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

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

-PostalCode

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

属性 説明
種類: 文字列
立場： と言う
既定値: なし
必須: 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 アプリであることを示します。

注:

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

属性 説明
種類: ResourceLink[]
立場： と言う
既定値: なし
必須: 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

-Type

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

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