Initialize-Places
Initialize-Places コマンドレットは、New-PlaceとSet-PlaceV3コマンドレットの代わりに使用できる、簡略化されたクイック作成エクスペリエンスです。
Initialize-Places は、テナント内の既存の部屋とワークスペースを解析し、建物、フロア、セクション名を推測します。 これにより、この情報を確認、編集した後、テナントの [建物] > [フロア] > [会議室とワークスペース] の完全な階層を構築できます。 この階層は、Places ディレクトリと呼ばれることもあります。
このページでは、コマンドレットの構文とオプションの詳細を提供します。 このコマンドレットを使用する詳細なガイドについては、「 建物とフロアの構成」を参照してください。
重要
重要な更新は、2024 年 11 月 14 日に MicrosoftPlaces コマンドレット モジュールに対して行われました。 その日付より前にプレビュー プログラムに参加した場合は、 Run Install-Module -Name MicrosoftPlaces -Forceを実行してモジュールの最新バージョンを取得し、PowerShell を閉じて再起動します。
構文
Initialize-Placesを実行すると、オプションの一覧が表示されます。
Initialize-Places
Please choose the desired option before continuing:
1. Export suggested mapping CSV of rooms to buildings/floors.
2. Import mapping CSV to automatically create buildings/floors and room mappings.
3. Export PowerShell script with commands to manually create buildings/floors and room mappings based on an imported CSV.
注意
PowerShell コマンドレットには追加のパラメーターが含まれている場合がありますが、現在サポートされていません。 このページに記載されていないパラメーターは使用しないことをお勧めします。
オプション 1
このオプションは、テナントで構成された会議室とワークスペースを解析し、ResourceAccountsMapped.csvという名前の CSV ファイル を 生成します。 この CSV ファイルには、建物、フロア、セクション名などの他のデータが含まれています。これは、会議室、職場、RoomList のデータから推測されます。
CSV ファイルには、roomList に関連付けられているExchange Onlineにある会議室とワークスペースのみが含まれており、Places ディレクトリのフロアまたはセクションにまだ親にされていません。
以下に例を示します。
roomList に関連付けられていないPlacesは CSV に含まれません。 これらのルームはルーム ファインダーには表示されず、後で手動で追加しない限り、Places Finder に表示されないように既定で除外されます。
2 つ以上の RoomList に関連付けられているPlacesが含まれます。 ただし、推論された建物名は空白のままです。 正しい建物名を書き込む必要があります。
Places既にフロアに親付けされているか、セクションが CSV に含まれていません。 新しい会議室とワークスペースがExchange Onlineに追加され、出力 CSV ファイルに新しい会議室とワークスペースのみを含める必要がある場合は、スクリプトを反復的に実行できます。
他の部屋とワークスペースをエクスポートする方法のガイダンスについては、「 建物とフロアの構成、手動セットアップ」を参照してください。
オプション 2
オプション 1 によって生成された会議室とワークスペースの情報が検証されたら、「 建物とフロアを構成 する」で説明されている不要な列を削除し、新しい CSV ファイルとして保存する必要があります。 これで、オプション 2 を使用して、この情報を Places ディレクトリに書き戻す準備ができました。
CSV ファイル内の新しい建物、フロア、またはセクションは、Places ディレクトリに追加され、新しい部屋と職場はフロア/セクションに親されます。
建物、都市、またはその他の条件を使用して、作業を分解できます。 この方法では、Places ディレクトリに追加する会議室と職場のサブセットを含む小さな CSV ファイルを反復的にアップロードできます。 Places ディレクトリにまだ存在しない新しい CSV ファイル、建物、フロア、セクションをアップロードするたびに、階層に追加されます。
CSV ファイルをアップロードすると、fileToImport-ImportResults.csvという名前 の ファイルが生成され、同じフォルダーに保存されます。 このファイルは、アップロード中に問題が発生したかどうかを示します。 この段階では、空間データの完全な階層がテナント内のMicrosoft Placesで使用できるようになります。
CSV ファイルをアップロードすると、建物の名前が Microsoft 365 エクスペリエンスで表示されるようになります。 実際には、これはユーザーがこれらの建物を見て選択できることを意味します。
作業計画 (Outlook の勤務時間と場所)
職場のプレゼンス
その他のエクスペリエンスについては、「Microsoft Places概要」を参照してください。
重要
各建物、フロア、セクションのスペルが CSV ファイル内で まったく同じ方法 であることを確認し、反復的にアップロードする場合は CSV ファイル間でスペルが設定されていることを確認します。 違いにより、追加の建物、フロア、またはセクションが作成されます。
オプション 3
この詳細オプションを使用すると、Places ディレクトリを実行する前に構成する PowerShell スクリプトを確認できます。 このオプションでは、PowerShell スクリプトはコンピューターにダウンロードされますが、実行されません。 オプション 3 は、複数のユーザー間で管理タスクを分離する必要がある場合に役立ちます。
PowerShell スクリプトは PlacesOnboardingScript.ps1 と呼ばれ、アップロードされた CSV ファイルと同じフォルダーに保存されます。 Places ディレクトリを構成するには、PowerShell スクリプトを手動で実行する必要があります。
注:
コマンドレットの説明では、オプション 3 の "import" という用語が不適切に使用されていますが、このオプションではPlaces ディレクトリに何も作成されません。 手動で実行する必要があるスクリプトのみが生成されます。
ファイル形式
エクスポートされたファイルのファイル形式 (オプション 1)
| 列名 | 説明 |
|---|---|
| InferredBuildingName | Microsoft Placesは、部屋/ワークスペースの建物プロパティと関連する部屋の一覧に基づいて、この部屋/ワークスペースの建物名であると思われるものを推測 (提案) しようとします。 この列は、インポート & 前に正しい値で更新されていることを確認する必要があります (オプション 2 または 3)。 |
| InferredFloorName | Microsoft Placesは、ルーム/ワークスペースの floorLabel プロパティと関連する会議室リストに基づいて、この部屋/ワークスペースのフロア名であると思われるものを推測 (提案) しようとします。 この列は、インポート & 前に正しい値で更新されていることを確認する必要があります (オプション 2 または 3)。 |
| InferredSectionName | Microsoft Placesは、ワークスペースのセクション名としてフロア名 (Inferred FloorName) を提案し、部屋の場合は空白のままにします。 インポートする前に、この列を正しい値で更新 & 確認する必要があります (オプション 2 または 3) |
| CurrentBuildingLabel | 会議室またはワークスペースのメタデータに設定されている 建物 の現在の文字列値 |
| CurrentFloorNumber | 会議室またはワークスペースのメタデータに設定されている フロア の現在の整数値 |
| CurrentFloorLabel | 会議室またはワークスペースのメタデータに設定されている floorLabel の現在の文字列値 |
| PrimarySmtpAddress | ルームまたはワークスペースの SMTP アドレス |
| 名前 | 会議室/ワークスペースの表示名 |
| RoomList | ルーム/ワークスペースの関連付けられている会議室の一覧 |
| ResourceType | リソースが Room または Space (ワークスペース) かどうかを定義します。 |
| StreetAddress | 部屋/ワークスペースの番地 |
| 市区町村 | 部屋/ワークスペースの都市 |
| StateOrProvince | ルーム/ワークスペースの状態/都道府県 |
| CountryOrRegion | ルーム/ワークスペースの国/地域 |
| Confidence | 推定された建物名の信頼度レベル、および推論されたフロア名 |
インポートに必要なファイル形式 (オプション 2、および 3)
インポートされたファイルには、次の 4 つの列のみが必要です。
| 列名 | 説明 |
|---|---|
| InferredBuildingName | (必須) この名前は、建物の作成時に使用されます |
| InferredFloorName | (必須) この名前は、フロアの作成時に使用されます。 |
| InferredSectionName | この名前は、セクション (フロア上のゾーンまたは近隣) を作成するときに使用されます。 この名前はワークスペースに必要ですが、会議室の場合は省略可能です。 |
| PrimarySmtpAddress | (必須) ルームまたはワークスペースの SMTP アドレス |