Bereitstellen und Konfigurieren der neuen OneDrive-Synchronisierungs-App für MacDeploy and configure the new OneDrive sync app for Mac

Dieser Artikel richtet sich an IT-Administratoren, die OneDrive für Unternehmen Einstellungen in Arbeits-und Schulumgebungen verwalten.This article is for IT administrators managing OneDrive for Business settings in work or school environments. Wenn Sie kein IT-Administrator sind, lesen Sie Erste Schritte mit der neuen OneDrive-Synchronisierungs-app unter Mac OS X.If you're not an IT administrator, read Get started with the new OneDrive sync app on Mac OS X.

Verwalten von OneDrive-Einstellungen unter macOS mithilfe von Plist-Dateien (Eigenschaftslisten)Manage OneDrive settings on macOS using property list (Plist) files

Verwenden Sie die folgenden Tasten, um Einstellungen für Ihre Benutzer vorzu konfigurieren oder zu ändern.Use the following keys to preconfigure or change settings for your users. Die Schlüssel sind identisch, unabhängig davon, ob Sie die Store Edition oder die eigenständige Edition der Sync-app ausführen, aber der Dateiname und der Domänenname der Eigenschaftenliste unterscheiden sich.The keys are the same whether you run the store edition or the standalone edition of the sync app, but the property list file name and domain name will be different. Wenn Sie die Einstellungen anwenden, stellen Sie sicher, dass die entsprechende Domäne in Abhängigkeit von der Edition der Sync-App abzielt.When you apply the settings, make sure to target the appropriate domain depending on the edition of the sync app.

EigenständigStandalone Mac App StoreMac App Store
Plist-SpeicherortPList Location
~/Library/Preferences/com.microsoft.OneDrive.plist~/Library/Preferences/com.microsoft.OneDrive.plist
~/Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist~/Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist
DomäneDomain
com.microsoft.OneDrivecom.microsoft.OneDrive
com.microsoft.OneDrive-maccom.microsoft.OneDrive-mac

Bereitstellen der Synchronisierungs-App-EinstellungenDeploy the sync app settings

Stellen Sie die Einstellungen unter macOS auf die übliche Weise bereit:Deploy the settings on macOS in the typical way:

  1. Beenden Sie die OneDrive-Anwendung.Quit the OneDrive application.

  2. Definieren Sie die Einstellungen, die Sie ändern möchten, indem Sie eine Plist mit den Werten erstellen, oder verwenden Sie ein Skript, um die Standardwerte festzulegen.Define the settings you want to change by creating a Plist with the values, or use a script to set the default values.

  3. Stellen Sie die Einstellungen auf dem lokalen Computer bereit.Deploy the settings onto the local computer.

  4. Aktualisieren Sie den Cache mit den Einstellungen.Refresh the preferences cache.

    Beim nächsten Start von OneDrive werden die neuen Einstellungen ausgewählt.On the next start of OneDrive, the new settings will be picked up.

Übersicht der EinstellungenOverview of settings

In der folgenden Tabelle sind alle Einstellungen aufgeführt, die derzeit für die OneDrive-Synchronisierungs-app verfügbar gemacht werden.The following table lists all the settings that are currently exposed for the OneDrive sync app. Sie müssen die Parameter in Klammern konfigurieren.You need to configure the parameters in parentheses.

EinstellungSetting BeschreibungDescription ParameterParameters Plist-BeispieleintragExample Plist Entry
Persönliche Konten deaktivierenDisable personal accounts
Hindert Benutzer daran, sich anzumelden und Dateien in persönlichen OneDrive-Konten zu synchronisieren. Wenn dieser Schlüssel festgelegt wird, nachdem ein Benutzer die Synchronisierung mit einem persönlichen Konto eingerichtet hat, wird der Benutzer abgemeldet.Blocks users from signing in and syncing files in personal OneDrive accounts. If this key is set after a user has set up sync with a personal account, the user will be signed out.
DisablePersonalSync (Boolescher Wert): Wenn dieser Parameter auf „true“ festgelegt ist, können Benutzer keine persönlichen Konten hinzufügen oder synchronisieren.DisablePersonalSync (Bool): When set to true, this parameter prevents users from adding or syncing personal accounts.
<key>DisablePersonalSync</key><key>DisablePersonalSync</key>
<(Boolescher Wert)/><(Bool)/>
Standardspeicherort für OrdnerDefault folder location
Gibt den Standardspeicherort des OneDrive-Ordners für jede Organisation an.Specifies the default location of the OneDrive folder for each organization
TenantID (Zeichenfolge): TenantID bestimmt, für welche Konten die Einstellung des Ordner-Standardspeicherorts gelten soll. Suchen Ihrer Office 365-Mandanten-IDTenantID (String): TenantID determines which accounts the default folder location setting should apply to. Find your Office 365 tenant ID
DefaultFolderPath (Zeichenfolge): DefaultFolder gibt den Ordner-Standardspeicherort an.DefaultFolderPath (String): DefaultFolder specifies the default folder location.
Mac App Store:Mac App Store:
Der Pfad muss bereits vorhanden sein, wenn Benutzer die Sync-App einrichten.The path must already exist when users set up the sync app.
Eigenständig:Standalone:
Der Pfad wird auf den Computern der Benutzer erstellt, sofern er noch nicht vorhanden ist.The path will be created on users' computers if it doesn't already exist. Nur mit der eigenständigen Sync-App können Sie verhindern, dass Benutzer den Speicherort ändern.Only with the Standalone sync app can you prevent users from changing the location.
<key>Tenants</key><key>Tenants</key>
<dict><dict>
<key>(TenantID)</key><key>(TenantID)</key>
<dict><dict>
<key>DefaultFolder</key><key>DefaultFolder</key>
<string>(DefaultFolderPath)</string><string>(DefaultFolderPath)</string>
</dict></dict>
</dict></dict>
Automatischer Prozentsatz der UploadbandbreiteAutomatic upload bandwidth percentage
Ermöglicht der Synchronisierungs-APP, die verwendete Bandbreite basierend auf der verfügbaren Bandbreite für das Hochladen von Dateien automatisch festzulegen.Enables the sync app to automatically set the amount of bandwidth used based on available bandwidth for uploading files
AutomaticUploadBandwidthPercentage (int): dieser Parameter bestimmt den Prozentsatz der lokalen Upload-Bandbreite, die von der Synchronisierungs-App verwendet werden kann.AutomaticUploadBandwidthPercentage (int): This parameter determines the percentage of local upload bandwidth that the sync app can use. Akzeptierte Werte sind 1 bis 99.Accepted values are from 1 through 99.
<key>AutomaticUploadBandwidthPercentage</key><key>AutomaticUploadBandwidthPercentage</key>
<int>(Bandbreite)</int><int>(Bandwidth)</int>
Maximalen Uploaddurchsatz festlegenSet maximum upload throughput
Legt die maximale Upload-Durchsatzrate in Kilobyte (KB)/s für Computer fest, auf denen die OneDrive Sync-app läuft.Sets the maximum upload throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app
UploadBandwidthLimited (int): dieser Parameter bestimmt den Upload-Durchsatz in KB/s, den die Synchronisierungs-App verwenden kann.UploadBandwidthLimited (int): This parameter determines the upload throughput in KB/sec that the sync app can use. Die Mindestrate beträgt 50 KB/s, und die maximale Rate beträgt 100.000 KB/s.The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec.
<key>UploadBandwidthLimited</key><key>UploadBandwidthLimited</key>
<int>(Upload-Durchsatzrate in KB/s)</int><int>(Upload Throughput Rate in KB/sec)</int>
Maximalen Downloaddurchsatz festlegenSet maximum download throughput
Legt die maximale Download Durchsatzrate in Kilobyte (KB)/s für Computer fest, auf denen die OneDrive Sync-App installiert ist.Sets the maximum download throughput rate in kilobytes (KB)/sec for computers running the OneDrive sync app
DownloadBandwidthLimited (int): dieser Parameter bestimmt den Download Durchsatz in KB/s, den die Synchronisierungs-App verwenden kann.DownloadBandwidthLimited (int): This parameter determines the download throughput in KB/sec that the sync app can use. Die Mindestrate beträgt 50 KB/s, und die maximale Rate beträgt 100.000 KB/s.The minimum rate is 50 KB/sec and the maximum rate is 100,000 KB/sec.
<key>DownloadBandwidthLimited</key><key>DownloadBandwidthLimited</key>
<int>(Download-Durchsatzrate in KB/s)</int><int>(Download Throughput Rate in KB/sec)</int>
AndocksymbolDock icon
Gibt an, ob ein Andocksymbol für OneDrive angezeigt wirdSpecifies whether a dock icon for OneDrive is shown
HideDockIcon (Boolescher Wert): Wenn dieser Parameter auf „true“ festgelegt ist, bleibt das OneDrive-Andocksymbol auch dann ausgeblendet, wenn die Anwendung ausgeführt wird.HideDockIcon (Bool): When set to true, this parameter hides the OneDrive dock icon even when the application is running.
<key>HideDockIcon</key><key>HideDockIcon</key>
<(Boolescher Wert)/><(Bool)/>
Bei Anmeldung öffnenOpen at login
Gibt an, ob OneDrive automatisch gestartet wird, wenn sich der Benutzer anmeldetSpecifies whether OneDrive starts automatically when the user logs in
OpenAtLogin (Boolescher Wert): Wenn dieser Parameter auf „true“ festgelegt ist, wird OneDrive automatisch gestartet, wenn sich der Benutzer auf dem Mac anmeldet.OpenAtLogin (Bool): When set to true, OneDrive will start automatically when the user logs in on the Mac.
<key>OpenAtLogin</key><key>OpenAtLogin</key>
<(Boolescher Wert)/><(Bool)/>
Aktivieren von Dateien bei BedarfEnable Files On-Demand
Gibt an, ob Dateien bei Bedarf aktiviert ist. Wenn Sie diese Einstellung nicht festlegen, wird Dateien bei Bedarf automatisch aktiviert, da wir diese Funktionen bereitstellen und Benutzer die Einstellung aktivieren oder deaktivieren können.Specifies whether Files On-Demand is enabled. If you don't set this setting, Files On-Demand will be enabled automatically as we roll out the feature, and users can turn the setting on or off
FilesOnDemandEnabled (bool): Wenn die Einstellung auf "true" festgelegt ist, werden neue Benutzer, die die Synchronisierungs-App einrichten, standardmäßig nur Online Dateien herunterladen.FilesOnDemandEnabled (Bool): When set to true, new users who set up the sync app will download online-only files by default. Bei Festlegung auf "false" werden Dateien bei Bedarf deaktiviert, und Benutzer können Sie nicht aktivieren.When set to false, Files On-Demand will be disabled and users won't be able to turn it on.
<key>FilesOnDemandEnabled</key><key>FilesOnDemandEnabled</key>
<(Boolescher Wert)/><(Bool)/>
Deaktivieren von Download-PopupsDisable download toasts
Verhindert, dass Popups angezeigt werden, wenn Anwendungen bewirken, dass Dateiinhalte heruntergeladen werdenPrevents toasts from appearing when applications cause file contents to be downloaded
DisableHydrationToast (Boolescher Wert): Wenn "true" ausgewählt wurde, werden Popups nicht angezeigt, wenn Anwendungen das Herunterladen von Dateiinhalten auslösen.DisableHydrationToast (Bool): When set to true, toasts will not appear when applications trigger the download of file contents.
<key>DisableHydrationToast</key><key>DisableHydrationToast</key>
<(Boolescher Wert)/><(Bool)/>
Verhindert das Herunterladen von nur online verfügbaren DateienBlock apps from downloading online-only files
Verhindert, dass Anwendungen nur online verfügbare Dateien automatisch herunterladen. Sie können diese Einstellung verwenden, um Anwendungen zu sperren, die nicht ordnungsgemäß mit Ihrer Bereitstellung von Dateien bei Bedarf funktionieren.Prevents applications from automatically downloading online-only files. You can use this setting to lock down applications that don't work correctly with your deployment of Files On-Demand.
HydrationDisallowedApps (Zeichenfolge): Json im folgenden FormatHydrationDisallowedApps (String): Json in the following format
[{"ApplicationId":"appId","MaxBundleVersion":"1.1","MaxBuildVersion":"1.0"}]
"AppID" kann entweder der Name des BSD-Prozesses oder der Anzeigename des Pakets sein. MaxBuildVersion gibt die maximale Buildversion der Anwendung an, die blockiert wird. MaxBundleVersion gibt die maximale Paketversion der Anwendung, die blockiert wird."AppID" can be either the BSD process name or the bundle display name. MaxBuildVersion denotes the maximum build version of the application that will be blocked. MaxBundleVersion denotes the maximum bundle version of the application that will be blocked
<key>HydrationDisallowedApps </key><key>HydrationDisallowedApps </key>
<string> [{"ApplicationId":"appId","MaxBundleVersion":"1.1","MaxBuildVersion":"1.0"}, {"ApplicationId":"appId2","MaxBundleVersion":"3.2","MaxBuildVersion":"2.0"}]</string><string> [{"ApplicationId":"appId","MaxBundleVersion":"1.1","MaxBuildVersion":"1.0"}, {"ApplicationId":"appId2","MaxBundleVersion":"3.2","MaxBuildVersion":"2.0"}]</string>
<(Boolescher Wert)/><(Bool)/>
SharePoint Server-Front Door-URLSharePoint Server Front Door URL
Gibt die lokale URL SharePoint Server 2019 an, die von der OneDrive-Synchronisierungs-App zur Authentifizierung und Synchronisierung versucht werden soll.Specifies the SharePoint Server 2019 on-premises URL that the OneDrive sync app should try to authenticate and sync against
SharePointOnPremFrontDoorUrl (Zeichenfolge): Die URL des lokalen SharePoint-Servers.SharePointOnPremFrontDoorUrl (string): The URL of the on-premises SharePoint Server.
<key>SharePointOnPremFrontDoorUrl</key><key>SharePointOnPremFrontDoorUrl</key>
<string>https://Contoso.SharePoint.com</string><string>https://Contoso.SharePoint.com</string>
SharePoint Server-MandantennameSharePoint Server Tenant Name
Gibt den Namen des Ordners zum Synchronisieren der in der Front Door-URL spezifizierten SharePoint Server 2019-Dateien an.Specifies the name of the folder created for syncing the SharePoint Server 2019 files specified in the Front Door URL.
SharePointOnPremTenantName (Zeichenfolge): Der Name, der beim Erstellen eines Ordners für die Synchronisierung der lokalen SharePoint Server-Dateien verwendet werden soll. Wenn angegeben, liegt der Ordnername folgendermaßen vor:SharePointOnPremTenantName (string): The name that will be used when creating a folder to sync the on-premises SharePoint Server files. If specified, the folder names will take the form of:
OneDrive – TenantNameOneDrive – TenantName
TenantNameTenantName
Wenn nicht angegeben, wird für den Ordnernamen das erste Segment der FrontDoorURL als Mandantenname verwendet.If not specified, the folder names will use the first segment of the FrontDoorURL as the Tenant Name.
Beispiel: https://Contoso.SharePoint.com verwendet Contoso als Mandantenname.Example - https://Contoso.SharePoint.com will use Contoso as the Tenant Name
<key>SharePointOnPremTenantName</key><key>SharePointOnPremTenantName</key>
<string>Contoso</string><string>Contoso</string>
SharePoint-OnPrem-PriorisierungSharePoint OnPrem Prioritization
Für Hybridszenarien, in denen die E-Mail-Adresse für die lokale Version von SharePoint Server und SharePoint Online gleich ist, wird festgelegt, ob der Client die Synchronisierung für SharePoint Server oder SharePoint Online zum ersten Mal während der ersten Ausführung einrichten soll.For hybrid scenarios where the email is the same for both SharePoint Server on-premises and SharePoint Online, determines whether or not the client should set up sync for SharePoint Server or SharePoint Online first during the first-run scenario.
SharePointOnPremPrioritzationPolicy (Integer): Mit diesem Parameter wird festgelegt, welcher Dienst für den Authentifizierungsversuch zum Einrichten der Synchronisierung ausgewählt werden soll.SharePointOnPremPrioritizationPolicy (int): This parameter determines which service to attempt to authenticate against for setting up sync.
1 gibt an, dass OneDrive zuerst den lokalen SharePoint Server und dann SharePoint Online einrichten soll.1 indicates OneDrive should setup SharePoint Server on-premises first, followed by SharePoint Online.
<key>SharePointOnPremPrioritizationPolicy</key><key>SharePointOnPremPrioritizationPolicy</key>
<int>(0 oder 1)</int><int>(0 or 1)</int>
BlockExternalSyncBlockExternalSync Verhindert, dass die Synchronisierungs-App Bibliotheken und Ordner synchronisiert, die von anderen Organisationen gemeinsam verwendet werden.Prevents the sync app from syncing libraries and folders shared from other organizations. BlockExternalSync (bool): wird auf true festgelegt, um zu verhindern, dass OneDrive für Unternehmen-und SharePoint-Bibliotheken und-Ordner von anderen Organisationen als der benutzereigenen Organisation synchronisiert werden.BlockExternalSync (Bool): Set to true to prevent syncing OneDrive for Business and SharePoint libraries and folders from organizations other than the user's own organization. Legen Sie den Wert auf false fest, oder fügen Sie die Einstellung nicht zulassen ein.Set to false or do not include the setting to allow.
Erfahren Sie mehr über die OneDrive B2B-Synchronisierung.Learn about OneDrive B2B Sync.
<Key>BlockExternalSync</Key><key>BlockExternalSync</key>
<(Boolescher Wert)/><(Bool)/>

Sie können die OneDrive-eigenständige Sync-APP auch so konfigurieren, dass verzögerte Aktualisierungen empfangen werden.You can also configure the OneDrive Standalone sync app to receive delayed updates.

Plist-SpeicherortPList Location
~/Library/Preferences/com.microsoft.OneDriveUpdater.plist~/Library/Preferences/com.microsoft.OneDriveUpdater.plist
DomäneDomain
com.microsoft.OneDriveUpdatercom.microsoft.OneDriveUpdater
EinstellungSetting BeschreibungDescription ParameterParameters Plist-BeispieleintragExample Plist Entry
EbeneTier
Definiert den Updatering für den ComputerDefines the update ring for the computer
UpdateRing (Zeichenfolge): Dieser Parameter hat zwei unterschiedliche Werte.UpdateRing (String): This parameter has two different values.
Production – Dies ist der standardmäßige Updatering für OneDrive-Updates.Production - The default update ring for OneDrive updates.
Insiders – Dieser Updatering erhält Updates mit dem Status „vor Produktion“ und ermöglicht es Ihnen, Funktionen auszuprobieren, bevor sie freigegeben werden. Beachten Sie, das Builds dieses Rings möglicherweise weniger stabil sind.Insiders - This update ring receives updates that are "pre-production" and will allow you to play with features before they are released. Note that builds from this ring may be less stable.
Enterprise – dieser Update-Ring erhält Updates, nachdem er einen Rollout durch den Produktions Ring ausgeführt hat.Enterprise - This update ring receives updates after they have rolled out through the Production ring. Außerdem können Sie die Bereitstellung von Updates steuern.It also lets you control the deployment of updates. Weitere Informationen über die Update Ringe und wie die Synchronisierungs-App nach Updates sucht, finden Sie im Updateprozess für die OneDrive-Sync-App.For more info about the update rings and how the sync app checks for updates, see The OneDrive sync app update process.
<key>Tier</key><key>Tier</key>
<string>(UpdateRing)</string><string>(UpdateRing)</string>