Set-SPOTenantSyncClientRestriction

控制特定于同步文件的租户范围选项和限制。

语法

Blocking

Set-SPOTenantSyncClientRestriction
    [-Enable]
    [-DomainGuids <String>]
    [-BlockMacSync]
    [<CommonParameters>]

FileExclusion

Set-SPOTenantSyncClientRestriction
    [-ExcludedFileExtensions <String>]
    [<CommonParameters>]

GrooveBlockOptions

Set-SPOTenantSyncClientRestriction
    [-GrooveBlockOption <String>]
    [<CommonParameters>]

ReportProblemDialogFeature

Set-SPOTenantSyncClientRestriction
    -DisableReportProblemDialog <Boolean>
    [<CommonParameters>]

说明

此 cmdlet 包含多个参数集。 您可以只使用来自一个参数集的参数,也可以不合并来自不同参数集的参数。 有关如何使用参数集的详细信息,请参阅 Cmdlet 参数集

必须至少是 SharePoint 管理员才能运行 cmdlet。

需要有效的 Connect-SPOService 上下文来标识租户。 有关如何连接到租户的信息,请参阅 Connect-SPOService

Set-SPOTenantSyncClientRestriction cmdlet 用于控制与 OneDrive 和 SharePoint 的同步文件相关的各种租户范围管理设置。 您可以将其用于:

  • 设置以下项的限制:用户是否可以将项目同步到未加入域的计算机、控制允许的域的列表和管理不支持域加入的 Mac 客户端是否可以同步。

  • 阻止具有特定扩展名的文件同步。

  • 控制用户是否可以继续将OneDrive for Business库与旧的OneDrive for Business同步客户端同步。

限制未加入域的计算机同步

Set-SPOTenantSyncClientRestriction cmdlet 可用于为租户启用此功能并设置安全收件人列表中的域 GUID。 启用此功能后,可能最多需要 24 小时更改才会生效。 但是,对安全收件人列表的更改会在五分钟内生效。

重要

使用全新的 OneDrive for Business 下一代同步客户端,可以连接并同步 OneDrive for Business 中的文件。 可以将工作或学校帐户添加到全新的 OneDrive for Business 同步客户端,并将 OneDrive 中的所有文件同步到你的计算机。 有关详细信息,请参阅改进OneDrive 同步体验

启用此功能后,将发生下列状况:

  • 来自非安全收件人列表域的所有OneDrive for Business同步客户端请求将被阻止。

  • 默认情况下,不会阻止所有 Microsoft OneDrive Mac 同步客户端和 Mac Beta 客户端的请求。

  • 启用此功能时,不会阻止Microsoft OneDrive 移动应用。

  • 无论计算机是否由设备管理解决方案管理,也只有在将其加入到安全收件人列表中的域之后才能建立同步关系。

  • 之前已同步到计算机上的任何文件都不会被删除。

  • 启用此功能后,请注意以下上载行为:

    • 仍会将添加到客户端的新文件或现有文件上载到服务器,且不会被阻止。
    • 无论是否将计算机加入到安全收件人列表中设置的域。
    • 无论计算机是否加入到未在安全收件人列表中设置的域。
    • 适合所有未加入域的计算机。
  • Microsoft OneDrive for Business版本 15.0.4693.1000 之前的同步客户端将停止同步现有库。

重要

为了明确阻止适用于 Mac 的 Microsoft OneDrive 客户端或 Mac OS X 上的 OneDrive for Business 下一代同步客户端,请运行 Set-SPOTenantSyncClientRestriction cmdlet,并将 BlockMacSync 参数设置为 true。 有关 Mac OS X 的下一代同步客户端的详细信息,请参阅 Mac OS X 上的新OneDrive 同步客户端入门

重要

有一个已知的OneDrive for Business同步客户端问题,即即使计算机已加入安全收件人列表中设置的域,同步也会被阻止。 若要解决此行为,请获取同步客户端的 15.0.4719.1000 或更高版本,请参阅 2015 年 5 月 12 日更新OneDrive for Business

注意

若要确定同步客户端的版本,请参阅 我使用的同步客户端版本是什么?

重要

此功能不支持已加入Microsoft Entra或已加入工作区的设备。

有关如何对OneDrive for Business同步客户端进行故障排除的其他信息,请参阅如何从以前是 SkyDrive Pro) 独立OneDrive for Business (的 MSI 安装切换到以前是 SkyDrive Pro) 独立版 OneDrive for Business (的即点即用安装

阻止特定的文件扩展名同步

Set-SPOTenantSyncClientRestriction cmdlet 可用于配置 OneDrive 同步客户端不应同步的文件扩展名的列表,例如 PST 文件。

使用此功能可能会阻止任意文件扩展名,但请注意,更改可能最多需要 24 小时才会在各个用户设备上生效。 启用此功能后,用户同步排除列表中的任意文件时,将看到通知其该阻止操作的错误消息。

重要

只有新的OneDrive for Business同步客户端支持此功能。 若要确定同步客户端的版本,请参阅 我使用的同步客户端版本是什么?

示例

示例 1

Set-SPOTenantSyncClientRestriction  -Enable -DomainGuids "786548DD-877B-4760-A749-6B1EFBC1190A; 877564FF-877B-4760-A749-6B1EFBC1190A"

此示例为租户启用该功能,并将域 GUID 添加到安全收件人列表。

示例 2

Set-SPOTenantSyncClientRestriction  -Enable -DomainGuids "786548DD-877B-4760-A749-6B1EFBC1190A; 877564FF-877B-4760-A749-6B1EFBC1190A" -BlockMacSync:$true

本示例启用 Block Mac 同步功能。

示例 3

Set-SPOTenantSyncClientRestriction  -ExcludedFileExtensions "pptx;docx;xlsx"

此示例阻止使用新的同步客户端 (OneDrive.exe) 同步 PowerPoint、Word 和 Excel 文件类型。

示例 4

Set-SPOTenantSyncClientRestriction  -ExcludedFileExtensions ""

本示例清除 ExcludedFileExtension 列表,并允许使用新客户端 (OneDrive.exe) 同步的所有文件类型。

参数

-BlockMacSync

适用:SharePoint Online

Block Mac 同步客户端 — Beta 版以及新的同步客户端 (OneDrive.exe)。 此参数的值为 True 和 False。 默认值为 False。

参数属性

类型:System.Management.Automation.SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

Blocking
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DisableReportProblemDialog

适用:SharePoint Online

参数属性

类型:System.Boolean
默认值:None
支持通配符:False
不显示:False

参数集

ReportProblemDialogFeature
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DomainGuids

适用:SharePoint Online

设置要添加到安全收件人列表的计算机域成员身份的 域 GUID 。 至少需要一个域 GUID。 允许的最大域 GUID 数为 125。

参数属性

类型:System.String
默认值:None
支持通配符:False
不显示:False

参数集

Blocking
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Enable

适用:SharePoint Online

启用阻止从不属于安全收件人列表的域发起的同步的功能。

参数属性

类型:System.Management.Automation.SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

Blocking
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ExcludedFileExtensions

适用:SharePoint Online

阻止某些文件类型与新同步客户端 (OneDrive.exe) 同步。

注意

可能需要 1 小时,更改才会生效。

参数属性

类型:System.String
默认值:None
支持通配符:False
不显示:False

参数集

FileExclusion
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-GrooveBlockOption

适用:SharePoint Online

设置 Groove 客户端的块选项。

参数属性

类型:System.String
默认值:None
接受的值:OptOut, HardOptIn, SoftOptIn
支持通配符:False
不显示:False

参数集

GrooveBlockOptions
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

None

输出

System.Object