Set-SPOTenantSyncClientRestriction

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

语法

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

说明

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

你必须是 SharePoint Online 管理员或全局管理员才能运行 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 Azure Active Directory (AD) 加入或工作区加入的设备。

有关如何对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 添加到安全收件人列表。

--------------------EXAMPLE 2------------------

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

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

--------------------EXAMPLE 3------------------

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

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

--------------------EXAMPLE 4------------------

Set-SPOTenantSyncClientRestriction  -ExcludedFileExtensions ""

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

参数

-BlockMacSync

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-DisableReportProblemDialog

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-DomainGuids

设置要添加到安全收件人列表中的域 GUID。 至少需要一个域 GUID。 允许的域 GUID 最大数量为 125。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Enable

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-ExcludedFileExtensions

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

注意

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

输入

None

输出

System.Object