安裝學校資料同步處理工具組

重要:  本文係由機器翻譯而成,請參閱免責聲明。本文的英文版本請見這裡,以供參考。

您可以使用學校資料同步處理工具組驗證您的 CSV 檔案並檢查錯誤、從 PowerShell 執行手動 CSV 同步,以及自動化 CSV 同步處理流程來滿足您的需求。

本主題內容:

安裝 Microsoft 學校資料同步處理工具組

  1. Microsoft 學校資料同步處理工具組下載工具。

  2. 按兩下工具以執行精靈。

  3. 在 [歡迎] 頁面上,選擇 [下一步]。

    在 Microsoft 學校資料同步處理工具組安裝的 [歡迎] 頁面上選擇 [下一步]
  4. 接受授權合約 > 按一下 [下一步],選擇安裝路徑,然後選擇 [下一步]。

    選擇 Microsoft 學校資料同步處理工具組的安裝路徑
  5. 選擇 [安裝] > [完成]。

學校資料同步處理工具組功能

當您完成工具組安裝後,您的初始設定檔會在學校資料同步處理入口網站中建立完畢,而您可以使用下列指令碼定期或視需求上傳其他 CSV 檔案。安裝程式可讓您從電腦上的系統管理 PowerShell 工作階段執行多個 Cmdlet,藉此協助您順利部署學校資料同步處理。請參閱下節了解各個 Cmdlet 的描述及使用案例。

使用學校資料同步處理工具組驗證 CSV 檔案資料 (同步處理之前)

若要在上傳要同步處理的 CSV 檔案之前,先使用工具組驗證檔案,請以系統管理員身分開啟 PowerShell,並按照下列語法及範例所述,使用 Start-CsvFilesValidation Cmdlet。

Start-CsvFilesValidation 語法

使用 Start-CsvFilesValidation Cmdlet 驗證特定同步處理設定檔的 CSV 檔案。

Start-CsvFilesValidation -CsvFolderPath <String> -ProfileName <String> -UserName <String>

參數

描述

CsvFolderPath

含有 CSV 檔案的資料夾路徑。

ProfileName

您在學校資料同步處理中建立、且要驗證 CSV 檔案的設定檔名稱。

UserName

具有 Office 365 租用戶全域系統管理員權限的系統管理員帳戶使用者名稱。

以下範例將進行 CSV 檔案的用戶端驗證:檔案位於本機電腦的 c:\temp 目錄中,設定檔名稱為 “School 1”,且使用全域系統管理帳戶 admin@contoso.com。

Start-CsvFilesValidation –CsvFolderPath “c:\temp” –ProfileName “School 1” –UserName admin@contoso.com

使用學校資料同步處理工具組同步處理 CSV 檔案

若要使用學校資料同步處理上傳及同步處理 CSV 檔案,請以系統管理員身分開啟 PowerShell,然後按照下列語法與範例所述,使用 Send-CsvFiles Cmdlet。

Send-CsvFiles 語法

使用 Send-CsvFiles Cmdlet 上傳及同步處理特定同步處理設定檔的 CSV 檔案。

Send-CsvFiles -CsvFolderPath <String> -ProfileName <String> -UserName <String>

參數

描述

CsvFolderPath

含有 CSV 檔案的資料夾路徑。

ProfileName

您在學校資料同步處理中建立、且要驗證 CSV 檔案的設定檔名稱。

UserName

具有 Office 365 租用戶全域系統管理員權限的系統管理員帳戶使用者名稱。

以下範例將上傳及同步處理多個 CSV 檔案:檔案位於本機電腦的 c:\temp 目錄中,設定檔名稱為 “School 1”,且使用全域系統管理帳戶 “admin@contoso.com”。

Send-CsvFiles –CsvFolderPath “c:\temp” –ProfileName “School 1” –UserName “admin@contoso.com”

使用學校資料同步處理工具組設定自動化 CSV 同步處理

您可以在本機儲存的 CSV 檔案與 Office 365 中的 SDS 同步處理設定檔之間排程自動化同步處理。若要這麼做,請以系統管理員身分開啟 PowerShell,然後按照下列語法與範例所述,使用 Add-CsvFileSyncTask Cmdlet。排程的工作完成後,您可以在工作排程器中檢閱新建的已排程工作,藉此監控這些自動化同步處理的進度與記錄。除非您使用下列參數來修改開始時間,否則這項已排程工作會在每天午夜執行。

當您執行此命令時,系統會提示您進行驗證。第一則驗證提示將需要您輸入全域系統管理認證,且提示將會在使用者名稱參數底下包含您在下方命令中所指定的使用者名稱。密碼輸入完畢並按一下 Enter 之後,您會收到第二則基本驗證提示。您將在這則提示中輸入本機系統管理員使用者名稱及密碼,這組帳號密碼將做為每天執行已排程工作時所用的認證。如果您包含了 StoreCredentials 參數,本機系統管理員帳戶認證將會儲存在 [認證管理員] 中,在密碼變更以前會持續運作。如果您尚未指定 StoreCredentials 參數,您將會獲得存留期最長達 90 天的驗證權杖。驗證權杖到期,且無法在執行已排程工作時進行驗證後,系統就會要求您再次執行命令。

Add-CsvFileSyncTask 語法

使用 Add-CsvFileSyncTask Cmdlet 上傳及同步處理特定同步處理設定檔的 CSV 檔案。

Add-CsvFileSyncTask -CSVFolderPath <path to csv file location> -ProfileName <name of sync profile in SDS> -LogPath <path to store logs> -UserName <global admin account> -Validate -RedirectOutput

參數

描述

CSVFolderPath

包含定期同步處理的 CSV 檔案的資料夾路徑。

ProfileName

您要同步處理 CSV 檔案的 SDS 同步處理設定檔名稱。

UserName

要搭配 SDS 使用的全域系統管理員帳戶的 UserPrincipalName。

LogPath

您想要儲存驗證記錄檔的目錄路徑。

RedirectOutput

將允許驗證參數的輸出結果寫入指定的目錄。如果您要檢閱驗證參數的結果,此為必要參數。

Validate

在每次同步處理之前執行驗證工作。如果您還加入了 RedirectOutput 參數,系統就會在 Logpath 目錄中建立檔案。

TaskUserName

已排程工作的名稱。

TaskStartTime

已排程工作將開始的時間。

StoreCredentials

在認證管理員中建立項目,以執行已排程的工作。除非與這個帳戶關聯的密碼到期,否則認證始終有效並持續運作。

以下範例將針對 CSV 檔案建立已排程的自動化同步處理工作:檔案位於 C:\temp 資料夾,且同步處理設定檔名稱為 SDSSync,系統將在 C:\temp\logs 資料夾中建立驗證記錄檔,並將 C:\temp\SDS\Logs 目錄設為產生所有記錄檔的位置。此外,這項命令會先執行 CSV 檔案的驗證程序,再開始同步處理,並會將驗證輸出結果儲存在相同的 c:\temp\logs 目錄中。

Add-CsvFileSyncTask -CSVFolderPath “C:\temp” -ProfileName “SDSSync” -LogPath “C:\temp\logs” -UserName admin@contoso.com -Validate -RedirectOutput

使用學校資料同步處理工具組轉換 OneRoster CSV 檔案

您可以使用工具組來轉換 OneRoster CSV 檔案,並將它們與學校資料同步處理進行同步處理。若要這麼做,請以系統管理員身分開啟 PowerShell,然後按照下列語法與範例所述,使用 Convert-OneRostertoMicrosoftSDS Cmdlet。轉換完成後,您可以再按照我們的標準 CSV 同步處理指導方針,透過 SDS 同步處理這些 CSV 檔案。

Convert-OneRostertoMicrosoftSDS 語法

使用 Convert-OneRostertoMicrosoftSDS Cmdlet 上傳及同步處理特定設定檔的 CSV 檔案。

Convert-OneRostertoMicrosoftSDS -OneRosterFolderPath <String> -SDSFolderPath <String> -LogPath <String>

參數

描述

OneRosterFolderPath

包含從 OneRoster 匯出的 CSV 檔案的資料夾路徑。

SDSFolderPath

包含已建立的已轉換 CSV 檔案的資料夾路徑。

LogPath

您希望記錄這些動作的記錄檔所在的資料夾路徑。

以下範例將轉換多個 OneRoster CSV 檔案:檔案位於 C:\temp\OneRoster 資料夾中,且將在本機電腦的 C:\temp\SDS 目錄中建立一組新的 CSV 檔案,並將 C:\temp\SDS\Logs 目錄設為產生所有記錄檔的位置。

Convert-OneRostertoMicrosoftSDS -OneRosterFolderPath “C:\temp\OneRoster” -SDSFolderPath “C:\temp\SDS” -LogPath “C:\temp\SDS\logs”

使用學校資料同步處理工具組驗證 CSV 檔案資料 (同步處理之後)

若要在上傳及同步處理一組 CSV 檔案之後,使用工具組驗證 CSV 檔案,請以系統管理員身分開啟 PowerShell,並按照下列語法及範例所述,使用 Compare-DirectoryToCSVFiles Cmdlet。

Compare-DirectoryToCSVFiles 語法

使用 Compare-DirectoryToCSVFiles Cmdlet 驗證特定同步處理設定檔的 CSV 檔案。

Compare-DirectoryToCSVFiles -CsvFolderPath <String> -ProfileName <String> -UserName <String>

參數

描述

CsvFolderPath

含有 CSV 檔案的資料夾路徑。

ProfileName

您在學校資料同步處理中建立、且要驗證 CSV 檔案的設定檔名稱。

UserName

具有 Office 365 租用戶全域系統管理員權限的系統管理員帳戶使用者名稱。

以下範例將進行 CSV 檔案的用戶端驗證:檔案位於本機電腦的 c:\temp 目錄中,設定檔名稱為 “School 1”,且使用全域系統管理帳戶 “admin@contoso.com”。

Compare-DirectoryToCsvFiles –CsvFolderPath “c:\temp” –ProfileName “School 1” –UserName “admin@contoso.com”

附註: 機器翻譯免責聲明︰本文係以電腦系統翻譯而成,未經人為介入。Microsoft 提供此等機器翻譯旨在協助非英語系使用者輕鬆閱讀 Microsoft 產品、服務及技術相關內容。基於本文乃由機器翻譯而成,因此文中可能出現詞辭、語法、文法上之錯誤。

請參閱

學校資料同步處理與教室概觀

學校資料同步處理的 CSV 檔案

PowerSchool 同步處理所需的學校資料同步處理屬性

如何使用 CSV 檔案部署學校資料同步處理

如何使用 PowerSchool 同步處理部署學校資料同步處理

如何使用 Clever 同步處理部署學校資料同步處理

如何使用 OneRoster CSV 檔案部署學校資料同步處理

學校資料同步處理錯誤與疑難排解

擴展您的技能
探索訓練
優先取得新功能
加入 Office 測試人員

這項資訊有幫助嗎?

感謝您的意見反應!

感謝您的意見反應! 我們將協助您與其中一位 Office 支援專員連絡以深入了解您的意見。

×