命名空间：microsoft.graph
重要
Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。
表示将源组织中的特定用户迁移到目标组织所需的参数。 使用 POST 创建新的迁移任务时，必须指定此资源。
继承自 sharePointMigrationTaskParameters。
属性
| 属性 | 类型 | 说明 |
|---|---|---|
| preferredLatestStartDateTime | DateTimeOffset | 首选的最新开始日期和时间。 如果此时未启动 sharePointMigrationTask ，系统将取消它。 该值必须大于 preferredStartDateTime（如果存在）。 可选。 仅在 OneDrive 和 SharePoint 上。 继承自 sharePointMigrationTaskParameters。 |
| preferredStartDateTime | DateTimeOffset | 允许 sharePointMigrationTask 在未来开始的首选开始日期和时间，而不是尽快 (默认) 。 可选。 仅在 OneDrive 和 SharePoint 上。 继承自 sharePointMigrationTaskParameters。 |
| sourceUserIdentity | userIdentity | 源租户中的源用户，包括用户对象 ID 和用户主体名称。 |
| sourceSiteUrl | String | 源网站的 SharePoint URL。 可选。 必须指定 sourceSiteId 或 sourceUrl 之一。 如果同时指定或两者均未指定，则为错误。 仅在 OneDrive 和 SharePoint 上。 继承自 sharePointMigrationTaskParameters。 |
| targetDataLocationCode | String | 在 Microsoft Entra 中，此值表示地理位置 (例如 ， JPNNAM) 目标组织必须迁移资源以确保数据驻留和符合性。 单地理位置目标组织或迁移到多地理位置目标组织的默认 GEO 时，不需要此属性。 可选。 仅在 OneDrive 和 SharePoint 上。 继承自 sharePointMigrationTaskParameters。 |
| targetGroupIdentity | groupIdentity | 目标租户中目标组的标识，包括其邮件昵称。 |
| targetOrganizationHost | String | 目标组织的特定多地理位置实例的根、管理员或我的站点主机，必须迁移资源以确保数据驻留和符合性。 单地理位置目标组织或迁移到多地理位置目标组织的默认 GEO 时，不需要此属性。 可选。 仅在 OneDrive 和 SharePoint 上。 继承自 sharePointMigrationTaskParameters。 |
| targetOrganizationId | Guid | 源资源必须迁移到的目标组织的唯一Microsoft Entra公司 ID。 仅在 OneDrive 和 SharePoint 上。 继承自 sharePointMigrationTaskParameters。 |
| targetSiteUrl | String | 目标网站的 SharePoint URL。 仅在 OneDrive 和 SharePoint 上。 继承自 sharePointMigrationTaskParameters。 |
| targetUserIdentity | userIdentity | 目标租户中的目标用户，包括用户对象 ID 和用户主体名称。 |
| validateOnly | 布尔值 | 指示此任务是实际迁移还是仅验证。 如果缺少 参数，系统会将其视为 false。 默认行为是实际迁移。 可选。 仅在 OneDrive 和 SharePoint 上。 继承自 sharePointMigrationTaskParameters。 |
关系
无。
JSON 表示形式
以下 JSON 表示形式显示了资源类型。
{
"@odata.type": "#microsoft.graph.sharePointUserMigrationTaskParameters",
"preferredLatestStartDateTime": "String (timestamp)",
"preferredStartDateTime": "String (timestamp)",
"sourceSiteUrl": "String",
"sourceUserIdentity": {"@odata.type": "microsoft.graph.userIdentity"},
"targetDataLocationCode": "String",
"targetOrganizationHost": "String",
"targetOrganizationId": "Guid",
"targetSiteUrl": "String",
"targetUserIdentity": {"@odata.type": "microsoft.graph.userIdentity"},
"validateOnly": "Boolean"
}