部署和設定適用於 Mac 的 OneDrive 同步處理 應用程式

  • 發行項

重要事項

部署和設定資料夾備份設定需要獨立 OneDrive 同步處理 應用程式。 Mac App Store OneDrive 同步處理 應用程式目前不支援資料夾備份。

身為系統管理員的您有兩種基本方式可以將 OneDrive 同步處理 應用程式部署到組織中的 Mac 使用者：

  • 依照在 macOS 上使用 OneDrive 同步處理檔案中的指示來安裝和設定 OneDrive 同步處理 應用程式。 若要安裝適用於 Mac 的 OneDrive 同步處理 應用程式，用戶必須是 Mac 上的系統管理員。

  • 將安裝程式套件檔案下載到局域網路，然後使用您的軟體發佈工具將應用程式部署給您的使用者。 藉由使用軟體發佈工具，您可以更充分掌控部署，包括哪些使用者會取得同步處理應用程式和時間。 適用於 Mac 的 OneDrive 同步處理 應用程式使用 Apple Installer 技術進行安裝，可讓您使用通常用來將軟體部署至 Mac 使用者的軟體發佈工具。 您可以使用 Microsoft Intune。 其他常見的工具包括 Jamf Pro、 Munki 和 AutoPkg。 您也可以使用 Apple 遠端桌面 和 AppleScript。

使用屬性清單 (.plist) 檔案來管理 macOS 上的 OneDrive 設定

安裝適用於 Mac 的 OneDrive 同步處理 應用程式之後，使用者就可以設定應用程式的設定。 這些設定稱為喜好設定。 身為系統管理員，您可能想要為組織中的使用者提供一組標準喜好設定。 Mac OneDrive 同步處理 應用程式的喜好設定會儲存在屬性清單 (.plist) 檔案中。

獨立 Mac App Store
.plist 位置 /Library/Preferences/com.microsoft.OneDrive.plist /Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist
網域 com.microsoft.OneDrive com.microsoft.OneDrive-mac

設定同步處理應用程式設定

在macOS上設定設定，如下所示：

  1. 使用所需的值建立 .plist 檔案，以定義您想要變更的設定。 您可以使用腳本來設定值。

  2. 結束 OneDrive 應用程式。

  3. 將設定部署到本機電腦。

  4. 重新整理喜好設定快取。

在下一次 OneDrive 啟動時，就會挑選新的設定。

設定概觀

使用下列金鑰預先設定或變更用戶的設定。 無論您執行獨立版或 Mac App Store 同步處理應用程式版本，金鑰都相同。 不過，.plist 檔名和域名會不同。 當您套用設定時，請務必根據同步處理應用程式的版本，以適當的網域為目標。

設定清單

AllowTenantList

此設定可藉由指定允許的租使用者標識碼清單，防止使用者將檔案上傳至其他組織。 如果啟用此設定，則用戶嘗試從不在允許租使用者清單中的組織新增帳戶，就會收到錯誤。 如果使用者已新增帳戶，檔案就會停止同步處理。 此設定優先於 BlockTenantList 設定。 請勿同時啟用這兩個設定。

AllowTenantList 機碼的參數是 TenantID，其值為字串，可決定適用 [允許租使用者] 設定的租使用者。 若要完成設定，此參數也需要設定布爾值。 如果布爾值設定為 True，則允許租使用者同步處理。

.plist 檔案中此設定的範例為：

<key>AllowTenantList</key>
<dict>
<key>TenantId1</key>
<true/>
<key>TenantId2</key>
<true/>
</dict>

AutomaticUploadBandwidthPercentage

此設定可讓同步處理應用程式根據可用的頻寬，自動設定可用於上傳檔案的頻寬量。

若要啟用此設定，您必須定義介於 1 到 99 之間的數位，以決定同步處理應用程式可用的總可用頻寬頻寬百分比。

.plist 檔案中此設定的範例為：

<key>AutomaticUploadBandwidthPercentage</key>
<integer>(Bandwidth)</integer>

BlockExternalSync

此設定可防止同步處理應用程式同步處理與其他組織共用的連結庫和資料夾。

將設定的值設定為 True，以防止使用者同步處理 OneDrive、SharePoint 文件庫和資料夾與使用者自己的組織以外的組織。 將值設定為 False 或不啟用設定，以允許 OneDrive 和 SharePoint 檔案與其他組織同步處理。

.plist 檔案中此設定的範例為：

<key>BlockExternalSync</key>
<(Bool)/>

BlockTenantList

此設定可防止使用者將檔案上傳至封鎖租使用者 標識 符清單中包含的組織。

如果啟用此設定，如果用戶嘗試從遭到封鎖的組織新增帳戶，就會收到錯誤。 如果使用者已為封鎖的組織新增帳戶，檔案就會停止同步處理。 如果您已啟用 AllowTenantList 設定，此設定將無法運作。 請勿同時啟用這兩個設定。

藉由定義 TenantID 參數的標識碼來啟用此設定，這會決定 區塊租 用戶設定適用的租使用者。 此外，針對您想要防止與 OneDrive 和 SharePoint 檔案和資料夾同步處理的每個租使用者識別碼，將布爾值設定為 True 。

注意事項

在清單中，只包含租用戶標識碼並不足夠。 針對要封鎖之每個租用戶的標識碼，必須將布爾值設定為 True 。

.plist 檔案中此設定的範例為：

<key>BlockTenantList</key>
<dict>
<key>TenantId1</key>
<true/>
<key>TenantId2</key>
<true/>
</dict>

DefaultFolderLocation

此設定會指定每個組織的 OneDrive 資料夾預設位置。

參數為 TenantID 和 DefaultFolderPath。 TenantID 值是一個字串，可決定預設資料夾位置設定適用的租使用者。 DefaultFolderPath 值是指定資料夾預設位置的字串。 如果您要強制將位置強制為使用者的主目錄 (也就是預設位置) 您可以將路徑指定為 ~/。 字串看起來會像這樣：

<string>~/</string>

以下是控管預設資料夾位置的條件：-Mac App Store：當使用者設定同步處理應用程式時，路徑必須已經存在。 -獨立：如果路徑在用戶設定同步處理應用程式之後) 不存在，則會 (建立路徑。 只有使用獨立同步處理應用程式，您才能防止使用者變更位置。

.plist 檔案中此設定的範例為：

<key>DefaultFolder</key>
<dict>
<key>Path</key>
<string>(DefaultFolderPath)</string>
<key>TenantId</key>
<string>(TenantID)</string>
</dict>

DisableAutoConfig

這個設定會決定同步處理應用程式是否可以自動登入。

如果您將此設定的值設定為 1，同步處理應用程式將無法自動使用可供 Microsoft 應用程式使用的現有 Microsoft Entra 認證進行簽署。

.plist 檔案中此設定的範例為：

<key>DisableAutoConfig</key>
<integer>1</integer>

DisableHydrationToast

此設定可防止在應用程式導致下載檔案內容時出現快顯通知。

如果您將設定的值設定為 True，當應用程式觸發檔案內容的下載時，不會出現快顯通知。

.plist 檔案中此設定的範例為：

<key>DisableHydrationToast</key>
<(Bool)/>

DisableOfflineMode

此設定可防止使用者在 Web 上的 OneDrive 中啟用離線模式。

此設定的喜好設定會儲存在下列 .plist 檔案中。

離線模式喜好設定位置 OneDrive 群組喜好設定
.plist 位置 ~/Library/Preferences/com.microsoft.SharePoint-mac.plist ~/Library/Group Containers/UBF8T346G9。OneDriveStandaloneSuite/Library/Preferences/UBF8T346G9。OneDriveStandaloneSuite.plist

根據預設，網路上 OneDrive 的用戶會開啟離線模式。

若要防止組織中的使用者在 Web 上的 OneDrive 中啟用離線模式，請使用下列範例：

<key>DisableOfflineMode</key>
<integer>1</integer>

若要在 Web 上的 OneDrive 中為使用者重新啟用離線模式，請使用下列範例：

<key>DisableOfflineMode</key>
<integer>0</integer>

DisableOfflineModeForExternalLibraries

此設定可防止使用者針對從其他組織共用的文檔庫和資料夾，在 Web 上的 OneDrive 中啟用離線模式。

這個設定的喜好設定會儲存在下列 .plist 檔案中：

離線模式喜好設定位置 OneDrive 群組喜好設定
.plist 位置 ~/Library/Preferences/com.microsoft.SharePoint-mac.plist ~/Library/Group Containers/UBF8T346G9。OneDriveStandaloneSuite/Library/Preferences/UBF8T346G9。OneDriveStandaloneSuite.plist

若要防止貴組織的使用者針對從其他組織共用的文檔庫和資料夾，在 Web 上的 OneDrive 中啟用離線模式，請使用下列範例：

<key>DisableOfflineModeForExternalLibraries</key>
<integer>1</integer>

若要針對從其他組織共用的文件庫和資料夾，在 Web 上的 OneDrive 中重新啟用離線模式，請使用下列範例：

<key>DisableOfflineModeForExternalLibraries </key>
<integer>0</integer>

DisablePersonalSync

此設定會封鎖用戶在個人 OneDrive 帳戶中登入和同步處理檔案。 如果在使用者設定與個人帳戶的同步處理之後設定此設定，使用者就會註銷。

如果您將設定的值設定為 True，使用者將無法新增或同步處理個人帳戶。

.plist 檔案中此設定的範例為：

<key>DisablePersonalSync</key>
<(Bool)/>

DisableTutorial

此設定可防止在使用者設定 OneDrive 之後向使用者顯示教學課程。

如果您將此設定的值設定為 True，則在使用者設定 OneDrive 同步處理 應用程式之後，會封鎖教學課程，使其無法向用戶顯示。

.plist 檔案中此設定的範例為：

<key>DisableTutorial</key>
<(Bool)/>

DownloadBandwidthLimited

此設定會針對執行 OneDrive 同步處理 應用程式的計算機，將下載輸送量速率上限設定為 KB (KB) /sec。

將此設定的值設定為介於 50 到 1000000 之間的整數，以 KB/秒指定同步處理應用程式可以使用的下載輸送量。

.plist 檔案中此設定的範例為：

<key>DownloadBandwidthLimited</key>
<integer>(Download Throughput Rate in KB/sec)</integer>

EnableAllOcsiClients

此設定可讓多位使用者使用 Microsoft 365 Apps 企業版、Office 2019 或 Office 2016 傳統型應用程式，同時編輯儲存在 OneDrive 中的 Office 檔案。 它也可讓使用者從 Office 傳統型應用程式共用檔案。

重要事項

建議您保持啟用此設定，以加快同步處理速度並減少網路頻寬使用量。 請參閱設定同步處理應用程式的所有建議。

如果您將此設定設定為 True 或未設定此設定，Office 索引標籤會出現在 OneDrive 同步處理 喜好設定中，而且預設會選取 [使用 Office 應用程式同步處理我開啟的 Office 檔案]。

如果您將此設定設為 False，同步處理應用程式中會隱藏 Office 索引標籤，並停用 Office 檔案的共同撰寫和應用程式內共用。 用戶可以選擇在衝突設定中處理 Office 檔案的方式已停用，而且當檔案衝突發生時，會保留檔案的兩個複本。 如需同步處理應用程式中設定的詳細資訊，請參閱 使用 Office 應用程式同步我開啟的 Office 檔案。

.plist 檔案中此設定的範例為：

<key>EnableAllOcsiClients</key>
<(Bool)/>

EnableODIgnore

此設定可讓您輸入關鍵詞，以防止 OneDrive 同步處理 應用程式將特定檔案上傳至 OneDrive 或 SharePoint。 您可以輸入完整名稱，例如 「setup.exe」，或使用星號 () 作為通配符來代表一系列字元，例如.pst。 關鍵字不區分大小寫。

如果您啟用這項設定，同步處理應用程式不會上傳符合所指定關鍵字的新檔案。 略過的檔案不會顯示錯誤，且檔案仍保留在本機 OneDrive 資料夾中。 在 Finder 中，檔案會顯示「已從同步中排除」圖示。

使用者也會在 OneDrive 活動中心看到訊息，說明檔案不同步處理的理由。

.plist 檔案中此設定的範例為：

<key>EnableODIgnore</key>
<array>
<string>(Keyword such as *.PST)</string>
</array>

EnableSyncAdminReports

此設定可讓 OneDrive 同步處理 應用程式報告要包含在同步管理報告中的裝置和健康情況數據。 您必須在您想要從中取得報告的裝置上啟用此設定。 如需這些報表的詳細資訊，請參閱應用程式 管理員 中心 OneDrive 同步處理 報表。

如果您停用或未設定此設定，OneDrive 同步處理 應用程式裝置和健康情況數據將不會出現在同步管理報告中。

下列範例顯示此設定在 .plist 檔案中的外觀：

<key>EnableSyncAdminReports</key>
<integer>1</integer>

FilesOnDemandEnabled

此設定會指定是否啟用檔案隨選。

注意事項

從 macOS Monterey 12.1 開始，隨選檔案將會永久啟用，而此設定將不再有任何作用。

蒙地利 12.1 之前的 macOS 版本

如果您將此設定設為 True， 則會啟用 FilesOnDemand ，且設定同步處理應用程式的用戶預設可以檢視僅限在線檔案。

如果您將此設定設為 False， 則會停用 FilesOnDemand ，且使用者將無法開啟它。

.plist 檔案中此設定的範例為：

<key>FilesOnDemandEnabled</key>
<(Bool)/>

注意事項

建議您持續啟用 [檔案隨選]。 請參閱所有設定同步處理應用程式的建議

HideDockIcon

此設定會指定是否顯示 OneDrive 的停駐圖示。

如果您將此設定的值設定為 True，即使應用程式正在執行，OneDrive 擴充座圖示也會隱藏。

.plist 檔案中此設定的範例為：

<key>HideDockIcon</key>
<(Bool)/>

HydrationDisallowedApps

此設定可防止應用程式自動下載僅限在線檔案。 您可以使用此設定來鎖定與檔案隨選部署不正確運作的應用程式。

若要啟用此設定，您必須定義 JSON 格式的字串，如下所述：
[{"ApplicationId":"appId","MaxBundleVersion":"1.1","MaxBuildVersion":"1.0"}]
“appID” 可以是 BSD 行程名稱或套件組合顯示名稱。 “MaxBuildVersion” 表示將封鎖的應用程式組建版本上限。 “MaxBundleVersion” 表示將封鎖的應用程式套件組合版本上限。

.plist 檔案中此設定的範例為：

<key>HydrationDisallowedApps</key>
<string>[{"ApplicationId":"appId","MaxBundleVersion":"1.1","MaxBuildVersion":"1.0"}, {"ApplicationId":"appId2","MaxBundleVersion":"3.2","MaxBuildVersion":"2.0"}]</string>
<(Bool)/>

KFMBlockOptIn

此設定可防止使用者將其檔和桌面資料夾移至任何 OneDrive 帳戶。

如果您啟用 KFMBlockOptIn，系統不會提示使用者保護其 Desktop 和 Documents 資料夾，且 [ 管理備份 ] 命令已停用。 如果使用者已移動其 Desktop 和 Documents 資料夾，則這些資料夾中的檔案會保留在 OneDrive 中。 如果您已啟用 KFMOptInWithWizard“ 或 KFMSilentOptIn，此設定不會生效。

如果您將此設定的值設定為 1，則會防止資料夾備份。 如果您將值設定為 2，它會將先前用於資料夾備份的任何資料夾重新導向回使用者的裝置，並停止設定進一步執行。

.plist 檔案中此設定的範例為：

<key>KFMBlockOptIn</key>
<integer>(1 or 2)</integer>

KFMBlockOptOut

此設定會強制使用者將其檔和桌面資料夾保留為 OneDrive。

如果啟用此設定，[管理資料夾備份] 視窗中的 [停止備份] 按鈕會停用，而且如果使用者嘗試停止同步處理其 [桌面] 或 [檔] 資料夾，則會收到錯誤。

.plist 檔案中此設定的範例為：

<key>KFMBlockOptOut</key>
<(Bool)/>

KFMOptInWithWizard

此設定會顯示一個精靈，提示使用者將其檔和桌面資料夾移至 OneDrive。

如果您啟用此設定並提供租使用者標識碼，則同步處理 OneDrive 的使用者會在登入時看到 [資料夾備份精靈] 視窗。 如果他們關閉視窗，同步活動中心就會出現提醒通知，直到他們移動桌面和文件資料夾為止。

.plist 檔案中此設定的範例為：

<key>KFMOptInWithWizard</key>
<string>(TenantID)</string>

KFMSilentOptIn

使用此設定可將使用者的檔和/或桌面資料夾重新導向並移至 OneDrive，而不需要任何用戶互動。

您可以一次移動這兩個資料夾，或選取要移動的資料夾。 移動資料夾之後，此設定不會再影響該資料夾。

.plist 檔案中此設定的範例為：

<key>KFMSilentOptIn</key>
<string>(TenantID)</string>

如果您啟用此設定並提供您的租使用者識別碼，您可以選擇是否要在其資料夾重新導向之後顯示通知給使用者：

<key>KFMSilentOptInWithNotification</key>
<(Bool)/>

如果您未設定下列任何設定，則預設設定會將這兩個資料夾移至 OneDrive。 如果您要指定要移動的資料夾，您應該設定下列設定的任何組合：

<key>KFMSilentOptInDesktop</key>
<(Bool)/>
<key>KFMSilentOptInDocuments</key>
<(Bool)/>

OpenAtLogin

此設定會指定當使用者登入時，OneDrive 是否會自動啟動。

如果您將此設定的值設定為 True，OneDrive 會在使用者登入其 Mac 時自動啟動。

.plist 檔案中此設定的範例為：

<key>OpenAtLogin</key>
<(Bool)/>

SharePointOnPremFrontDoorUrl

此設定會指定 OneDrive 同步處理 應用程式必須嘗試驗證和同步處理的 SharePoint Server 2019 內部部署URL。

若要啟用此設定，您必須定義包含內部部署 SharePoint Server URL 的字串。

.plist 檔案中此設定的範例為：

<key>SharePointOnPremFrontDoorUrl</key>
<string>https://Contoso.SharePoint.com</string>

設定 OneDrive 同步處理 應用程式以供 SharePoint Server 2019的詳細資訊

SharePointOnPremPrioritizationPolicy

當混合式案例中的 SharePoint Server 和 Microsoft 365 中的 SharePoint Server 和 SharePoint 的帳戶都相同時，此設定會決定同步處理應用程式是否應該在初次執行案例期間，先設定 SharePoint Server 內部部署或 Microsoft 365 中的 SharePoint 同步處理。

如果您將此設定的值設定為 1，OneDrive 同步處理 應用程式會先設定 SharePoint Server，然後再設定 Microsoft 365 中的 SharePoint。

.plist 檔案中此設定的範例為：

<key>SharePointOnPremPrioritizationPolicy</key>
<integer>(0 or 1)</integer>

SharePointOnPremTenantName

此設定可讓您指定為同步處理 Front Door URL 中指定之 SharePoint Server 2019 檔案所建立的資料夾名稱。

如果啟用此設定，您可以指定 TenantName，這是資料夾在下列慣例中使用的名稱：OneDrive – TenantName (您指定) TenantName (由您指定)

如果您未指定任何 TenantName，資料夾會使用 FrontDoorURL 的第一個區段作為其名稱。 例如，HTTPs：//Contoso.SharePoint.com 使用 Contoso 作為下列慣例中的租用戶名稱：OneDrive – Contoso

.plist 檔案中此設定的範例為：

<key>SharePointOnPremTenantName</key>
<string>Contoso</string>

設定 OneDrive 同步處理 應用程式以供 SharePoint Server 2019的詳細資訊

層級

這個設定可讓您為組織中的使用者指定同步處理應用程式更新通道。 OneDrive 同步處理 應用程式會透過三個通道更新為大眾;先更新給測試人員，再更新為生產環境，最後更新為延遲。 啟用此設定並選取通道時，使用者將無法變更通道。

我們建議您在 IT 部門中選取多個人員，成為早期採用者以加入測試人員通道，並提早接收其功能。 我們也建議讓組織中的其他人保持默認生產週期，以確保他們及時收到錯誤修正和新功能。 請參閱設定同步處理應用程式的所有建議。

測試人員：測試人員通道使用者會收到組建，讓他們預覽即將推出 OneDrive 的新功能。

生產環境：生產通道使用者會在可用時取得最新功能。 此通道是預設值。

企業 (也稱為「延後」) ：企業通道用戶最後會取得新功能、錯誤修正和效能改善。 此通道可讓您從內部網路位置部署更新，並控制部署 (在60天期間內) 的時間。

如需每個通道中目前可用組建的詳細資訊，請參閱 OneDrive 版本資訊。 如需更新通道以及同步處理應用程式如何檢查更新的詳細資訊，請參閱 OneDrive 同步處理 應用程式更新程式。

.plist 位置 網域
~/Library/Preferences/com.microsoft.OneDriveUpdater.plist com.microsoft.OneDriveUpdater

.plist 檔案中此設定的範例為：

<key>Tier</key>
<string>(UpdateRing)</string>

注意事項

如果您想要隱藏 [取得要顯示的 Microsoft 內部更新的發行前版本] 選項，您必須加入加入延遲更新通道。 例如，defaults write com.microsoft.OneDrive Tier -string "Deferred"。

UploadBandwidthLimited

這個設定會定義執行 OneDrive 同步處理 應用程式之電腦的最大上傳輸送量速率。

若要啟用此設定，請設定介於50到100000之間的值，這是同步處理應用程式可以使用之 KB/秒的上傳輸送量速率。

.plist 檔案中此設定的範例為：

<key>UploadBandwidthLimited</key>
<integer>(Upload Throughput Rate in KB/sec)</integer>

尋找您的 Microsoft 365 租使用者識別碼

OneDrive 同步處理 應用程式 管理員 中心 (EnableSyncAdminReports)