Strumenti per gestire l'attivazione dei contratti multilicenza di Office

  • Articolo

Si applica a:Versioni con contratti multi contratti multipropriato di Office LTSC 2021, Office 2019 e Office 2016 (inclusi Project e Visio)

Lo script di Office Software Protection Platform (ospp.vbs), lo script di Software License Manager (slmgr.vbs) e il Strumento di gestione dell'attivazione dei contratti multilicenza (VAMT) consentono di configurare e testare le versioni con contratti multiplo di Office, inclusi Project e Visio. Prima di leggere questo articolo, è consigliabile leggere gli articoli seguenti:

Script ospp.vbs

Lo script office software protection platform (ospp.vbs) consente di configurare le versioni con contratti multi-contratto multi-volume dei prodotti Office, tra cui Project e Visio. Lo script ospp.vbs si trova nella cartella Programmi\Microsoft Office\Office16. Se è stata installata la versione a 32 bit di Office in un sistema operativo a 64 bit, passare alla cartella Programmi (x86)\Microsoft Office\Office16.

Nota

Lo script ospp.vbs non funziona per le versioni di Microsoft 365 Apps o sottoscrizione di Project e Visio. È invece possibile usare uno script di PowerShell denominato vnextdiag.ps1. Per altre informazioni, vedere Controllare lo stato della licenza e dell'attivazione per Microsoft 365 Apps.

Per eseguire ospp.vbs è necessario il motore di script cscript.exe. Per consultare il file della Guida, digitare il comando seguente e quindi premere INVIO:

 cscript ospp.vbs /?

La sintassi generale è la seguente:

cscript ospp.vbs [Option:Value] [ComputerName] [User] [Password]

Opzione Specifica l'opzione e il valore da utilizzare per attivare un prodotto, installare o disinstallare un codice Product Key, installare e visualizzare le informazioni sulla licenza, impostare il nome host e la porta del Servizio di gestione delle chiavi e rimuovere il nome host e la porta del Servizio di gestione delle chiavi. Le opzioni e i valori sono elencati nelle tabelle riportate in questa sezione.

Nomecomputer Nome del computer remoto. Se non viene specificato un nome di computer, viene usato il computer locale.

Utente Account con l'autorizzazione necessaria per il computer remoto.

Password Password per l'account. Se non vengono forniti un account utente e una password, vengono usate le credenziali correnti.

Importante

Prima di eseguire ospp.vbs, verificare le seguenti condizioni:

  • Se si desidera eseguire lo script su un computer remoto, il firewall di Windows consente il traffico di Strumentazione gestione Windows (WMI) sul computer remoto.
  • L'account utente è un membro del gruppo Administrators nel computer in cui si esegue la procedura.
  • Lo script ospp.vbs è eseguito da un prompt dei comandi con privilegi elevati.

Opzioni globali per ospp.vbs

Opzione globale Descrizione
/act Attiva i codici Product Key di Office installati.
/inpkey:value Installa un codice Product Key sostituendo il codice esistente con un codice Product Key specificato dall'utente. È necessaria l'opzione value.
/unpkey:value Disinstalla un codice Product Key installato con le ultime cinque cifre del codice Product Key da disinstallare (come visualizzato dall'opzione /dstatus). È necessario il parametro value.
/inslic:value Installa una licenza con il percorso specificato dall'utente della licenza .xrm-ms. È necessario il parametro value.
/dstatus Visualizza informazioni sulla licenza per i codici "Product Key" installati.
/dstatusall Visualizza informazioni sulla licenza per tutte le licenze installate.
/dhistoryacterr Visualizza la cronologia degli errori per le attivazioni tramite codice per attivazione multipla o singola.
/dinstid Visualizza l'ID di installazione per l'attivazione offline.
/actcid:value Attiva il prodotto con l'ID di conferma specificato dall'utente. È necessario il parametro value.
/rearm Reimposta lo stato delle licenze per tutti i codici Product Key di Office installati.
/rearm:value Reimposta lo stato delle licenze per una licenza di Office con un valore di ID SKU fornito dall'utente. È necessario il parametro value.

Usare questa opzione con il valore di ID SKU specificato usando l'opzione /dstatus se si è esaurito il numero di riprogetti e si è attivato Office tramite il Servizio di gestione delle chiavi o l'attivazione basata su Active Directory per ottenere un riassemblizzo aggiuntivo.
/ddescr:value Mostra la descrizione per un codice di errore specificato dall'utente. È necessario il parametro value.

Nella tabella seguente vengono descritte le opzioni di ospp.vbs per la configurazione del client del Servizio di gestione delle chiavi.

Opzioni del client KMS per ospp.vbs

Opzione client del servizio di gestione delle chiavi Descrizione
/dhistorykms Mostra la cronologia di attivazione del client del servizio di gestione delle chiavi.
/dcmid Mostra l'ID del computer client (CMID) del Servizio di gestione delle chiavi.
/sethst:value Imposta il nome host del Servizio di gestione delle chiavi mediante un nome host specificato dall'utente. È necessario il parametro value.

Imposta HKLM\Software\Microsoft\OfficeSoftwareProtectionPlatform\KeyManagementServiceName (REG_SZ).
/setprt:value Imposta la porta del Servizio di gestione delle chiavi mediante un numero di porta specificato dall'utente. Il numero di porta predefinito è 1688. È necessario il valore del parametro.

Imposta HKLM\Software\Microsoft\OfficeSoftwareProtectionPlatform\KeyManagementServicePort (REG_SZ).
/remhst Rimuove il nome host del servizio di gestione delle chiavi e imposta la porta sul valore predefinito. La porta predefinita è 1688.
/cachst:value Consente o nega la memorizzazione nella cache dell'host del servizio di gestione delle chiavi (KMS). È necessario il parametro value (TRUE o FALSE).
/actype:value (solo Windows 8.1 e versioni successive) Imposta il tipo di attivazione dei contratti multilicenza. È necessario il parametro value.

Valori: 1 (per attivazione basata su Active Directory), 2 (per attivazione mediante Servizio di gestione delle chiavi (KMS)), 0 (per entrambe).
/skms-domain:value (solo Windows 8.1 e versioni successive) Imposta il dominio DNS specifico in cui è possibile trovare tutti i record SRV del Servizio di gestione delle chiavi. Questa impostazione non ha alcun effetto se il singolo nome host del Servizio di gestione delle chiavi specifico è impostato dall'opzione /sethst. Il parametro value è il nome di dominio completo (FQDN), ed è obbligatorio.
/ckms-domain (solo Windows 8.1 e versioni successive) Cancella il dominio DNS specifico in cui è possibile trovare tutti i record SRV del Servizio di gestione delle chiavi. L'host del Servizio di gestione delle chiavi specifico viene usato se è impostato dall'opzione /sethst. In caso contrario, viene usato l'individuazione automatica dell'host del Servizio di gestione delle chiavi.

Scenari che utilizzano ospp.vbs

Gli scenari seguenti presuppongono l'esecuzione di ospp.vbs in un prompt dei comandi con privilegi elevati.

Nota

Le modifiche apportate interessano solo i prodotti client di Office. È necessario configurare il client Windows separatamente usando lo scriptslmgr.vbs.

Per modificare il codice "Product Key" in un codice "Product Key" per attivazione multipla in un computer remoto

  1. Se il nome del computer remoto è contoso1, eseguire il comando seguente per immettere il "Product Key". Si presuppone che l'utente disponga delle credenziali di amministratore nel computer remoto. Se le credenziali per il computer remoto sono diverse rispetto al nome e alla password di accesso, è necessario immettere il nome e la password di accesso nella riga di comando e quindi premere INVIO:
cscript ospp.vbs /inpkey:xxxxx-xxxxx-xxxxx-xxxxx-xxxxx contoso1
  1. Per attivare il computer remoto, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /act contoso1

Per diagnosticare errori di attivazione del servizio di gestione delle chiavi

  1. Se nel computer è installato il client del servizio di gestione delle chiavi, verificare lo stato della licenza. Per questo scopo, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /dstatusall
  1. Per verificare la cronologia di attivazione del servizio di gestione delle chiavi, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /dhistorykms
  1. Per avviare l'attivazione, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /act
  1. Verificare il messaggio di errore per il codice di errore 0xC004F042. Se nelle finestre di dialogo di notifica mostrate agli utenti è presente un codice di errore, è possibile usare questo codice per verificare il messaggio di errore. Per questo scopo, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /ddescr:0xC004F042

Per attivare o disattivare la memorizzazione nella cache dell'host del Servizio di gestione delle chiavi sul client del Servizio di gestione delle chiavi

  1. Nel computer client del Servizio di gestione delle chiavi, per attivare la memorizzazione nella cache, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /cachst:TRUE
  1. Nel computer client del Servizio di gestione delle chiavi, per disattivare la memorizzazione nella cache, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /cachst:FALSE

Per testare il nome host del Servizio di gestione delle chiavi e quindi impostare l'individuazione automatica

  1. Se si sta testando un host del Servizio di gestione delle chiavi denominato kmstest.contoso.com e si vuole specificarlo nel client del Servizio di gestione delle chiavi, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /sethst:kmstest.contoso.com

Nota

Se si modifica la porta predefinita nel computer host del Servizio di gestione delle chiavi, è necessario eseguire ospp.vbs con l'opzione /setprt. Ad esempio: cscript ospp.vbs /setprt:1750

  1. Per avviare l'attivazione, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /act
  1. Per verificare la cronologia di attivazione del servizio di gestione delle chiavi allo scopo di individuare se l'host è stato contattato correttamente, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /dhistorykms
  1. Si desidera ora che il client del servizio di gestione delle chiavi utilizzi il Domain Name System (DNS) per l'individuazione automatica dell'host del servizio di gestione delle chiavi di produzione. Per rimuovere il nome dell'host del servizio di gestione delle chiavi, digitare il comando seguente e quindi premere INVIO:
cscript ospp.vbs /remhst

Script slmgr.vbs

Lo script software License Manager (slmgr.vbs), disponibile nella cartella Windows\system32, viene usato per configurare e recuperare le informazioni sull'attivazione dei contratti multilicenza per l'host del Servizio di gestione delle chiavi di Office e l'host Windows. Per altre informazioni, vedere l'articolo relativo alla configurazione degli host del Servizio di gestione delle chiavi per Windows.

Lo script può essere eseguito localmente nel computer di destinazione oppure da un computer remoto. Per usare lo script è necessario essere un amministratore. Se slmgr.vbs viene eseguito da un utente standard, è possibile che alcuni dati delle licenze siano mancanti o non corretti e che molte operazioni non siano autorizzate.

Lo script slmgr.vbs può usare l'host di script basato su Windows, wscript.exe, o l'host di script basato su comandi, cscript.exe, e gli amministratori possono specificare quale motore di script usare. Se non si specifica un motore di script, slmgr.vbs viene eseguito tramite il motore di script predefinito, wscript.exe. cscript.exe è il motore di script consigliato.

Per rendere effettive le modifiche, è necessario riavviare il Servizio gestione licenze software. A tale scopo, utilizzare lo snap-in Servizi di Microsoft Management Console (MMC) oppure eseguire il comando seguente:

net stop sppsvc && net start sppsvc

Lo script slmgr.vbs richiede almeno un parametro. Se lo script viene eseguito senza parametri, vengono visualizzate le informazioni della Guida. Nella tabella seguente sono elencate le opzioni della riga di comando di slmgr.vbsline, con una descrizione di ognuna. La maggior parte dei parametri elencati nella tabella configura il computer host del Servizio di gestione delle chiavi. I parametri /sai e /sri vengono invece passati ai client del Servizio di gestione delle chiavi dopo che questi hanno contattato il proprio computer host. La sintassi generale di slmgr.vbs è la seguente (presupponendo che si usi il cscript.exe come motore di script):

 cscript slmgr.vbs [ComputerName] [User] [Password] [Option]

Nomecomputer Nome del computer remoto. Se non si specifica un nome di computer, viene usato il computer locale.

Utente Account con l'autorizzazione necessaria per il computer remoto.

Password Password per l'account. Se non si specifica un account utente e una password, vengono usate le credenziali correnti.

Opzione Le opzioni sono illustrate nella tabella seguente.

opzioni del comando Slmgr.vbs

Opzione Descrizione
/ipk ProductKey Installa il codice Product Key per Windows (impostazione predefinita) o per un'altra applicazione identificata dal codice Product Key.
/ato ActivationID Attiva l'host del servizio di gestione delle chiavi per Windows (impostazione predefinita) o l'applicazione identificata quando viene specificato il relativo ID di attivazione.
/dti ActivationID Visualizza l'ID di installazione usato per attivare tramite telefono il computer host del Servizio di gestione delle chiavi per Windows (impostazione predefinita) o l'applicazione identificata quando viene specificato il relativo ID di attivazione. È possibile digitare l'ID di installazione sulla tastiera del telefono per ricevere l'ID di conferma che consente di attivare il computer host del Servizio di gestione delle chiavi usando il parametro /atp.
/atp ConfirmationIDActivationID Dopo la ricezione dell'ID di conferma, attiva l'host del servizio di gestione delle chiavi per Windows (impostazione predefinita) o l'applicazione identificata quando viene specificato il relativo ID di attivazione.
/dlv ActivationID Visualizza informazioni dettagliate sulla licenza per Windows (impostazione predefinita) o per l'applicazione identificata quando viene specificato il relativo ID di attivazione.

Ad esempio, eseguire il comando seguente al prompt dei comandi con privilegi elevati nella cartella Windows\system32 per ottenere lo stato dell'host del Servizio di gestione delle chiavi di Office:

cscript slmgr.vbs /dlv 70512334-47B4-44DB-A233-BE5EA33B914C
/dli ActivationID Visualizza informazioni sulla licenza per Windows (impostazione predefinita) o per l'applicazione identificata quando viene specificato il relativo ID di attivazione.
/upk ActivationID Disinstalla il codice Product Key per Windows (impostazione predefinita) o per l'applicazione identificata quando viene specificato il relativo ID di attivazione.

ATTENZIONE: Se si intende disinstallare il codice Product Key per Office, ad esempio, e si dimentica di immettere l'ID attivazione, tutti i codici Product Key installati vengono disinstallati. Questo include il codice Product Key per Windows.
/xpr ActivationID Visualizza la data di scadenza dello stato attuale della licenza.
/sprt PortNumber Imposta la porta di comunicazione TCP in un computer host del servizio di gestione delle chiavi. Sostituisce PortNumber con il numero di porta TCP da usare. L'impostazione predefinita è 1688.
/cdns Disattiva la pubblicazione DNS automatica da parte di un computer host del Servizio di gestione delle chiavi.
/sdns Attiva la pubblicazione DNS automatica da parte del computer host del Servizio di gestione delle chiavi.
/cpri Riduce la priorità dei processi del computer host del Servizio di gestione delle chiavi.
/sai ActivationInterval Modifica la frequenza con cui un client del Servizio di gestione delle chiavi tenta di attivarsi quando non riesce a trovare un computer host del Servizio di gestione delle chiavi. Sostituisce ActivationInterval con un valore espresso in minuti. L'impostazione predefinita è 120 minuti.
/ sri RenewalInterval Modifica la frequenza con cui un client del servizio di gestione delle chiavi tenta di rinnovare la propria attivazione contattando un computer host del servizio di gestione delle chiavi. Sostituisce RenewalInterval con un valore espresso in minuti. L'impostazione predefinita è 10080 minuti (7 giorni). Questa impostazione ha la priorità sulle impostazioni locali del client del servizio di gestione delle chiavi.

Nota

  • ID attivazione per Office LTSC 2021: 47F3B983-7C53-4D45-ABC6-BCD91E2DD90A
  • ID attivazione per Office 2019: 70512334-47B4-44DB-A233-BE5EA33B914C
  • ID attivazione per Office 2016: 98EBFE73-2084-4C97-932C-C0CD1643BEA7

Slmgr.vbs opzioni di comando (attivazione basata su Active Directory)

La tabella seguente illustra le opzioni di comando per l'attivazione di una foresta di Active Directory Domain Services tramite l'attivazione basata su Active Directory.

Opzione Descrizione
/ad-activation-online ProductKey Attiva una foresta di AD DS tramite il codice Product Key fornito dall'utente.
/ad-activation-apply-get-iid ProductKey Visualizza l'ID di installazione per la foresta di AD DS.
/ad-activation-apply-cid ProductKeyConfirmationID Attiva una foresta di AD DS tramite il codice Product Key fornito dall'utente e l'ID di conferma.

Strumento di gestione dell'attivazione dei contratti multilicenza (VAMT)

Strumento di gestione dell'attivazione dei contratti multilicenza (VAMT) fornisce un'interfaccia utente grafica per gestire l'attivazione dei contratti multilicenza. Per altre informazioni, vedere riferimento tecnico Strumento di gestione dell'attivazione dei contratti multilicenza (VAMT).

Nota

Office LTSC 2021 e Office 2019 richiedono almeno VAMT 3.1.