PowerShell 指令小程式設計用來管理在遷移管理員服務中執行的檔案分享遷移任務,以及下載掃描與遷移報告。
請參考此 連結 ,確保您的電腦符合系統需求。
開始之前
啟動遷移管理員檔案分享遷移:
- 安裝遷移管理員代理程式,然後用管理員帳號將它們連接到目的地租戶。
- 以管理員身份登入 SharePoint 管理員中心,然後進入遷移/檔案分享。
在這裡下載 PowerShell 壓縮檔,然後解壓到一個工作資料夾裡
使用 PowerShell 指令檔
以管理員身份啟動PowerShell
執行下列命令:
> Get-ChildItem -Path "working_folder" -Recurse | Unblock-File
> Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
關閉第一個 PowerShell 視窗,並以管理員身份啟動 PowerShell
執行下列命令:
> Import-Module "working_folder\Microsoft.SharePoint.MigrationManager.PowerShell.dll"
注意事項
在 Import-Module 指令檔中提供絕對檔案路徑。
連接遷移管理員服務
> Connect-MigrationService
此指令檔連接遷移管理員服務。 連線建立後,你可以新增遷移任務並開始遷移。
新增移轉工作
> Add-MigrationTask
使用這個指令小程式建立新的遷移任務。 建立後,任務會出現在遷移管理員頁面。
需要以下參數:
TaskName:指定遷移任務的名稱。
SourceUri:定義原始檔案路徑。
TargetSiteUrl:表示 SharePoint 的目的地網站 URL。
TargetListName:指定目的地 SharePoint 清單的名稱。
可選參數:
ScheduleStartTime:指定任務開始執行的時間。 預設情況下,任務會在你新增後立即開始。
AgentGroup: 指派一個代理群組執行任務。 預設情況下,會被分配「預設」群組。
標籤: 為任務分配標籤。 若要指派多個標籤,會使用分號來分隔標籤值。
輸出訊息:
「遷移任務會以任務 ID 為 taskId」建立,若該任務成功加入遷移服務。
「未能新增遷移任務。 errorMessage」,如果指令檔出錯。
欲獲得完整支援參數清單,請執行:
> Get-Help Add-MigrationTask -Full
取得遷移報告
> Get-MigrationReport
使用此指令小程式可根據指定參數取得已完成遷移任務的報告:
OutputPath:指定儲存產生報告的目錄路徑。
StartTime:篩選在指定日期和時間之後開始的遷移任務。
EndTime:篩選在指定日期和時間之前開始的遷移任務。
TaskNameContains:篩選名稱包含指定關鍵字的遷移任務。
標籤:過濾標籤與指定參數相同的遷移任務。 若給出超過標籤數,並以分號 (;) 分隔,則應回傳所有標籤與標籤相同任務。
狀態:過濾與指定參數狀態相同的遷移任務。 支援值為 完成 與 未完成。 預設情況下,已 完成 與 失敗 任務的報告會被下載。
若未指定參數,指令本會預設下載所有 已完成 與 失敗 報告。
輸出訊息:
如果下載了報告壓縮檔,每個任務都會顯示「任務已下載報告」 最後一個訊息是摘要行:「遷移報告下載完成,請檢查輸出資料夾: outputPath」
「未能下載遷移報告。 errorMessage」,如果指令檔出錯。
欲獲得完整支援參數清單,請執行:
> Get-Help Get-MigrationReport -Full
取得掃描報告
> Get-ScanReport
使用此 cmdlet 根據指定參數取得已完成掃描任務的報告
OutputPath:指定儲存產生報告的目錄路徑。
StartTime:篩選在指定日期和時間之後開始的遷移任務。
EndTime:篩選在指定日期和時間之前開始的遷移任務。
標籤:過濾標籤與指定參數相同的遷移任務。 若給出超過標籤數,並以分號 (;) 分隔,則應回傳所有標籤與標籤相同任務。
狀態:過濾與指定參數狀態相同的遷移任務。 支援的值為 Ready、 Warning 和 Error。 預設情況下,會下載「 準備遷移」、「 警告」和 「錯誤 」任務的報告。
若未指定參數,指令小程式預設下載所有 「準備遷移」、「 警告」及 「錯誤 」報告。
輸出訊息:
如果下載了報告壓縮檔,每個任務都會顯示「任務 Taskeid 的掃描日誌」。 最後一個訊息是摘要行「掃描日誌下載完成,請檢查輸出資料夾: outputPath」。
「掃描日誌下載失敗。 如果指令檔出錯,error_message」就要處理。
欲獲得完整支援參數清單,請執行:
> Get-Help Get-ScanReport -Full