You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This cmdlet contains more than one parameter set. You may only use parameters from one parameter set, and you may not combine parameters from different parameter sets. For more information about how to use parameter sets, see [Cmdlet Parameter Sets](https://msdn.microsoft.com/library/dd878348(VS.85).aspx).
38
+
39
+
You must be a SharePoint Online global administrator to run the cmdlet.
40
+
41
+
Requires a valid Connect-SPOService context to identify the tenant. For information on how to connect to the tenant, see [Connect-SPOService](Connect-SPOService.md)
42
+
43
+
The **Set-SPOTenantSyncClientRestriction** cmdlet is used to control a variety of tenant-wide administrative settings related to syncing files from OneDrive and SharePoint. You may use it to:
44
+
45
+
* Set restrictions on whether users can sync items to non-domain joined machines, control the list of allowed domains, and manage whether Mac clients (which do not support domain join) can sync.
46
+
47
+
* Prevents files with specific extensions from being synced.
48
+
49
+
* Controls whether users can continue to sync OneDrive for Business libraries with the old OneDrive for Business sync client.
50
+
51
+
#### Restrict non-domain joined machines from syncing ####
52
+
53
+
The **Set-SPOTenantSyncClientRestriction** cmdlet can be used to enable the feature for tenancy and set the domain GUIDs in the safe recipients list. When this feature is enabled it can take up to 24 hours for the change to take effect. However, any changes to the safe domains list are reflected within five minutes.
54
+
55
+
The **Set-SPOTenantSyncClientRestriction** cmdlet applies both to existing Microsoft OneDrive for Business sync client (Groove.exe) and the Microsoft OneDrive for Business Next Generation Sync Client (OneDrive.exe). OneDrive.exe is the new sync client that will sync both consumer and business accounts.
56
+
57
+
**IMPORTANT**: The new OneDrive for Business Next Generation Sync Client lets you connect and sync files from your OneDrive for Business. You can add a work or school account to the new OneDrive for Business sync client and sync all your files in OneDrive to your computer. For more information, see [Improve your OneDrive sync experience](https://go.microsoft.com/fwlink/p/?LinkId=717436).
58
+
59
+
When the feature is enabled the following will occur:
60
+
61
+
* All OneDrive for Business Sync client requests originating from a domain that is not on the safe recipients list will be blocked.
62
+
* All Microsoft OneDrive Mac Sync client and Mac Beta client requests will not be blocked by default.
63
+
* Microsoft OneDrive mobile apps are not blocked when this feature is enabled.
64
+
* Regardless whether a computer is managed by a device management solution, a sync relationship will not be established unless they are joined to a domain in the Safe Recipient List.
65
+
* Any files that have been previously been synced down to your computer will not be deleted.
66
+
* When this feature is enabled, please be aware the following upload behavior:
67
+
68
+
* New or existing files added to the client will still be uploaded to the server and will not be blocked.
69
+
* Regardless if the computer is joined to a domain which is set in the Safe Recipient List.
70
+
* Regardless if the computer is joined to a domain which is not set in the Safe Recipient List.
71
+
* And for all non-domain joined computers.
72
+
73
+
74
+
* Microsoft OneDrive for Business sync client prior to version 15.0.4693.1000 will stop syncing existing libraries.
75
+
76
+
**IMPORTANT**: In order to explicitly block Microsoft OneDrive client for Mac or OneDrive for Business Next Generation Sync Client on Mac OS X, please run the **Set-SPOTenantSyncClientRestriction** cmdlet with the **BlockMacSync** parameter set to true. For more information about the Next Generation Sync Client for Mac OS X, see [Get started with the new OneDrive sync client on Mac OS X](https://go.microsoft.com/fwlink/?LinkID=717727).
77
+
78
+
**IMPORTANT**: There is a known OneDrive for Business sync client issue where syncing is being blocked even if a computer is joined to a domain which is set in the Safe Recipient List. To resolve this behavior, obtain the 15.0.4719.1000 version or higher of the sync client, see [May 12, 2015, update for OneDrive for Business](https://support.microsoft.com/en-us/kb/2986244/).
79
+
80
+
**Note**: To determine the version of your Sync client, see [What version of the sync client am I using?](https://support.office.com/en-us/article/Which-version-of-OneDrive-am-I-using-19246eae-8a51-490a-8d97-a645c151f2ba).
81
+
82
+
* The latest OneDrive for Business sync client can be downloaded from [Download OneDrive for Windows](http://go.microsoft.com/fwlink/?LinkID=404119&clcid=0x409) or [How to install OneDrive for Business for SharePoint and SharePoint Online](http://go.microsoft.com/fwlink/?LinkID=321300&clcid=0x409).
83
+
84
+
**IMPORTANT**: This capability doesn’t support Microsoft Azure Active Directory (AD) Joined or Workplace Joined devices.
85
+
86
+
For additional information about how to troubleshoot the OneDrive for Business sync client, see [How to switch from an MSI installation of OneDrive for Business (formerly SkyDrive Pro) standalone to a Click-To-Run installation of OneDrive for Business (formerly SkyDrive Pro) standalone](http://go.microsoft.com/fwlink/?LinkId=526386&clcid=0x409).
87
+
88
+
#### Block specific file extensions from syncing ####
89
+
90
+
The **Set-SPOTenantSyncClientRestriction** cmdlet can be used to configure a list of file extensions that should not be synced by the OneDrive sync client, such as .PST files.
91
+
92
+
Any file extension may be blocked using this feature, but note that it may take up to 24 hours for a change to take affect across all user devices. When this feature is enabled, users syncing any file that is in the exclusion list will see an error message informing them of the block.
93
+
94
+
**IMPORTANT**: This feature is only supported by the new OneDrive for Business sync client. To determine the version of your Sync client, see [What version of the sync client am I using?](https://support.office.com/en-us/article/Which-version-of-OneDrive-am-I-using-19246eae-8a51-490a-8d97-a645c151f2ba).
95
+
96
+
#### Control whether users can use the old OneDrive for Business sync client ####
97
+
98
+
The **Set-SPOTenantSyncClientRestriction** cmdlet can be used to configure your tenant to allow or disallow users from using the old OneDrive for Business sync client to sync OneDrive for Business libraries.
99
+
100
+
This feature is controlled on an opt-out model which lets users to continue syncing with the old sync client, you may choose to opt out of the Groove block.
101
+
102
+
When this feature is enabled, the old OneDrive for Business sync client will stop syncing the user’s OneDrive contents. OneDrive for Business users who are still using the old OneDrive for Business sync client will see an error message and will be prompted to launch and configure the new OneDrive for Business sync client. If they do not yet have the new client installed, they will have the opportunity to download and install it.
103
+
104
+
If you opt out, users will be able to resume syncing with the old OneDrive for Business Sync client.
105
+
Note that it may take up to an hour for this change to be reflected.
106
+
107
+
**Note: This feature only applies to syncing a user’s own OneDrive for Business sites. Team Sites and shared content from other people’s OneDrive for Business sites will continue to sync with the old OneDrive for Business sync client.
This example blocks users in a tenant from syncing OneDrive for Business libraries using the old OneDrive for Business sync client. Users will be prompted to upgrade to the new client.
161
+
162
+
48
163
49
164
50
165
## PARAMETERS
51
166
52
167
### -BlockMacSync
53
-
{{Fill BlockMacSync Description}}
168
+
Block Mac sync clients-- the Beta version and the new sync client (OneDrive.exe).
169
+
The values for this parameter are True and False. The default value is False.
0 commit comments