Initialize-Places
Cmdlet Initialize-Places 是簡化的快速建立體驗，可用來取代 New-Place、 和 Set-PlaceV3 Cmdlet。
Initialize-Places 會剖析租用戶中現有的會議室和工作區，並推斷建築物、樓層和區段名稱。 它可讓您驗證、編輯這項資訊，然後在租用戶中建置建築物>>樓層會議室和工作區的完整階層。 此階層有時稱為 Places Directory。
此頁面提供 Cmdlet 語法和選項的詳細數據。 設定 建築物和樓層中提供使用此 Cmdlet 的逐步指南。
重要事項
MicrosoftPlaces Cmdlet 模組已在 2024 年 11 月 14 日進行重要更新。 如果您在該日期之前加入預覽計劃，請執行 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 Cmdlet 中找到其他參數，但目前不支援這些參數。 不建議使用此頁面未記載的任何參數。
選項 1
此選項會剖析您租用戶中設定的會議室和工作區，併產生名為 ResourceAccountsMapped.csv的 CSV 檔案。 此 CSV 檔案包含從會議室、工作場所和 RoomList 數據推斷的其他數據，例如建築物、樓層和區段名稱。
CSV 檔案只包含與 RoomList 相關聯的 Exchange Online 中所找到的會議室和工作區，而且尚未在 Places Directory 中建立樓層或區段的父系。
例如：
Places 未與任何 RoomList 相關聯，則不會包含在 CSV 中。 這些會議室不會顯示在會議室尋找程式中，而且預設會排除這些會議室，以確保它們不會出現在 [Places Finder] 中，除非您稍後手動新增它們。
Places 包含與兩個以上的 RoomList 相關聯。 不過，推斷的建築物名稱會保留空白。 您必須以正確的建築物名稱撰寫。
Places 已上層至樓層，或 CSV 中未包含區段。 當新會議室和工作區新增至 Exchange Online 時，您可以反覆執行腳本，而輸出 CSV 檔案應該只包含新的會議室和工作區。
如需如何匯出其他會議室和工作區的指引，請參閱設定 建築物和樓層、手動設定。
選項 2
一旦驗證選項 1 所產生的房間和工作區信息之後，您應該移除不必要的數據行，如設定 建築物和樓層 中所述，並將其儲存為新的 CSV 檔案。 您現在已準備好使用選項 2 將此資訊寫回 Places 目錄。
在 CSV 檔案中找到的任何新建築物、樓層或區段都會新增至您的 Places 目錄，而新的會議室和工作場所則會父系至樓層/區段。
您可以藉由建置、城市或任何其他準則來細分工作。 這種方法可讓您反覆上傳較小的 CSV 檔案，其中包含您想要新增至 Places 目錄的會議室和工作場所子集。 每次上傳新的 CSV 檔案、建築物、樓層，以及不在您 Places 目錄中的區段，都會新增至階層。
上傳 CSV 檔案之後，會產生名為 fileToImport-ImportResults.csv 的檔案，並儲存到相同的資料夾中。 此檔案會記載上傳期間是否發生任何問題。 在這個階段，空間數據的完整階層可供租使用者中的 Microsoft Places 使用。
上傳 CSV 檔案會導致建築物名稱在 Microsoft 365 體驗中變成可見。 實際上，這表示用戶可以在 中查看並選擇這些建築物
工作計劃 (為 Outlook 工作時間和位置)
工作場所目前狀態
如 Microsoft Places 概觀中所述的其他體驗。
重要事項
如果您反覆上傳，請確定每個建築物、樓層和區段在 CSV 檔案和跨 CSV 檔案的 拼字方式完全相同 。 差異會導致建立額外的建築物、樓層或區段。
選項 3
此進階選項可讓您檢閱PowerShell腳稿，該腳本會先設定 Places目錄再執行它。 使用此選項時，PowerShell 腳本會下載到您的電腦，但不會執行。 如果您需要在多人之間分隔系統管理工作，選項 3 會很有用。
PowerShell 腳本稱為 PlacesOnboardingScript.ps1 ，並儲存在與上傳 CSV 檔案相同的資料夾中。 您必須手動執行 PowerShell 腳本來設定 Places 目錄。
注意事項
Cmdlet 描述不正確地使用選項 3 的「匯入」一詞，但此選項不會在您的 Places Directory 中建立任何專案。 它只會產生您需要手動執行的腳本。
檔案格式
匯出檔案的檔案格式 (選項 1)
| 欄名稱 | 描述 |
|---|---|
| InferredBuildingName | Microsoft Places 嘗試推斷 (根據會議室/工作區的建築物屬性和相關聯的會議室清單，建議) 此會議室/工作區的建築物名稱。 匯入選項 2 或 3) 之前，應該先檢閱此數據行 (& 以正確的值更新。 |
| InferredFloorName | Microsoft Places 嘗試推斷 (根據會議室/工作區的 floorLabel 屬性，以及相關聯的會議室清單，建議) 此會議室/工作區的樓層名稱。 匯入選項 2 或 3) 之前，應該先檢閱此數據行 (& 以正確的值更新。 |
| InferredSectionName | Microsoft Places 建議將樓層名稱 (InferredFloorName) 為工作區的區段名稱，並將會議室保留為空白。 匯入選項 2 或 3) 之前，應該先檢閱此數據行 (& 以正確的值更新 |
| CurrentBuildingLabel | 在會議室或工作區的元數據 上設定建 置的目前字串值 |
| CurrentFloorNumber | 會議室或工作區元數據上所設定之 樓層 的目前整數值 |
| CurrentFloorLabel | 會議室或工作區元數據上所設定 floorLabel 的目前字串值 |
| PrimarySmtpAddress | 會議室或工作區的 smtp 位址 |
| 名稱 | 會議室/工作區的顯示名稱 |
| RoomList | 會議室/工作區的相關聯會議室清單 |
| ResourceType | 定義資源是否為會議室或空間 (工作區) |
| StreetAddress | 會議室/工作區的街地道址 |
| 鄉/鎮/市/區 | 會議室/工作區的城市 |
| StateOrProvince | 會議室/工作區的州/省 |
| CountryOrRegion | 會議室/工作區的國家/地區 |
| Confidence | 推斷的建築物名稱和推斷樓層名稱的信賴等級 |
匯入選項 2 和 3 (所需的檔案格式)
匯入的檔案必須只有下列四個數據行：
| 欄名稱 | 描述 |
|---|---|
| InferredBuildingName | (必要) 建立建築物時會使用此名稱 |
| InferredFloorName | (必要) 建立樓層時會使用此名稱。 |
| InferredSectionName | 在樓層) (區域或鄰近地區建立區段時，會使用此名稱。 工作區需要此名稱，但對於會議室而言是選擇性的。 |
| PrimarySmtpAddress | (必要) 會議室或工作區的 smtp 位址 |