Usare lo strumento di connessione del servizio per Configuration Manager

  • Articolo

Si applica a: Configuration Manager (Current Branch)

Usare lo strumento di connessione del servizio quando il punto di connessione del servizio è in modalità offline. È anche possibile usarlo quando i server del sistema del sito di Configuration Manager non sono connessi a Internet. Lo strumento consente di mantenere aggiornato il sito con gli aggiornamenti più recenti di Configuration Manager.

Quando si esegue lo strumento, si connette al servizio cloud di Configuration Manager, carica le informazioni sull'utilizzo per la gerarchia e scarica gli aggiornamenti. Il caricamento dei dati di utilizzo è necessario per consentire al servizio cloud di fornire gli aggiornamenti corretti per l'ambiente.

Prerequisiti

  • Il sito ha un punto di connessione del servizio e lo si configura per una connessione offline su richiesta.

  • Eseguire lo strumento da un prompt dei comandi come amministratore. Non esiste un'interfaccia utente.

  • Lo strumento viene eseguito dal punto di connessione del servizio e da un computer in grado di connettersi a Internet. Ognuno di questi computer deve avere un sistema operativo a 64 bit e avere i componenti seguenti:

    • Sia i file di Visual C++ Redistributable x86 che x64. Per impostazione predefinita, Configuration Manager installa la versione x64 nel computer che ospita il punto di connessione del servizio. Questo strumento richiede il pacchetto ridistribuibile di Microsoft Visual C++ 2015-2019 (14.28.29914.0) o versione successiva nel computer da cui viene eseguito. Per scaricare questo componente, vedere Download supportati più recenti di Microsoft Visual C++ Redistributable.

      Nota

      Se si esegue l'aggiornamento da una versione fuori supporto di Configuration Manager precedente alla 2107, lo strumento richiede visual C++ 2013 redistributalbe packate (12.0.40660.0), disponibile dallo stesso collegamento.

    • Questo strumento richiede .NET versione 4.6.2 e la versione 4.8 è consigliata. Per altre informazioni, vedere Prerequisiti del sito e del sistema del sito.

    • A partire dalla versione 2309, questo strumento richiede l'installazione del driver ODBC 18 per SQL Server (x64). Per scaricare questo componente, vedere Scaricare il driver ODBC per SQL Server.

  • L'account usato per eseguire lo strumento richiede le autorizzazioni seguenti:

    • Amministratore locale nel computer che ospita il punto di connessione del servizio

    • Autorizzazioni di lettura per il database del sito

  • È necessario un metodo per trasferire i file tra il computer con accesso a Internet e il punto di connessione del servizio. Ad esempio, un'unità USB con spazio disponibile sufficiente per archiviare i file e gli aggiornamenti.

Panoramica

  1. Preparazione: eseguire lo strumento nel punto di connessione del servizio. Inserisce i dati di utilizzo in un file .cab nel percorso specificato. Copiare il file di dati nel computer con una connessione Internet.

  2. Connetti: eseguire lo strumento nel computer con una connessione Internet. Carica i dati di utilizzo e quindi scarica gli aggiornamenti di Configuration Manager. Copiare gli aggiornamenti scaricati nel punto di connessione del servizio.

    È possibile caricare più file di dati contemporaneamente, ognuno da una gerarchia diversa. È anche possibile specificare un server proxy e un utente per il server proxy.

  3. Importa: eseguire lo strumento nel punto di connessione del servizio. Importa gli aggiornamenti e li aggiunge al sito. È quindi possibile visualizzare e installare tali aggiornamenti nella console di Configuration Manager.

Caricare più file di dati

  • Inserire tutti i file di dati esportati da gerarchie separate nella stessa cartella. Assegnare a ogni file un nome univoco. Se necessario, è possibile rinominarli manualmente.

  • Quando si esegue lo strumento per caricare i dati in Microsoft, si specifica la cartella che contiene i file di dati.

  • Quando si esegue lo strumento per importare i dati, lo strumento importa solo i dati per tale gerarchia.

Specificare un server proxy

Se il computer con una connessione Internet richiede un server proxy, lo strumento supporta una configurazione proxy di base. Usare i parametri facoltativi -proxyserveruri e -proxyusername. Per altre informazioni, vedere Parametri della riga di comando.

Specificare il tipo di aggiornamenti da scaricare

Lo strumento supporta le opzioni per controllare i file scaricati. Per impostazione predefinita, lo strumento scarica solo l'aggiornamento disponibile più recente che si applica alla versione del sito. Non scarica gli hotfix.

Per modificare questo comportamento, usare uno dei parametri seguenti per modificare i file scaricati:

  • -downloadall: scarica tutti gli aggiornamenti, inclusi aggiornamenti e hotfix, indipendentemente dalla versione del tuo sito.

  • -downloadhotfix: scaricare tutti gli hotfix indipendentemente dalla versione del sito.

  • -downloadsiteversion: scarica aggiornamenti e hotfix con una versione successiva rispetto alla versione del sito.

    Importante

    A causa di un problema noto in Configuration Manager versione 2002, il comportamento predefinito non funziona come previsto. Eseguire l'aggiornamento alla versione 2006 o usare il parametro -downloadsiteversion per scaricare gli aggiornamenti necessari per la versione 2002.

Per altre informazioni, vedere Parametri della riga di comando.

Consiglio

Lo strumento determina la versione del sito dal file di dati. Per verificare la versione, cercare nel file di .cab il file di testo denominato con la versione del sito.

Usare lo strumento

Lo strumento di connessione al servizio si trova nel supporto di installazione di Configuration Manager nel percorso seguente: SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe. Usare sempre lo strumento di connessione del servizio corrispondente alla versione di Configuration Manager usata. Per il funzionamento dello strumento di connessione del servizio, tutti questi file devono trovarsi nella stessa cartella.

Copiare la cartella ServiceConnectionTool con tutto il relativo contenuto nel computer con una connessione Internet.

In questa procedura gli esempi della riga di comando usano i nomi di file e i percorsi delle cartelle seguenti. Non è necessario usare questi percorsi e nomi di file. È possibile usare alternative che corrispondono all'ambiente e alle preferenze.

  • Percorso dei file di origine del supporto di installazione di Configuration Manager nel punto di connessione del servizio: C:\Source

  • Percorso di un'unità USB in cui archiviare i dati da trasferire tra computer: D:\USB\

  • Nome del file di dati esportato dal sito: UsageData.cab

  • Nome della cartella vuota in cui lo strumento archivia gli aggiornamenti scaricati per Configuration Manager: UpdatePacks

Preparazione

  1. Nel computer che ospita il punto di connessione del servizio aprire un prompt dei comandi come amministratore e passare alla directory dello strumento. Ad esempio:

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. Eseguire il comando seguente per preparare il file di dati:

    ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab

    Nota

    Se si caricano file di dati da più gerarchie contemporaneamente, assegnare a ogni file di dati un nome univoco. Se necessario, è possibile rinominare i file in un secondo momento.

    I dati nel file si basano sul livello di dati di diagnostica e di utilizzo configurati per il sito. Per altre informazioni, vedere Panoramica dei dati di diagnostica e utilizzo. È possibile usare lo strumento per esportare i dati in un file CSV per visualizzare il contenuto. Per altre informazioni, vedere -export.

  3. Al termine dell'esportazione dei dati di utilizzo, copiare il file di dati in un computer che ha accesso a Internet.

Connessione

  1. Nel computer con accesso a Internet aprire un prompt dei comandi come amministratore e passare alla directory dello strumento. Questo percorso è una copia dell'intera cartella ServiceConnectionTool . Ad esempio:

    cd D:\USB\ServiceConnectionTool\

  2. Eseguire il comando seguente per caricare il file di dati e scaricare gli aggiornamenti di Configuration Manager:

    ServiceConnectionTool.exe -connect -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

    Per altri esempi, vedere Parametri della riga di comando.

    Nota

    Quando si esegue questa riga di comando, potrebbe essere visualizzato l'errore seguente:

    Eccezione non gestita: System.UnauthorizedAccessException: accesso al percorso 'C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql' negato.

    È possibile ignorare questo errore in modo sicuro. Chiudere la finestra di errore per continuare.

  3. Al termine del download degli aggiornamenti da parte dello strumento, copiarli nel punto di connessione del servizio.

Importazione

  1. Nel computer che ospita il punto di connessione del servizio aprire un prompt dei comandi come amministratore e passare alla directory dello strumento. Ad esempio:

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. Eseguire il comando seguente per importare gli aggiornamenti:

    ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

  3. Al termine dell'importazione, chiudere il prompt dei comandi. Importa solo gli aggiornamenti per la gerarchia applicabile.

  4. Nella console di Configuration Manager passare all'area di lavoro Amministrazione e selezionare il nodo Aggiornamenti e manutenzione . Gli aggiornamenti importati sono ora disponibili per l'installazione. Per altre informazioni, vedere Installare gli aggiornamenti nella console.

File di registro

  • ServiceConnectionTool.log: ogni volta che si esegue lo strumento di connessione del servizio, scrive in questo file di log. Il percorso del file di log è sempre lo stesso dello strumento. Questo file di log fornisce dettagli semplici sull'utilizzo dello strumento in base ai parametri usati. Ogni volta che si esegue lo strumento, lo strumento sostituisce qualsiasi file di log esistente.

  • ConfigMgrSetup.log: durante la fase Connect , lo strumento scrive in questo file di log nella radice dell'unità di sistema. Questo file di log fornisce informazioni più dettagliate. Ad esempio, quali file vengono scaricati dallo strumento e se i controlli hash hanno esito positivo.

Parametri della riga di comando

Questa sezione elenca in ordine alfabetico tutti i parametri disponibili per lo strumento di connessione al servizio.

-connettersi

Usare durante la fase Di connessione nel computer con accesso a Internet. Si connette al servizio cloud di Configuration Manager per caricare il file di dati e scaricare gli aggiornamenti.

Sono necessari i parametri seguenti:

  • -usagedatasrc: percorso del file di dati da caricare
  • -updatepackdest: percorso per gli aggiornamenti scaricati

È anche possibile usare i parametri facoltativi seguenti:

  • -proxyserveruri: nome di dominio completo del server proxy
  • -proxyusername: nome utente per il server proxy
  • -downloadall: scarica tutto, inclusi aggiornamenti e hotfix, indipendentemente dalla versione del tuo sito.
  • -downloadhotfix: scaricare tutti gli hotfix, indipendentemente dalla versione del sito.
  • -downloadsiteversion: scaricare gli aggiornamenti e gli hotfix che hanno una versione successiva rispetto alla versione del sito.

Esempio di connessione senza un server proxy

ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacks

Esempio di connessione con un server proxy

ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks -proxyserveruri itproxy.contoso.com -proxyusername jqpublic

Esempio di connessione per scaricare solo gli aggiornamenti applicabili alla versione del sito

ServiceConnectionTool.exe -connect -downloadsiteversion -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

-dest

Parametro obbligatorio con il parametro -export per specificare il percorso e il nome del file CSV da esportare. Per altre informazioni, vedere -export.

-downloadall

Parametro facoltativo con il parametro -connect per scaricare tutti gli elementi, inclusi aggiornamenti e hotfix, indipendentemente dalla versione del sito. Per altre informazioni, vedere -connect.

-downloadhotfix

Parametro facoltativo con il parametro -connect per scaricare solo tutti gli hotfix, indipendentemente dalla versione del sito. Per altre informazioni, vedere -connect.

-downloadsiteversion

Parametro facoltativo con il parametro -connect per scaricare solo gli aggiornamenti e gli hotfix che hanno una versione successiva rispetto alla versione del sito. Per altre informazioni, vedere -connect.

-esportazione

Usare durante la fase di preparazione per esportare i dati di utilizzo in un file CSV. Eseguirlo come amministratore nel punto di connessione del servizio. Questa azione consente di esaminare il contenuto dei dati di utilizzo prima di eseguire il caricamento in Microsoft. Richiede il parametro -dest per specificare il percorso del file CSV.

Esempio di esportazione

-export -dest D:\USB\usagedata.csv

-importazione

Usare durante la fase di importazione nel punto di connessione del servizio per importare gli aggiornamenti nel sito. È necessario il parametro -updatepacksrc per specificare il percorso degli aggiornamenti scaricati.

Esempio di importazione

ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

-preparare

Usare durante la fase di preparazione nel punto di connessione del servizio per esportare i dati di utilizzo dal sito. Richiede il parametro -usagedatadest per specificare il percorso del file di dati esportato.

Esempio di preparazione

ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab

-proxyserveruri

Parametro facoltativo con il parametro -connect per specificare il nome di dominio completo del server proxy. Per altre informazioni, vedere -connect.

-proxyusername

Parametro facoltativo con il parametro -connect per specificare il nome utente da autenticare con il server proxy. Per altre informazioni, vedere -connect.

-updatepackdest

Parametro obbligatorio con il parametro -connect per specificare un percorso per gli aggiornamenti scaricati. Per altre informazioni, vedere -connect.

-updatepacksrc

Parametro obbligatorio con il parametro -import per specificare un percorso degli aggiornamenti scaricati. Per altre informazioni, vedere -import.

-usagedatadest

Parametro obbligatorio con il parametro -prepare per specificare un percorso e un nome file del file di dati esportato. Per altre informazioni, vedere -prepare.

Passaggi successivi

Installare gli aggiornamenti nella console

Come visualizzare i dati di diagnostica e di utilizzo