Instalar o Kit de ferramentas do School Data Sync

Importante :  Este artigo foi traduzido por um sistema de tradução automática, leia o aviso de isenção de responsabilidade. Para sua referência, veja a versão em inglês deste artigo aqui.

Você pode usar o Kit de Ferramentas do School Data Sync para validar os arquivos CSV e verificar se há erros, realizar uma sincronização manual de CSV a partir do PowerShell e automatizar o processo de sincronização de CSV de acordo com suas necessidades.

Neste tópico:

Instalar o Kit de Ferramentas do Microsoft School Data Sync

  1. Baixe a ferramenta do Kit de Ferramentas do Microsoft School Data Sync.

  2. Clique duas vezes na ferramenta para executar o assistente.

  3. Na página de Boas-vindas, escolha Avançar.

    Escolha Avançar na página de boas-vindas da Instalação do Kit de ferramentas do Microsoft SChool Data Sync
  4. Aceite o contrato de licença > clique em Avançar, escolha um caminho de instalação e, em seguida, escolha Avançar.

    Escolha o caminho de instalação do Kit de ferramentas do Microsoft School Data Sync
  5. Escolha Instalar > Concluir.

Recursos do Kit de Ferramentas do School Data Sync

Após você instalar o kit de ferramentas e criar o perfil inicial no portal do School Data Sync, você pode usar o seguinte script para carregar arquivos CSV adicionais de forma regular ou conforme necessário. O instalador permite executar vários cmdlets de uma sessão do PowerShell de administrador em seu computador, para ajudar você a implantar o School Data Sync. Veja as seguintes seções para obter uma descrição e um caso de uso para cada cmdlet.

Usar o Kit de Ferramentas do School Data Sync para validar dados de arquivo CSV (pré-sincronização)

Para usar o kit de ferramentas para validar os arquivos CSV antes de você carregar os arquivos para a sincronização, abra o PowerShell como administrador e use o cmdlet Start-CsvFilesValidation conforme descrito pela sintaxe e exemplos seguintes.

Sintaxe de Start-CsvFilesValidation

Use o cmdlet Start-CsvFilesValidation para validar os arquivos CSV para um perfil de sincronização específico.

Start-CsvFilesValidation -CsvFolderPath <String> -ProfileName <String> -UserName <String>

Parâmetro

Descrição

CsvFolderPath

Caminho para a pasta que contém os arquivos CSV.

ProfileName

Nome do perfil que você criou no School Data Sync para os CSVs que você deseja validar.

UserName

O nome de usuário da conta de administrador com direitos de Administrador Global para o locatário do Office 365.

O exemplo a seguir executa a validação do lado do cliente de arquivos CSV localizados no diretório c:\temp do computador local, para um perfil chamado "Escola 1", usando a conta de administrador global, admin@contoso.com.

Start-CsvFilesValidation –CsvFolderPath “c:\temp” –ProfileName “School 1” –UserName admin@contoso.com

Usar o Kit de Ferramentas do School Data Sync para sincronizar arquivos CSV

Para carregar e sincronizar arquivos CSV com o School Data Sync, abra o PowerShell como administrador e use o cmdlet Send-CsvFiles conforme descrito pela sintaxe e exemplo seguintes.

Sintaxe de Send-CsvFiles

Use o cmdlet Send-CsvFiles para carregar e sincronizar arquivos CSV para um perfil de sincronização específico.

Send-CsvFiles -CsvFolderPath <String> -ProfileName <String> -UserName <String>

Parâmetro

Descrição

CsvFolderPath

Caminho para a pasta que contém os arquivos CSV.

ProfileName

Nome do perfil que você criou no School Data Sync para os CSVs que você deseja validar.

UserName

O nome de usuário da conta de administrador com direitos de Administrador Global para o locatário do Office 365.

O exemplo a seguir carrega e sincroniza um conjunto de arquivos CSV localizados no diretório c:\temp do computador local, para um perfil chamado "Escola 1", usando a conta de administrador global "admin@contoso.com".

Send-CsvFiles –CsvFolderPath “c:\temp” –ProfileName “School 1” –UserName “admin@contoso.com”

Usar o Kit de Ferramentas do School Data Sync para configurar a sincronização automatizada de CSV

Você pode agendar sincronizações autônomas automatizadas entre seus arquivos CSV armazenados localmente e seu perfil do SDS Sync no Office 365. Para fazer isso, abra o PowerShell como administrador e use o cmdlet Add-CsvFileSyncTask conforme descrito pela sintaxe e exemplo seguintes. Após a conclusão da tarefa agendada, você pode monitorar o andamento e o histórico dessas sincronizações automatizadas consultando a tarefa agendada recém-criada no Agendador de Tarefas. Esta tarefa agendada será executada diariamente à meia-noite, a menos que você modifique a hora de início usando o parâmetro abaixo.

Ao executar este comando, você será solicitado a autenticar-se. O primeiro prompt de autenticação solicitará suas credenciais de Administrador Global e já conterá o nome de usuário que você especificar no comando abaixo, sob o parâmetro de nome de usuário. Após inserir sua senha e clicar em Inserir, você receberá um segundo aviso de autenticação básica. Aqui você deve digitar o nome de usuário e senha do administrador local, que serão as credenciais usadas para se executar a tarefa agendada, cada vez que ela for iniciada diariamente. Se você incluir o parâmetro StoreCredentials, as credenciais da conta de administrador local serão armazenadas no Gerenciador de Credenciais e continuarão funcionando desde que a senha permaneça inalterada. Se você não especificar o parâmetro StoreCredentials, receberá um token de autenticação, que tem um tempo de vida máximo de 90 dias. Isso exigirá que você execute o comando novamente depois que o token de autenticação expirar e não puder mais autenticar ao executar a tarefa agendada.

Sintaxe de Add-CsvFileSyncTask

Use o cmdlet Add-CsvFileSyncTask para carregar e sincronizar arquivos CSV para um perfil de sincronização específico.

Add-CsvFileSyncTask -CSVFolderPath <path to csv file location> -ProfileName <name of sync profile in SDS> -LogPath <path to store logs> -UserName <global admin account> -Validate -RedirectOutput

Parâmetro

Descrição

CSVFolderPath

Caminho para a pasta que contém os arquivos CSV que serão sincronizados regularmente.

ProfileName

Nome do perfil de sincronização do SDS com o qual você está sincronizando arquivos CSV.

UserName

UserPrincipalName da conta de Administrador Global a ser usado com o SDS.

LogPath

Caminho para o diretório em que você gostaria de armazenar seus arquivos de log de validação.

RedirectOutput

Permite que a saída do parâmetro de validação seja escrita por extenso no diretório especificado. Isso é necessário caso você queira examinar os resultados do parâmetro de validação.

Validar

Execute a tarefa de validação antes de cada sincronização. Cria um arquivo no diretório Logpath se o parâmetro RedirectOutput também estiver incluído.

TaskUserName

Nome para a tarefa agendada.

TaskStartTime

Hora do dia em que a tarefa agendada iniciará.

StoreCredentials

Cria uma entrada no Gerenciador de Credenciais para executar a tarefa agendada. A credencial permanecerá válida e continuará funcionando, a menos que a senha associada a esta conta expire.

O exemplo a seguir cria uma tarefa agendada de sincronização automatizada para arquivos CSV localizados na pasta C:\temp, em um perfil de sincronização chamado SDSSync, cria arquivos de log de validação na pasta C:\temp\logs e define o diretório C:\temp\SDS\Logs como o local para todos os arquivos de log gerados. Esse comando também executa o processo de validação para os CSVs antes de a sincronização começar e salva a saída de validação no mesmo diretório c:\temp\logs.

Add-CsvFileSyncTask -CSVFolderPath “C:\temp” -ProfileName “SDSSync” -LogPath “C:\temp\logs” -UserName admin@contoso.com -Validate -RedirectOutput

Usar o Kit de Ferramentas do School Data Sync para converter arquivos CSV do OneRoster

Você pode usar o Kit de Ferramentas para converter os arquivos CSV do OneRoster e sincronizá-los com o School Data Sync. Para fazer isso, abra o PowerShell como administrador e use o cmdlet Convert-OneRostertoMicrosoftSDS conforme descrito pela sintaxe e exemplo seguintes. Após a conclusão da conversão, você poderá sincronizar esses arquivos CSV por meio do SDS, seguindo nossa orientação padrão de sincronização de CSV.

Sintaxe de Convert-OneRostertoMicrosoftSDS

Use o cmdlet Convert-OneRostertoMicrosoftSDS para carregar e sincronizar arquivos CSV para um perfil de sincronização especificado.

Convert-OneRostertoMicrosoftSDS -OneRosterFolderPath <String> -SDSFolderPath <String> -LogPath <String>

Parâmetro

Descrição

OneRosterFolderPath

Caminho para a pasta que contém os arquivos CSV exportados do OneRoster.

SDSFolderPath

Caminho da pasta em que os arquivos CSV convertidos serão criados.

LogPath

Caminho para a pasta em que você deseja que o registro em log seja armazenado nessas ações.

O seguinte exemplo converte um conjunto de arquivos CSV do OneRoster localizados na pasta C:\temp\OneRoster, cria um novo conjunto de arquivos CSV localizados no diretório C:\temp\SDS do computador local e define o diretório C:\temp\SDS\Logs como o local para todos os arquivos de log gerados.

Convert-OneRostertoMicrosoftSDS -OneRosterFolderPath “C:\temp\OneRoster” -SDSFolderPath “C:\temp\SDS” -LogPath “C:\temp\SDS\logs”

Usar o Kit de Ferramentas do School Data Sync para validar dados de arquivo CSV (pós-sincronização)

Para usar o Kit de Ferramentas para validar arquivos CSV depois que você carregar e sincronizar um conjunto de arquivos CSV, abra o PowerShell como administrador e use o cmdlet Compare-DirectoryToCSVFiles conforme descrito pela sintaxe e exemplos seguintes.

Sintaxe de Compare-DirectoryToCSVFiles

Use o cmdlet Compare-DirectoryToCSVFiles para validar arquivos CSV de um perfil de sincronização específico.

Compare-DirectoryToCSVFiles -CsvFolderPath <String> -ProfileName <String> -UserName <String>

Parâmetro

Descrição

CsvFolderPath

Caminho para a pasta que contém os arquivos CSV.

ProfileName

Nome do perfil que você criou no School Data Sync para os CSVs que você deseja validar.

UserName

O nome de usuário da conta de administrador com direitos de Administrador Global para o locatário do Office 365.

O exemplo a seguir executa a validação do lado do cliente de arquivos CSV localizados no diretório c:\temp do computador local, para um perfil chamado "Escola 1", usando a conta de administrador global "admin@contoso.com".

Compare-DirectoryToCsvFiles –CsvFolderPath “c:\temp” –ProfileName “School 1” –UserName “admin@contoso.com”

Observação : Aviso de Isenção de Tradução Automática: Este artigo foi traduzido por computador, sem intervenção humana. A Microsoft oferece essas traduções automáticas para ajudar as pessoas que não falam inglês a aproveitar os textos escritos sobre produtos, serviços e tecnologias da Microsoft. Como este artigo foi traduzido automaticamente, é possível que contenha erros de vocabulário, sintaxe ou gramática.

Consulte Também

Visão geral do School Data Sync e do Classroom

Arquivos CSV para o School Data Sync

Atributos necessários do School Data Sync para o PowerSchool Sync

Como implantar o School Data Sync usando arquivos CSV

Como implantar o School Data Sync usando o PowerSchool Sync

Como implantar o School Data Sync usando o Clever Sync

Como implantar o School Data Sync usando arquivos CSV do OneRoster

Erros e solução de problemas do School Data Sync

Expanda suas habilidades
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×