Installare School Data Sync Toolkit

Importante :  Il presente articolo è stato tradotto automaticamente, vedere la dichiarazione di non responsabilità. Per visualizzare la versione inglese dell'articolo, fare clic qui.

È possibile usare School Data Sync Toolkit per convalidare i file CSV e verificare la presenza di errori, eseguire una sincronizzazione manuale dei file CSV da PowerShell e automatizzare il processo di sincronizzazione dei file CSV secondo le proprie esigenze.

In questo argomento

Installare Microsoft School Data Sync Toolkit

  1. Scaricare lo strumento da Microsoft School Data Sync Toolkit.

  2. Fare doppio clic sullo strumento per eseguire la procedura guidata.

  3. Nella pagina Introduzione fare clic su Avanti.

    Scegliere Avanti nella pagina iniziale della configurazione di Microsoft School Data Sync Toolkit
  4. Accettare il contratto di licenza, fare clic su Avanti, scegliere un percorso di installazione, quindi scegliere Avanti.

    Scegliere il percorso di installazione per Microsoft School Data Sync Toolkit
  5. Scegliere Installa > Fine.

Funzionalità di School Data Sync Toolkit

Dopo aver installato il toolkit e aver creato il profilo iniziale nel portale di School Data Sync, è possibile usare lo script seguente per caricare altri file CSV a intervalli regolari o in base alla necessità. Il programma di installazione consente di eseguire diversi cmdlet da una sessione di amministrazione di PowerShell nel computer per distribuire correttamente School Data Sync. Vedere le sezioni seguenti per una descrizione e un caso di utilizzo per ogni cmdlet.

Usare School Data Sync Toolkit per convalidare i dati dei file CSV (pre-sincronizzazione)

Per usare il toolkit per convalidare i file CSV prima di caricarli per la sincronizzazione, aprire PowerShell come amministratore e usare il cmdlet Start-CsvFilesValidation come descritto nella sintassi riportata di seguito e negli esempi.

Sintassi di Start-CsvFilesValidation

Usare il cmdlet Start-CsvFilesValidation per convalidare i file CSV per un profilo di sincronizzazione specificato.

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

Parametro

Descrizione

CsvFolderPath

Percorso della cartella che contiene i file CSV.

ProfileName

Nome del profilo creato in School Data Sync per i file CSV da convalidare.

UserName

Nome utente dell'account di amministratore con diritti di amministratore globale per il tenant di Office 365.

L'esempio seguente esegue una convalida sul lato client dei file CSV che si trovano nella directory c:\temp del computer locale per un profilo denominato "School 1" usando l'account di amministratore globale admin@contoso.com.

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

Usare School Data Sync Toolkit per sincronizzare i file CSV

Per caricare e sincronizzare i file CSV con School Data Sync, aprire PowerShell come amministratore e usare il cmdlet Send-CsvFiles come descritto nella sintassi riportata di seguito e nell'esempio.

Sintassi di Send-CsvFiles

Usare il cmdlet Send-CsvFiles per caricare e sincronizzare i file CSV per un profilo di sincronizzazione specificato.

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

Parametro

Descrizione

CsvFolderPath

Percorso della cartella che contiene i file CSV.

ProfileName

Nome del profilo creato in School Data Sync per i file CSV da convalidare.

UserName

Nome utente dell'account di amministratore con diritti di amministratore globale per il tenant di Office 365.

L'esempio seguente carica e sincronizza un set di file CSV che si trova nella directory c:\temp del computer locale per un profilo denominato "School 1" usando l'account di amministratore globale "admin@contoso.com".

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

Usare School Data Sync Toolkit per configurare la sincronizzazione automatica dei file CSV

È possibile pianificare sincronizzazioni automatizzate tra i file CSV archiviati in locale e il profilo di sincronizzazione SDS in Office 365. A questo scopo, aprire PowerShell come amministratore e usare il cmdlet Add-CsvFileSyncTask come descritto nella sintassi riportata di seguito e nell'esempio. Dopo aver completato l'attività programmata, è possibile monitorare l'avanzamento e la cronologia di queste sincronizzazioni automatizzate visualizzando l'attività programmata appena creata nell'utilità di pianificazione. Questa attività programmata viene eseguita ogni giorno a mezzanotte, a meno che non si modifica l'ora di inizio usando il parametro seguente.

Quando si esegue questo comando, viene richiesto di eseguire l'autenticazione. La prima richiesta di autenticazione richiede le credenziali di amministratore globale e contiene già il nome utente specificato nel comando seguente, sotto il parametro del nome utente. Dopo aver immesso la password e fatto clic su INVIO, si riceve una seconda richiesta di autenticazione di base. Qui vanno immessi il nome utente dell'amministratore locale e la password, che saranno le credenziali usate per eseguire quotidianamente l'attività programmata, ogni volta che viene avviata. Se si include il parametro StoreCredentials, le credenziali dell'account di amministratore locale vengono archiviate in Gestione credenziali e continuano a funzionare finché la password rimane invariata. Se non si specifica il parametro StoreCredentials, viene concesso un token di autenticazione con una durata massima di 90 giorni. Sarà necessario eseguire di nuovo il comando dopo la scadenza del token di autenticazione, quando non potrà più essere autenticato durante l'esecuzione dell'attività programmata.

Sintassi di Add-CsvFileSyncTask

Usare il cmdlet Add-CsvFileSyncTask per caricare e sincronizzare i file CSV per un profilo di sincronizzazione specificato.

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

Parametro

Descrizione

CSVFolderPath

Percorso della cartella contenente i file CSV che verranno sincronizzati a intervalli regolari.

ProfileName

Nome del profilo di sincronizzazione SDS in base al quale vengono sincronizzati i file CSV.

UserName

UserPrincipalName dell'account di amministratore globale da usare con SDS.

LogPath

Percorso della directory in cui si vogliono archiviare i file di log della convalida.

RedirectOutput

Consente di scrivere l'output del parametro di convalida fuori dalla directory specificata. È obbligatorio se si vogliono esaminare i risultati del parametro di convalida.

Validate

Eseguire l'operazione di convalida prima di ogni sincronizzazione. Crea un file nella directory Logpath se è incluso anche il parametro RedirectOutput.

TaskUserName

Nome per l'attività programmata.

TaskStartTime

Ora del giorno in cui viene avviata l'attività programmata.

StoreCredentials

Crea una voce in Gestione credenziali per l'esecuzione dell'attività programmata. Le credenziali restano valide e funzionanti finché la password associata all'account non scade.

L'esempio seguente crea un'attività programmata di sincronizzazione automatica per i file CSV che si trovano nella cartella C:\temp in un profilo di sincronizzazione denominato SDSSync, crea i file di log della convalida nella cartella C:\temp\logs e imposta la directory C:\temp\SDS\Logs come percorso per tutti i file di log generati. Questo comando esegue anche il processo di convalida per i file CSV prima di iniziare la sincronizzazione e salva l'output di convalida nella stessa directory c:\temp\logs.

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

Usare School Data Sync Toolkit per convertire i file CSV di OneRoster

È possibile usare il toolkit per convertire i file CSV di OneRoster e sincronizzarli con School Data Sync. A questo scopo, aprire PowerShell come amministratore e usare il cmdlet Convert-OneRostertoMicrosoftSDS come descritto nella sintassi riportata di seguito e nell'esempio. Dopo aver completato la conversione, è possibile sincronizzare i file CSV con SDS, seguendo le istruzioni di sincronizzazione standard per file CSV.

Sintassi di Convert-OneRostertoMicrosoftSDS

Usare il cmdlet Convert-OneRostertoMicrosoftSDS per caricare e sincronizzare i file CSV per un profilo di sincronizzazione specificato.

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

Parametro

Descrizione

OneRosterFolderPath

Percorso della cartella che contiene i file CSV esportati da OneRoster.

SDSFolderPath

Percorso della cartella in cui verranno creati i file CSV convertiti.

LogPath

Percorso della cartella in cui si vuole archiviare la registrazione di queste azioni.

L'esempio seguente converte un set di file CSV di OneRoster che si trova nella cartella C:\temp\OneRoster, crea un nuovo set di file CSV nella directory C:\temp\SDS del computer locale e imposta la directory C:\temp\SDS\Logs come percorso per tutti i file di log generati.

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

Usare School Data Sync Toolkit per convalidare i dati dei file CSV (post-sincronizzazione)

Per usare il toolkit per convalidare i file CSV dopo aver caricato e sincronizzato un set di file CSV, aprire PowerShell come amministratore e usare il cmdlet Compare-DirectoryToCSVFiles come descritto nella sintassi riportata di seguito e negli esempi.

Sintassi di Compare-DirectoryToCSVFiles

Usare il cmdlet Compare-DirectoryToCSVFiles per convalidare i file CSV per un profilo di sincronizzazione specificato.

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

Parametro

Descrizione

CsvFolderPath

Percorso della cartella che contiene i file CSV.

ProfileName

Nome del profilo creato in School Data Sync per i file CSV da convalidare.

UserName

Nome utente dell'account di amministratore con diritti di amministratore globale per il tenant di Office 365.

L'esempio seguente esegue una convalida sul lato client dei file CSV che si trovano nella directory c:\temp del computer locale per un profilo denominato "School 1" usando l'account di amministratore globale "admin@contoso.com".

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

Nota : Dichiarazione di non responsabilità per la traduzione automatica: Il presente articolo è stato tradotto tramite un software di traduzione automatica e non da una persona. Microsoft offre le traduzioni automatiche per consentire a coloro che non conoscono la lingua inglese di leggere gli articoli sui prodotti, sui servizi e sulle tecnologie Microsoft. Dal momento che l'articolo è stato tradotto automaticamente, potrebbe contenere errori di sintassi, di grammatica o di utilizzo dei vocaboli.

Vedere anche

Informazioni generali su School Data Sync e Classroom

File CSV per School Data Sync

Attributi obbligatori di School Data Sync per PowerSchool Sync

Come distribuire School Data Sync con i file CSV

Come distribuire School Data Sync usando PowerSchool Sync

Come distribuire School Data Sync con Clever Sync

Come distribuire School Data Sync con i file CSV di OneRoster

Errori e risoluzione dei problemi di School Data Sync

Amplia le tue competenze
Esplora i corsi di formazione
Ottieni in anticipo le nuove caratteristiche
Partecipa al programma Office Insider

Queste informazioni sono risultate utili?

Grazie per i tuoi commenti e suggerimenti

Grazie per il tuo feedback! Potrebbe essere utile metterti in contatto con uno dei nostri operatori del supporto di Office.

×