Site.CreateMigrationJob 方法
這個方法會建立新的移轉匯入作業並將它佇列打造稍後可以處理個別計時器工作。工作會使用這個方法中指定的 Azure Blob 儲存體容器位於的正確格式 （預先定義的格式） 匯入套件。移轉工作處理的服務等級協定 (SLA) 透過預先設定的佇列和工作負載節流設定]，控制並沒有任何保證的 SLA 或寄送出的工作時間。
命名空間: Microsoft.SharePoint.Client
組件： Microsoft.SharePoint.Client.Silverlight (在 Microsoft.SharePoint.Client.Silverlight.dll 中); Microsoft.SharePoint.Client.Phone (在 Microsoft.SharePoint.Client.Phone.dll 中) Microsoft.SharePoint.Client (在 Microsoft.SharePoint.Client.dll 中)
語法
'宣告
Public Function CreateMigrationJob ( _
gWebId As Guid, _
azureContainerSourceUri As String, _
azureContainerManifestUri As String, _
azureQueueReportUri As String _
) As ClientResult(Of Guid)
'用途
Dim instance As Site
Dim gWebId As Guid
Dim azureContainerSourceUri As String
Dim azureContainerManifestUri As String
Dim azureQueueReportUri As String
Dim returnValue As ClientResult(Of Guid)
returnValue = instance.CreateMigrationJob(gWebId, _
azureContainerSourceUri, azureContainerManifestUri, _
azureQueueReportUri)
public ClientResult<Guid> CreateMigrationJob(
Guid gWebId,
string azureContainerSourceUri,
string azureContainerManifestUri,
string azureQueueReportUri
)
參數
gWebId
類型：System.Guid目的地網頁套件匯入的唯一識別碼。 匯入封裝本身中指定的其他資訊和匯入的識別碼。查詢目標網站使用 SharePoint 的用戶端 API，並可以以程式設計方式找到此識別碼。
azureContainerSourceUri
類型：System.String有效的 URL，包括 SA 權杖存取含有的二進位檔案類型區塊的 Azure Blob 儲存容器。必須以僅限讀取建立 SA 權杖，清單權限] 或 [移轉工作會失敗。SA 權杖應有 （至少） 為單位的週期不得晚於時工作提交，直到合理的時間已經過了歸納出成功匯入的開頭。
azureContainerManifestUri
類型：System.String有效的 URL，包括 SA 權杖存取其中包含的資訊清單或其他 XML 檔案描述套件區塊 blob Azure Blob 儲存容器。此位置也可用於記錄輸出。此容器無法用於azureContainerSourceUri相同。SA 權杖必須以建立僅限讀取、 清單和寫入權限或移轉工作會失敗。SA 權杖至少必須為單位的週期不得晚於時工作提交，直到合理的時間已經過了成功匯入至歸納出開始。
azureQueueReportUri
類型：System.String有效的 URL，包括 SA 權杖，來存取使用者提供 Azure 佇列中所用的移轉工作進度通知。此值可以是空值，如果通知佇列不會用來匯入期間。如果此值不是空值，在此 URI SA 權杖中授與適當的存取，它將會用於即時狀態更新。
傳回值
類型：Microsoft.SharePoint.Client.ClientResult<Guid>
如果工作已順利在佇列中，或如果不成功，會傳回 null 值，則傳回的移轉工作的唯一識別碼。您可以取得使用此唯一識別碼和GetMigrationJobStatus方法將工作狀態。 您可以刪除使用此識別碼和DeleteMigrationJob方法的移轉工作。
備註
azureContainerSourceUri中指定的容器必須擁有下列權限: (SharedAccessBlobPermissions.Read |SharedAccessBlobPermissions.List).
容器中的所有檔案都必須至少單一快照集套用到它們，以確保檔案修改可以匯入期間發生的客戶。匯入期間會略過任何沒有快照的檔案，錯誤就會擲回，雖然會繼續進行匯入作業。匯入管線會一次匯入的使用中的檔案最新的快照。建立檔案的快照上, 傳至 Azure Blob 儲存體之後，您可以使用的程式碼範例如下 ︰
CloudBlockBlob blob = blobContainerObj.GetBlockBlobReference(file);
blob.UploadFromStream(stm);
blob.CreateSnapshot()
指定azureContainerManifestUri容器中的所有檔案都必須至少單一快照集套用到它們，以確保檔案修改可以匯入期間發生的客戶。沒有快照任何檔案會導致失敗匯入期間，就會擲回錯誤，可能會導致失敗的整個的移轉工作。
佇列中azureQueueReportUri指定應該擁有下列權限: (SharedAccessQueuePermissions.Add |SharedAccessQueuePermissions.Read |SharedAccessQueuePermissions.Update) 一旦接受，作業識別碼會寫入通知佇列中如果所提供，access 會有效。通知佇列中可用的多個的移轉工作同時，為每項工作會識別傳送回通知佇列中的值。
範例
Guid MigrationJobId = TargetSite.CreateMigrationJob(
TargetWebId,
azureContainerSourceUri,
azureContainerManifestUri,
azureQueueReportUri);