Implantar e configurar o aplicativo Sincronização do OneDrive para Mac

  • Artigo

Importante

O aplicativo Sincronização do OneDrive autônomo é necessário para implantar e configurar as configurações de Backup de Pasta. No momento, não há suporte para o aplicativo Mac App Store Sincronização do OneDrive em relação ao Backup de Pastas.

Há duas maneiras básicas de você, como administrador, implantar o aplicativo Sincronização do OneDrive para usuários Mac em sua organização:

  • Instale e configure o aplicativo Sincronização do OneDrive seguindo as instruções em Sincronizar arquivos com o OneDrive no macOS. Para instalar o aplicativo Sincronização do OneDrive para Mac, um usuário precisa ser um administrador no Mac.

  • Baixe o arquivo de pacote do instalador para sua rede local e use suas ferramentas de distribuição de software para implantar o aplicativo em seus usuários. Usando uma ferramenta de distribuição de software, você tem mais controle sobre a implantação, incluindo quais usuários obtêm o aplicativo de sincronização e quando. O aplicativo Sincronização do OneDrive para Mac usa a tecnologia Apple Installer para instalação, permitindo que você use as ferramentas de distribuição de software que normalmente você usa para implantar software em usuários Mac. Você pode usar Microsoft Intune. Outras ferramentas comuns são Jamf Pro, Munki e AutoPkg. Você também pode usar a Área de Trabalho Remota da Apple e o AppleScript.

Gerenciar configurações do OneDrive no macOS usando arquivos da lista de propriedades (.plist)

Depois que o aplicativo Sincronização do OneDrive para Mac for instalado, os usuários poderão configurar configurações para o aplicativo. Essas configurações são chamadas de preferências. Como administrador, talvez você queira fornecer aos usuários da sua organização um conjunto padrão de preferências. As preferências para o aplicativo Sincronização do OneDrive para Mac são armazenadas em arquivos de lista de propriedades (.plist).

Autônomo Mac App Store
Local do .plist /Library/Preferences/com.microsoft.OneDrive.plist /Library/Containers/com.microsoft.OneDrive-mac/Data/Library/Preferences/com.microsoft.OneDrive-mac.plist
Domínio com.microsoft.OneDrive com.microsoft.OneDrive-mac

Configurar configurações de aplicativo de sincronização

Configure as configurações no macOS da seguinte maneira:

  1. Defina as configurações que você deseja alterar criando um arquivo .plist com os valores necessários. Você pode usar um script para definir os valores.

  2. Saia do aplicativo OneDrive.

  3. Implante as configurações no computador local.

  4. Atualize o cache de preferências.

Na próxima inicialização do OneDrive, as novas configurações serão captadas.

Visão geral das configurações

Use as chaves a seguir para pré-configuração ou alteração de configurações para seus usuários. As chaves são as mesmas se você executar a edição autônoma ou mac App Store do aplicativo de sincronização. No entanto, o nome do arquivo .plist e o nome de domínio serão diferentes. Ao aplicar as configurações, verifique se você destina o domínio apropriado dependendo da edição do aplicativo de sincronização.

Lista de configurações

AllowTenantList

Essa configuração impede que os usuários carreguem arquivos para outras organizações especificando uma lista de IDs de locatário permitidas. Se você habilitar essa configuração, o usuário receberá um erro se tentar adicionar uma conta de uma organização que não está na lista de locatários permitidos. Se o usuário já tiver adicionado a conta, os arquivos interromperão a sincronização. Essa configuração tem prioridade sobre a configuração BlockTenantList . NÃO habilite as duas configurações ao mesmo tempo.

O parâmetro da chave AllowTenantList é TenantID e seu valor é uma cadeia de caracteres, que determina os locatários para os quais a configuração Permitir Locatário é aplicável. Para que a configuração seja concluída, esse parâmetro também requer que um valor booliano seja definido como ele. Se o valor booliano for definido como True, o locatário poderá sincronizar.

O exemplo dessa configuração no arquivo .plist é:

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

AutomaticUploadBandwidthPercentage

Essa configuração permite que o aplicativo de sincronização defina automaticamente a quantidade de largura de banda que pode ser usada para carregar arquivos, com base na largura de banda disponível.

Para habilitar essa configuração, você deve definir um número entre 1 e 99 que determina a porcentagem de largura de banda que o aplicativo de sincronização pode usar fora da largura de banda total disponível.

O exemplo dessa configuração no arquivo .plist é:

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

BlockExternalSync

Essa configuração impede que o aplicativo de sincronização sincronize bibliotecas e pastas compartilhadas de outras organizações.

Defina o valor da configuração como True, para impedir que os usuários sincronizem o OneDrive, as bibliotecas do SharePoint e as pastas com organizações diferentes da própria organização do usuário. Defina o valor como False ou não habilite a configuração para permitir que os arquivos do OneDrive e do SharePoint também sejam sincronizados com outras organizações.

O exemplo dessa configuração no arquivo .plist é:

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

BlockTenantList

Essa configuração impede que os usuários carreguem arquivos em organizações incluídas na lista de IDs de locatário bloqueadas .

Se você habilitar essa configuração, os usuários receberão um erro se tentarem adicionar uma conta de uma organização bloqueada. Se um usuário já tiver adicionado uma conta para uma organização bloqueada, os arquivos interromperão a sincronização. Essa configuração NÃO funcionará se você tiver a configuração AllowTenantList habilitada. NÃO habilite as duas configurações ao mesmo tempo.

Habilite essa configuração definindo IDs para o parâmetro TenantID , que determina os locatários a quem a configuração do locatário do bloco é aplicável. Defina também o valor booliano como True para a ID de cada locatário que você deseja impedir de sincronizar com os arquivos e pastas do OneDrive e do SharePoint.

Observação

Na lista, a inclusão da ID do locatário por si só não é suficiente. É obrigatório definir o valor booliano como True para a ID de cada locatário que deve ser bloqueado.

O exemplo dessa configuração no arquivo .plist é:

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

DefaultFolderLocation

Essa configuração especifica o local padrão da pasta OneDrive para cada organização.

Os parâmetros são TenantID e DefaultFolderPath. O valor TenantID é uma cadeia de caracteres que determina os locatários a quem a configuração de local da pasta padrão é aplicável. O valor DefaultFolderPath é uma cadeia de caracteres que especifica o local padrão da pasta. Se você quiser impor o local para ser o diretório inicial do usuário (ou seja, o local padrão), você poderá especificar o caminho como ~/. A cadeia de caracteres seria assim:

<string>~/</string>

Veja a seguir as condições que regem o local da pasta padrão: -Mac App Store: O caminho já deve existir quando o usuário estiver configurando o aplicativo de sincronização. -Autônomo: o caminho será criado (se ainda não existir) depois que o usuário configurar o aplicativo de sincronização. Somente com o aplicativo de sincronização autônomo, você pode impedir que os usuários alterem o local.

O exemplo dessa configuração no arquivo .plist é:

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

DisableAutoConfig

Essa configuração determina se o aplicativo de sincronização pode ou não entrar automaticamente.

Se você definir o valor dessa configuração como 1, o aplicativo de sincronização será impedido de assinar automaticamente com uma credencial Microsoft Entra existente que é disponibilizada para aplicativos Microsoft.

O exemplo dessa configuração no arquivo .plist é:

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

DisableHydrationToast

Essa configuração impede que os brindes apareçam quando os aplicativos fazem com que o conteúdo do arquivo seja baixado.

Se você definir o valor da configuração como True, os brindes não serão exibidos quando os aplicativos disparam o download do conteúdo do arquivo.

O exemplo dessa configuração no arquivo .plist é:

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

DisableOfflineMode

Essa configuração impede que os usuários habilitem o modo offline no OneDrive na Web.

As preferências para essa configuração são armazenadas nos seguintes arquivos .plist.

Local de preferências de modo offline Preferências de grupo do OneDrive
Local do .plist ~/Library/Preferences/com.microsoft.SharePoint-mac.plist ~/Biblioteca/Contêineres de Grupo/UBF8T346G9. OneDriveStandaloneSuite/Library/Preferences/UBF8T346G9. OneDriveStandaloneSuite.plist

Por padrão, o modo offline é ativado para usuários do OneDrive na Web.

Para impedir que os usuários da sua organização habilitem o modo offline no OneDrive na Web, use o seguinte exemplo:

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

Para habilitar novamente o modo offline no OneDrive na Web para usuários, use o seguinte exemplo:

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

DisableOfflineModeForExternalLibraries

Essa configuração impede que os usuários habilitem o modo offline no OneDrive na Web para bibliotecas e pastas compartilhadas de outras organizações.

As preferências para essa configuração são armazenadas nos seguintes arquivos .plist:

Local de preferências de modo offline Preferências de grupo do OneDrive
Local do .plist ~/Library/Preferences/com.microsoft.SharePoint-mac.plist ~/Biblioteca/Contêineres de Grupo/UBF8T346G9. OneDriveStandaloneSuite/Library/Preferences/UBF8T346G9. OneDriveStandaloneSuite.plist

Para impedir que os usuários da sua organização habilitem o modo offline no OneDrive na Web para bibliotecas e pastas compartilhadas de outras organizações, use o seguinte exemplo:

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

Para habilitar novamente o modo offline no OneDrive na Web para bibliotecas e pastas compartilhadas de outras organizações, use o seguinte exemplo:

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

DisablePersonalSync

Essa configuração impede que os usuários entrem e sincronizem arquivos em contas pessoais do OneDrive. Se essa configuração tiver sido configurada depois que um usuário tiver configurado a sincronização com um conta pessoal, o usuário será conectado.

Se você definir o valor da configuração como True, os usuários serão impedidos de adicionar ou sincronizar contas pessoais.

O exemplo dessa configuração no arquivo .plist é:

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

DisableTutorial

Essa configuração impede que o tutorial seja mostrado aos usuários depois que eles configurarem o OneDrive.

Se você definir o valor dessa configuração como True, o tutorial será impedido de ser mostrado aos usuários depois que eles configurarem o aplicativo Sincronização do OneDrive.

O exemplo dessa configuração no arquivo .plist é:

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

DownloadBandwidthLimited

Essa configuração define a taxa máxima de taxa de transferência de download em quilobytes (KB)/s para computadores que executam o aplicativo Sincronização do OneDrive.

Defina o valor dessa configuração como um inteiro entre 50 e 100000 para especificar a taxa de transferência de download em KB/s que o aplicativo de sincronização pode usar.

O exemplo dessa configuração no arquivo .plist é:

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

EnableAllOcsiClients

Essa configuração permite que vários usuários usem os aplicativos do Microsoft 365 Apps para empresas, Office 2019 ou Office 2016 para editar simultaneamente um arquivo do Office armazenado no OneDrive. Ela também permite que os usuários compartilhem arquivos a partir dos aplicativos da área de trabalho do Office.

Importante

Recomendamos manter essa configuração habilitada para tornar a sincronização mais rápida e reduzir o uso de largura de banda de rede. Confira todas as nossas recomendações para configurar o aplicativo de sincronização.

Se você definir essa configuração como True ou não definir essa configuração, a guia Office será exibida em Sincronização do OneDrive preferências e usar aplicativos do Office para sincronizar arquivos do Office que abro está selecionado, por padrão.

Se você definir essa configuração como False, a guia office estará oculta no aplicativo de sincronização e o coautoria e o compartilhamento no aplicativo para arquivos do Office serão desabilitados. O Usuário pode escolher como lidar com arquivos do Office na configuração de conflito é desabilitado e, quando ocorrem conflitos de arquivo, ambas as cópias do arquivo são mantidas. Para obter mais informações sobre as configurações no aplicativo de sincronização, consulte Usar aplicativos do Office para sincronizar arquivos do Office que abro.

O exemplo dessa configuração no arquivo .plist é:

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

EnableODIgnore

Essa configuração permite inserir palavras-chave para impedir que o aplicativo Sincronização do OneDrive carregue determinados arquivos no OneDrive ou no SharePoint. Você pode inserir nomes completos, como "setup.exe" ou usar o asterisco () como um caractere curinga para representar uma série de caracteres, como.pst. Palavras-chave não diferenciam maiúsculas de minúsculas.

Se você habilitar essa configuração, o aplicativo de sincronização não carregará novos arquivos que correspondem às palavras-chave que você especificou. Nenhum erro é exibido para os arquivos ignorados e eles permanecem na pasta local do OneDrive. No Finder, os arquivos aparecem com um ícone "Excluído da sincronização".

Os usuários também verão uma mensagem no centro de atividades do OneDrive explicando por que os arquivos não estão sincronizando.

O exemplo dessa configuração no arquivo .plist é:

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

EnableSyncAdminReports

Essa configuração permite que o Sincronização do OneDrive dispositivo de relatório de aplicativo e os dados de integridade que devem ser incluídos em relatórios de administrador de sincronização. Você deve habilitar essa configuração nos dispositivos dos quais deseja obter relatórios. Para obter mais informações sobre esses relatórios, consulte Sincronização do OneDrive relatórios no Centro de Administração de Aplicativos.

Se você desabilitar ou não configurar essa configuração, Sincronização do OneDrive dispositivo de aplicativo e os dados de integridade não aparecerão nos relatórios de administrador de sincronização.

O exemplo a seguir mostra como essa configuração se parece no arquivo .plist:

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

FilesOnDemandEnabled

Essa configuração especifica se arquivos sob demanda estão habilitados.

Observação

A partir do macOS Monterey 12.1, arquivos sob demanda estarão permanentemente habilitados e essa configuração não terá mais efeito.

Versões do macOS anteriores ao Monterey 12.1

Se você definir essa configuração como True, FilesOnDemand estará habilitado e os usuários que configurarem o aplicativo de sincronização poderão exibir os arquivos somente online, por padrão.

Se você definir essa configuração como False, FilesOnDemand será desabilitado e os usuários não poderão ativá-la.

O exemplo dessa configuração no arquivo .plist é:

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

Observação

Recomendamos manter Arquivos Sob Demanda habilitado. Veja todas as nossas recomendações para configurar o aplicativo de sincronização

HideDockIcon

Essa configuração especifica se um ícone de encaixe do OneDrive é mostrado.

Se você definir o valor dessa configuração como True, o ícone de encaixe do OneDrive ficará oculto mesmo se o aplicativo estiver em execução.

O exemplo dessa configuração no arquivo .plist é:

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

HydrationDisallowedApps

Essa configuração impede que os aplicativos baixem automaticamente arquivos somente online. Você pode usar essa configuração para bloquear aplicativos que não funcionam corretamente com a implantação de Arquivos Sob Demanda.

Para habilitar essa configuração, você deve definir uma cadeia de caracteres no formato JSON, conforme descrito abaixo:
[{"ApplicationId":"appId","MaxBundleVersion":"1.1","MaxBuildVersion":"1.0"}]
"appID" pode ser o nome do processo BSD ou o nome de exibição do pacote. "MaxBuildVersion" denota a versão máxima de build do aplicativo que será bloqueada. "MaxBundleVersion" denota a versão máxima do pacote do aplicativo que será bloqueada.

O exemplo dessa configuração no arquivo .plist é:

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

KFMBlockOptIn

Essa configuração impede que os usuários movam suas pastas Documentos e Área de Trabalho para qualquer conta do OneDrive.

Se você habilitar o KFMBlockOptIn, os usuários não serão solicitados a proteger suas pastas Desktop e Documentos e o comando Gerenciar backup será desabilitado. Se o usuário já tiver movido suas pastas Desktop e Documentos, os arquivos nessas pastas permanecerão no OneDrive. Essa configuração não terá efeito se você tiver habilitado KFMOptInWithWizard" ou KFMSilentOptIn.

Se você definir o valor dessa configuração como 1, ele impedirá o Backup de Pastas. Se você definir o valor como 2, ele redirecionará todas as pastas usadas anteriormente para Backup de Pasta para o dispositivo do usuário e impedirá que a configuração seja executada ainda mais.

O exemplo dessa configuração no arquivo .plist é:

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

KFMBlockOptOut

Essa configuração força os usuários a manter suas pastas Documentos e Área de Trabalho direcionadas ao OneDrive.

Se você habilitar essa configuração, o botão Parar Backup na janela Gerenciar Backup de Pastas será desabilitado e os usuários receberão um erro se tentarem parar de sincronizar a pasta Desktop ou Documentos.

O exemplo dessa configuração no arquivo .plist é:

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

KFMOptInWithWizard

Essa configuração exibe um assistente que solicita que os usuários movam suas pastas Documentos e Área de Trabalho para o OneDrive.

Se você habilitar essa configuração e fornecer sua ID de locatário, os usuários que estão sincronizando o OneDrive verão a janela assistente de backup de pasta quando eles são conectados. Se eles fecharem a janela, uma notificação de lembrete será exibida no Centro de Atividades de Sincronização até moverem as pastas Desktop e Documentos.

O exemplo dessa configuração no arquivo .plist é:

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

KFMSilentOptIn

Use essa configuração para redirecionar e mover as pastas Documentos e/ou Área de Trabalho dos usuários para o OneDrive sem qualquer interação do usuário.

Você pode mover as duas pastas ao mesmo tempo ou selecionar qual pasta deseja mover. Depois que uma pasta for movida, essa configuração não afetará essa pasta novamente.

O exemplo dessa configuração no arquivo .plist é:

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

Se você habilitar essa configuração e fornecer sua ID de locatário, poderá escolher se deve exibir uma notificação aos usuários depois que suas pastas tiverem sido redirecionadas:

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

Se você não definir nenhuma das configurações a seguir, a configuração padrão moverá ambas as pastas para o OneDrive. Se você quiser especificar qual pasta mover, defina qualquer combinação das seguintes configurações:

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

OpenAtLogin

Essa configuração especifica se o OneDrive começa automaticamente quando o usuário faz logon.

Se você definir o valor dessa configuração como True, o OneDrive será iniciado automaticamente quando o usuário fizer logon no Mac.

O exemplo dessa configuração no arquivo .plist é:

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

SharePointOnPremFrontDoorUrl

Essa configuração especifica a URL SharePoint Server 2019 local com a qual o aplicativo Sincronização do OneDrive deve tentar autenticar e sincronizar.

Para habilitar essa configuração, você deve definir uma cadeia de caracteres que contém a URL do SharePoint Server local.

O exemplo dessa configuração no arquivo .plist é:

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

Mais informações sobre como configurar o aplicativo Sincronização do OneDrive para SharePoint Server 2019

SharePointOnPremPrioritizationPolicy

Essa configuração determina se o aplicativo de sincronização deve ou não configurar a sincronização para o SharePoint Server local ou o SharePoint no Microsoft 365 primeiro durante o cenário de primeira execução, quando a conta é a mesma para o SharePoint Server e o SharePoint no Microsoft 365 em um cenário híbrido.

Se você definir o valor dessa configuração como 1, o aplicativo Sincronização do OneDrive configurará o SharePoint Server primeiro, seguido pelo SharePoint no Microsoft 365.

O exemplo dessa configuração no arquivo .plist é:

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

SharePointOnPremTenantName

Essa configuração permite especificar o nome da pasta criada para sincronizar os arquivos SharePoint Server 2019 especificados na URL do Front Door.

Se essa configuração estiver habilitada, você poderá especificar um TenantName que é o nome que a pasta usa na seguinte convenção: OneDrive – TenantName (especificado por você) TenantName (especificado por você)

Se você não especificar nenhum TenantName, a pasta usará o primeiro segmento do FrontDoorURL como seu nome. Por exemplo, https://Contoso.SharePoint.com usa Contoso como o Nome do Locatário na seguinte convenção: OneDrive – Contoso

O exemplo dessa configuração no arquivo .plist é:

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

Mais informações sobre como configurar o aplicativo Sincronização do OneDrive para SharePoint Server 2019

Camada

Essa configuração permite especificar o anel de atualização do aplicativo de sincronização para usuários em sua organização. O aplicativo Sincronização do OneDrive é atualizado para o público por meio de três anéis; primeiro para Insiders, depois para Produção e, finalmente, para Adiado. Ao habilitar essa configuração e selecionar um anel, os usuários não poderão alterá-lo.

Recomendamos selecionar várias pessoas em seu departamento de TI como usuários pioneiros para ingressar na fase Insiders e receber os recursos antecipadamente. Também recomendamos deixar todos os outros na organização no anel de produção padrão para garantir que eles recebam correções de bugs e novos recursos em tempo hábil. Confira todas as nossas recomendações para configurar o aplicativo de sincronização.

Insiders: os usuários do anel Insiders recebem builds que permitem visualizar novos recursos que chegam ao OneDrive.

Produção: os usuários do anel de produção obtêm os recursos mais recentes à medida que se tornam disponíveis. Essa é a fase padrão.

Enterprise (também conhecido como "Adiado"): os usuários do anel Enterprise recebem novos recursos, correções de bugs e melhorias de desempenho por último. Essa fase permite implantar atualizações de um local de rede interno e controlar o tempo da implantação (em um prazo de 60 dias).

Para obter mais informações sobre os builds disponíveis atualmente em cada anel, confira as notas de versão do OneDrive. Para obter mais informações sobre os anéis de atualização e como o aplicativo de sincronização verifica se há atualizações, consulte o processo de atualização do aplicativo Sincronização do OneDrive.

Local do .plist Domínio
~/Library/Preferences/com.microsoft.OneDriveUpdater.plist com.microsoft.OneDriveUpdater

O exemplo dessa configuração no arquivo .plist é:

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

Observação

Se você quiser ocultar a opção "Obter atualizações internas da Microsoft de pré-lançamento a serem exibidas", você precisará optar pelo anel de atualização adiada. Por exemplo, defaults write com.microsoft.OneDrive Tier -string "Deferred".

UploadBandwidthLimited

Essa configuração define a taxa de taxa de transferência de carregamento máxima para computadores que executam o aplicativo Sincronização do OneDrive.

Para habilitar essa configuração, defina um valor entre 50 e 100000 que é a taxa de taxa de transferência de carregamento em KB/s que o aplicativo de sincronização pode usar.

O exemplo dessa configuração no arquivo .plist é:

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

Localizar sua ID de locatário do Microsoft 365

Sincronização do OneDrive relatórios no Centro de Administração de Aplicativos (EnableSyncAdminReports)