New-SPOMigrationPackage
根據本機或網路共用資料夾中的來源檔案建立新的移轉封裝的 Cmdlet。
注意事項
此 Cmdlet 已被取代。 若要使用 PowerShell 移轉到 SharePoint 和 Microsoft 365，請參閱 使用 PowerShell 移轉到 SharePoint。
語法
Default (預設值)
New-SPOMigrationPackage
[-SourceFilesPath] <String>
[-OutputPackagePath] <String>
[[-TargetWebUrl] <String>]
[[-TargetDocumentLibraryPath] <String>]
[[-TargetDocumentLibrarySubFolderPath] <String>]
[-IncludeFileSharePermissions]
[-ReplaceInvalidCharacters]
[-IgnoreHidden]
[-NoLogFile]
[-NoAzureADLookup]
[<CommonParameters>]
Description
根據本機或網路共用資料夾中的來源檔案建立新的移轉封裝的 Cmdlet。
範例
範例 1
New-SPOMigrationPackage -SourceFilesPath \\fileserver\share\folder1 -OutputPackagePath d:\MigrationPackages\Folder1_SrcPkg
New-SPOMigrationPackage -SourceFilesPath \\fileserver\share\folder1 -OutputPackagePath d:\MigrationPackages\Folder1_SrcPkg -TargetWebUrl https://contoso.sharepoint.com/sites/TargetSite/TargetWeb -TargetDocumentLibraryPath "Shared Documents" -TargetDocumentLibrarySubFolderPath "Sub Folder/Target Folder"
此範例會根據在 \fileserver\share\folder1 來源位置中找到的內容檔案，使用預設 URL 值，在 d：\MigrationPackages\Folder1_SrcPkg 目錄中建立一組新的移轉來源套件中繼資料檔案。
範例 2
New-SPOMigrationPackage -SourceFilesPath \\fileserver\share\folder1 -OutputPackagePath d:\MigrationPackages\Folder1_SrcPkg -TargetWebUrl https://contoso.sharepoint.com/sites/TargetSite/TargetWeb -TargetDocumentLibraryPath "Shared Documents"
此範例會根據在 \fileserver\share\folder1 來源位置中找到的內容檔案，在 d：\MigrationPackages\Folder1_SrcPkg 目錄中建立一組新的移轉來源套件中繼資料檔案。 該包是使用文檔庫路徑“https://contoso.sharepoint.com/sites/TargetSite/TargetWeb/Shared Documents”準備的。
參數
-IgnoreHidden
適用對象：SharePoint Online
切換以忽略隱藏的檔案和資料夾。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-IncludeFileSharePermissions
適用對象：SharePoint Online
用來將權限和共用資訊併入至封裝中繼資料中產生的資訊清單檔。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NoAzureADLookup
適用對象：SharePoint Online
切換至不在 Microsoft Entra ID 中查閱本機使用者帳戶。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-NoLogFile
適用對象：SharePoint Online
用來表示不要建立記錄檔。 預設值就是在 OutputPackagePath 參數內指定的目錄內建立新的 CreateMigrationPackage 記錄檔。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-OutputPackagePath
適用對象：SharePoint Online
輸出封裝中繼資料檔案會儲存的目錄位置。 如果目錄不存在，將會建立目錄。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 1 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-ReplaceInvalidCharacters
適用對象：SharePoint Online
切換以取代檔案和資料夾名稱的字元 (在 SharePoint Online 中會無效的字元)。
參數屬性
| 類型: | System.Management.Automation.SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-SourceFilesPath
適用對象：SharePoint Online
來源內容檔所在的目錄位置。 將列舉這個目錄，以建立封裝中繼資料檔案。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TargetDocumentLibraryPath
適用對象：SharePoint Online
要在套件中繼資料內當成基底 URL 的文件庫部分使用的文件庫 (相對於 Web)。 如果未提供，則會在套件中繼資料中改用「文件」。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 3 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TargetDocumentLibrarySubFolderPath
適用對象：SharePoint Online
指定要在套件中繼資料內當成基底 URL 的資料夾路徑部分使用的子資料夾 (相對於文件庫)。 如果未提供，套件中繼資料內不會使用任何值。 檔案將以文件庫根目錄為主目錄。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 4 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-TargetWebUrl
適用對象：SharePoint Online
要在套件中繼資料內當成基底 URL 的網址部分使用的完整網址。 如果未提供，則套件中繼資料中會改用 “https://fileserver/sites/user” 。
參數屬性
| 類型: | System.String |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 2 |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數： -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊，請參閱 about_CommonParameters。
輸入
None
輸出
System.Object
備註
SPO 套件大小和檔案大小的限制
| 限制 | 大小上限 (GB) | 描述 |
|---|---|---|
| 包裝尺寸 | 2-4 | 整個套件不能超過 4Gb |
| 檔案大小 | 2 | 來源資料夾內的單一檔案不能超過 2 Gb。 |
| 目標大小 | - | 在移轉完成之前，終端使用者應該維持無法存取的目標網站 |
HTTP 取得的限制
| 限制 | API 取得 (字元) | 描述 |
|---|---|---|
| 在 API 上取得動作 | 260 個字元 | API GET 要求的大小不能超過 260 個字元 |