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。
注意
若要确定同步客户端的版本,请参阅 我使用的同步客户端版本是什么?。
- 可以从下载 OneDrive for Windows 或如何安装 OneDrive for Business for SharePoint 和 SharePoint Online 下载最新的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。