Tools zum Verwalten der Volumenaktivierung von Office

  • Artikel

Gilt für:Volumenlizenzversionen von Office LTSC 2021, Office 2019 und Office 2016 (einschließlich Project und Visio)

Das Office Software Protection Platform-Skript (ospp.vbs), das Software License Manager-Skript (slmgr.vbs) und das Tool für die Volumenaktivierungsverwaltung (VAMT) können Sie beim Konfigurieren und Testen von Volumenlizenzversionen von Office, einschließlich Project und Visio, unterstützen. Bevor Sie diesen Artikel lesen, empfehlen wir Ihnen, die folgenden Artikel zu lesen:

Das Skript "ospp.vbs"

Mit dem Office Software Protection Platform-Skript (ospp.vbs) können Sie Volumenlizenzversionen von Office-Produkten konfigurieren, einschließlich Project und Visio. Das ospp.vbs Skript befindet sich im Ordner Programme\Microsoft Office\Office16. Wenn Sie die 32-Bit-Version von Office auf einem 64-Bit-Betriebssystem installiert haben, wechseln Sie zum Ordner Programme (x86)\Microsoft Office\Office16.

Hinweis

Das ospp.vbs-Skript funktioniert nicht für Microsoft 365 Apps- oder Abonnementversionen von Project und Visio. Stattdessen können Sie ein PowerShell-Skript namens vnextdiag.ps1 verwenden. Weitere Informationen finden Sie unter Überprüfen der lizenz- und aktivierungs-status für Microsoft 365 Apps.

Für die Ausführung von ospp.vbs ist das Skriptmodul cscript.exe erforderlich. Geben Sie zum Anzeigen der Hilfedatei den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:

 cscript ospp.vbs /?

Die allgemeine Syntax lautet wie folgt:

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

Option Gibt die Option und den Wert an, die verwendet werden sollen, um ein Produkt zu aktivieren, einen Product Key zu installieren oder zu deinstallieren, Lizenzinformationen zu installieren und anzuzeigen, KMS-Hostname und -Port festzulegen und KMS-Hostname und -Port zu entfernen. Die Optionen und Werte sind in den Tabellen in diesem Abschnitt aufgeführt.

Computername Name des Remotecomputers. Wenn kein Computername angegeben wird, wird der lokale Computer verwendet.

Benutzer Konto, das über die erforderliche Berechtigung auf dem Remotecomputer verfügt.

Passwort Kennwort für das Konto. Wenn kein Benutzerkonto und Kennwort angegeben werden, werden die aktuellen Anmeldeinformationen verwendet.

Wichtig

Stellen Sie vor dem Ausführen von ospp.vbs sicher, dass folgende Voraussetzungen erfüllt sind:

  • Wenn Sie das Skript auf einem Remotecomputer ausführen möchten, lässt die Windows-Firewall den Datenverkehr der Windows-Verwaltungsinstrumentation (WMI) auf dem Remotecomputer zu.
  • Das Benutzerkonto, das Sie verwenden, ist ein Mitglied der Gruppe Administratoren auf dem Computer, auf dem Sie das Skript ausführen.
  • Sie müssen das Skript ospp.vbs an einer Eingabeaufforderung mit erhöhten Rechten ausführen.

Globale Optionen für "ospp.vbs"

Globale Option Beschreibung
/act Aktiviert installierte Office-Product Keys.
/inpkey:value Installiert einen Product Key (der vorhandene Schlüssel wird ersetzt), wobei ein vom Benutzer angegebener Product Key verwendet wird. Die Option "Value" ist erforderlich.
/unpkey:value Deinstalliert einen installierten Product Key mit den letzten fünf Ziffern des zu deinstallierenden Product Keys (wie in der Option /dstatus angezeigt). Der Parameter "Value" ist erforderlich.
/inslic:value Installiert eine Lizenz anhand der vom Benutzer angegebenen Pfad der XRM-MS-Lizenz. Der Parameter "Value" ist erforderlich.
/dstatus Zeigt Lizenzinformationen zu den installierten Product Keys an.
/dstatusall Zeigt Lizenzinformationen für alle installierte Lizenzen an.
/dhistoryacterr Zeigt den Fehlerverlauf für MAK- und Einzelhandelsaktivierung an.
/dinstid Zeigt die Installations-ID für die Offlineaktivierung an.
/actcid:value Aktiviert das Produkt mit der vom Benutzer eingegebenen Bestätigungs-ID. Der Parameter "Value" ist erforderlich.
/rearm Setzt die Lizenzierungs-status für alle installierten Office-Product Keys zurück.
/rearm:value Setzt die Lizenzierungs-status für eine Office-Lizenz mit einem vom Benutzer bereitgestellten SKU-ID-Wert zurück. Der Parameter "Value" ist erforderlich.

Verwenden Sie diese Option mit dem SKU-ID-Wert, der mithilfe der Option /dstatus angegeben wird, wenn Die Rearms nicht mehr verfügbar sind und Office über KMS oder Active Directory-basierte Aktivierung aktiviert wurde, um eine zusätzliche Neustrukturierung zu erhalten.
/ddescr:value Zeigt die Beschreibung zu einem vom Benutzer angegebenen Fehlercode an. Der Parameter "Value" ist erforderlich.

In der folgenden Tabelle werden die Optionen für ospp.vbs zum Konfigurieren des KMS-Clients erläutert.

KMS-Clientoptionen für "ospp.vbs"

KMS-Clientoption Beschreibung
/dhistorykms Zeigt den KMS-Clientaktivierungsverlauf an.
/dcmid Zeigt die KMS-Clientcomputer-ID an.
/sethst:value Legt einen KMS-Hostnamen unter Verwendung eines vom Benutzer angegebenen Hostnamens fest. Der Parameter "Value" ist erforderlich.

Hierdurch wird HKLM\Software\Microsoft\OfficeSoftwareProtectionPlatform\KeyManagementServiceName (REG_SZ) festgelegt.
/setprt:value Legt einen KMS-Port unter Verwendung einer vom Benutzer angegebenen Portnummer fest. Der Standardport ist 1688. Der Parameter „Value" ist erforderlich.

Hierdurch wird HKLM\Software\Microsoft\OfficeSoftwareProtectionPlatform\KeyManagementServicePort (REG_SZ) festgelegt.
/remhst Entfernt den KMS-Hostnamen und legt den Port auf den Standardwert fest. Der Standardport ist 1688.
/cachst:value Verweigert oder erlaubt die KMS-Hostzwischenspeicherung. Der Parameter "Value" ist erforderlich ("TRUE" oder "FALSE").
/actype:value (nur Windows 8.1 und höhere Versionen) Legt den Volumenaktivierungstyp fest. Der Parameter "Value" ist erforderlich.

Werte: 1 (für Active Directory-basiert), 2 (für KMS), 0 (für beides).
/skms-domain:value (nur Windows 8.1 und höhere Versionen) Legt die spezifische DNS-Domäne fest, in der alle KMS SRV-Einträge gefunden werden können. Diese Einstellung hat keine Auswirkung, wenn der einzelne KMS-Hostname durch die Option /sethst festgelegt wird. Der Parameter „Value" ist der vollqualifizierte Domänenname und ist erforderlich.
/ckms-domain (nur Windows 8.1 und höher) Löscht die spezifische DNS-Domäne, in der alle KMS SRV-Einträge gefunden werden können. Der spezifische KMS-Host wird verwendet, wenn er durch die Option /sethst festgelegt wird. Andernfalls wird die automatische KMS-Erkennung verwendet.

Szenarios, in denen "ospp.vbs" verwendet wird

In den folgenden Szenarien wird davon ausgegangen, dass Sie ospp.vbs an einer Eingabeaufforderung mit erhöhten Rechten ausführen.

Hinweis

Alle Änderungen, die Sie vornehmen, wirken sich nur auf die Office-Clientprodukte aus. Sie müssen den Windows-Client separat mithilfe des slmgr.vbs-Skripts konfigurieren.

So ändern Sie den Product Key in einen Mehrfachaktivierungsschlüssel auf einem Remotecomputer

  1. Wenn der Remotecomputer den Namen contoso1 trägt, führen Sie den folgenden Befehl aus, um den Product Key einzugeben. This assumes that you have administrator credentials on the remote computer. If your credentials on the remote computer differ from your logon name and password, you must type your logon name and password at the command line, and then press ENTER:
cscript ospp.vbs /inpkey:xxxxx-xxxxx-xxxxx-xxxxx-xxxxx contoso1
  1. Geben Sie zum Aktivieren des Remotecomputers den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
cscript ospp.vbs /act contoso1

So diagnostizieren Sie KMS-Aktivierungsfehler

  1. Wenn auf dem Computer der KMS-Clientschlüssel installiert ist, müssen Sie den Lizenzierungsstatus prüfen. Geben Sie hierfür den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
cscript ospp.vbs /dstatusall
  1. Geben Sie zum Prüfen des KMS-Aktivierungsverlaufs den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
cscript ospp.vbs /dhistorykms
  1. Geben Sie zum Auslösen der Aktivierung den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
cscript ospp.vbs /act
  1. Prüfen Sie, ob die Fehlermeldung den Fehlercode 0xC004F042 enthält. Wenn in den Benachrichtigungsdialogfeldern, die Benutzern angezeigt werden, ein Fehlercode zu sehen ist, können Sie auch diesen Fehlercode verwenden, um die Fehlermeldung zu überprüfen. Geben Sie hierfür den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
cscript ospp.vbs /ddescr:0xC004F042

So aktivieren oder deaktivieren Sie die KMS-Hostzwischenspeicherung auf dem KMS-Client

  1. Geben Sie auf dem KMS-Clientcomputer den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE, um die Zwischenspeicherung zu aktivieren:
cscript ospp.vbs /cachst:TRUE
  1. Geben Sie auf dem KMS-Clientcomputer den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE, um die Zwischenspeicherung zu deaktivieren:
cscript ospp.vbs /cachst:FALSE

So testen Sie den KMS-Hostnamen und legen dann die automatische Ermittlung fest

  1. Wenn Sie einen KMS-Host mit dem Namen kmstest.contoso.com testen und ihn im KMS-Client angeben möchten, geben Sie den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
cscript ospp.vbs /sethst:kmstest.contoso.com

Hinweis

Wenn Sie den Standardport auf dem KMS-Hostcomputer ändern, müssen Sie ospp.vbs mit der Option /setprt ausführen. Beispiel: cscript ospp.vbs /setprt:1750

  1. Geben Sie zum Auslösen der Aktivierung den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
cscript ospp.vbs /act
  1. Wenn Sie den KMS-Aktivierungsverlauf prüfen möchten, um festzustellen, ob eine erfolgreiche Verbindung zum Host hergestellt wurde, geben Sie den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
cscript ospp.vbs /dhistorykms
  1. Sie möchten nun, dass dieser KMS-Client DNS (Domain Name System) für die automatische Ermittlung des Produktions-KMS-Hosts verwendet. Geben Sie zum Entfernen des KMS-Hostnamens den folgenden Befehl ein, und drücken Sie dann die EINGABETASTE:
cscript ospp.vbs /remhst

Das Skript "slmgr.vbs"

Das Skript Software License Manager (slmgr.vbs) im Ordner Windows\system32 wird verwendet, um Volumenaktivierungsinformationen für den Office KMS-Host und den Windows-Host zu konfigurieren und abzurufen. Weitere Informationen finden Sie unter Konfigurieren von KMS-Hosts für Windows.

Das Skript kann lokal auf dem Zielcomputer oder remote auf einem anderen Computer ausgeführt werden. Sie müssen das Skript als Administrator verwenden. Wenn slmgr.vbs von einem Standardbenutzer ausgeführt wird, sind einige Lizenzdaten möglicherweise nicht vorhanden oder inkorrekt, sodass viele Vorgänge unzulässig sind.

Das slmgr.vbs Skript kann den Windows-basierten Skripthost, wscript.exe oder den befehlsbasierten Skripthost verwenden, cscript.exe und Administratoren können angeben, welche Skript-Engine verwendet werden soll. Wenn keine Skript-Engine angegeben ist, wird slmgr.vbs mithilfe der Standardskript-Engine wscript.exe ausgeführt. Wir empfehlen die cscript.exe-Skript-Engine.

Der Softwarelizenzierungsdienst muss neu gestartet werden, damit die Änderungen wirksam werden. Verwenden Sie zum Neustarten des Softwarelizenzierungsdiensts das MMC-Snap-In (Microsoft Management Console) „Dienste", oder führen Sie den folgenden Befehl aus:

net stop sppsvc && net start sppsvc

Für das Skript slmgr.vbs ist mindestens ein Parameter erforderlich. Wenn das Skript ohne Parameter ausgeführt wird, werden Hilfeinformationen angezeigt. In der folgenden Tabelle werden Befehlszeilenoptionen von slmgr.vbs mit zugehörigen Beschreibungen aufgeführt. Mit den meisten Parametern in der Tabelle wird der KMS-Hostcomputer konfiguriert. Die Parameter /sai und /sri werden jedoch an KMS-Clients übergeben, nachdem diese eine Verbindung mit dem KMS-Hostcomputer hergestellt haben. Die allgemeine Syntax von slmgr.vbs lautet wie folgt (vorausgesetzt, Sie verwenden die cscript.exe als Skript-Engine):

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

Computername Name des Remotecomputers. Wenn Sie keinen Computernamen angeben, wird der lokale Computer verwendet.

Benutzer Konto mit der erforderlichen Berechtigung auf dem Remotecomputer.

Passwort Kennwort für das Konto. Wenn Sie kein Benutzerkonto und Kennwort angeben, werden die aktuellen Anmeldeinformationen verwendet.

Option Optionen sind in der folgenden Tabelle aufgeführt.

befehlsoptionen Slmgr.vbs

Option Beschreibung
/ ipk ProductKey Installiert den Product Key für Windows (Standard) oder eine andere durch den Product Key angegeben Anwendung.
/ ato ActivationID Aktiviert den KMS-Host für Windows (Standard) oder die Anwendung, die identifiziert wird, wenn die Aktivierungs-ID angegeben wird.
/ dti ActivationID Zeigt die Installations-ID, die für die telefonische Aktivierung des KMS-Hostcomputers für Windows verwendet wird (Standard), oder die Anwendung an, die bestimmt wird, wenn ihre Aktivierungs-ID angegeben wird. Geben Sie die Installations-ID per Telefon ein, um die Bestätigungs-ID zu erhalten, die zum Aktivieren des KMS-Hostcomputers mithilfe des /atp-Parameters dient.
/ atp ConfirmationIDActivationID Nachdem die Bestätigungs-ID empfangen wurde, aktiviert den KMS-Host für Windows (Standard) oder die Anwendung, die identifiziert wird, wenn seine Aktivierungs-ID angegeben wird.
/ dlv ActivationID Zeigt detaillierte Lizenzinformationen für Windows (Standard) oder die Anwendung an, die identifiziert wird, wenn die Aktivierungs-ID angegeben wird.

Führen Sie beispielsweise den folgenden Befehl an der Eingabeaufforderung mit erhöhten Rechten im Ordner Windows\system32 aus, um die status des Office KMS-Hosts abzurufen:

cscript slmgr.vbs /dlv 70512334-47B4-44DB-A233-BE5EA33B914C
/ dli ActivationID Zeigt Lizenzinformationen für Windows (Standard) oder die Anwendung an, die identifiziert wird, wenn die Aktivierungs-ID angegeben wird.
/ Upk ActivationID Deinstalliert den Product Key für Windows (Standard) oder die Anwendung, die bei Angabe der Aktivierungs-ID identifiziert wird.

VORSICHT: Wenn Sie z. B. beabsichtigen, den Product Key für Office zu deinstallieren und vergessen, die Aktivierungs-ID einzugeben, werden alle installierten Product Keys deinstalliert. Dazu gehört auch der Product Key für Windows.
/ xpr ActivationID Zeigt das Ablaufdatum des aktuellen Lizenzstatus an.
/ sprt PortNumber Legt den Port für die TCP-Kommunikation auf einem KMS-Hostcomputer fest. Er ersetzt PortNumber durch die zu verwendende TCP-Portnummer. Die Standardeinstellung lautet 1688.
/Cdns Deaktiviert die automatische DNS-Veröffentlichung durch einen KMS-Hostcomputer.
/ sdns Aktiviert die automatische DNS-Veröffentlichung durch den KMS-Hostcomputer.
/ cpri Legt für KMS-Hostcomputerprozesse eine niedrigere Priorität fest.
/ sai ActivationInterval Ändert, wie oft ein KMS-Client versucht, sich selbst zu aktivieren, wenn er keinen KMS-Hostcomputer finden kann. Er ersetzt ActivationInterval durch einen Wert in Minuten. Die Standardeinstellung lautet 120 Minuten.
/ sri RenewalInterval Ändert das Intervall, in dem ein KMS-Client versucht, seine Aktivierung durch Verbindungsherstellung mit einem KMS-Hostcomputer zu erneuern. Er ersetzt RenewalInterval durch einen Wert in Minuten. Die Standardeinstellung lautet 10080 Minuten (7 Tage). Mit dieser Einstellung werden die lokalen Einstellungen des KMS-Clients außer Kraft gesetzt.

Hinweis

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

Slmgr.vbs-Befehlsoptionen (Active Directory-basierte Aktivierung)

Die folgende Tabelle zeigt die Befehlsoptionen zum Aktivieren einer AD DS-Gesamtstruktur mithilfe der Active Directory-basierten Aktivierung.

Option Beschreibung
/ ad-activation-online ProductKey Aktiviert eine AD DS-Gesamtstruktur über den vom Benutzer bereitgestellten Product Key.
/ ad-activation-apply-get-iid ProductKey Zeigt die Installations-ID für die AD DS-Gesamtstruktur an.
/ ad-activation-apply-cid ProductKeyConfirmationID Aktiviert eine AD DS-Gesamtstruktur über den vom Benutzer bereitgestellten Product Key und die Bestätigungs-ID.

Tool für die Volumenaktivierungsverwaltung (Volume Activation Management Tool, VAMT)

Tool für die Volumenaktivierungsverwaltung (VAMT) bietet eine grafische Benutzeroberfläche zum Verwalten der Volumenaktivierung. Weitere Informationen finden Sie in der technischen Referenz zu Tool für die Volumenaktivierungsverwaltung (VAMT).

Hinweis

Office LTSC 2021 und Office 2019 erfordern mindestens VAMT 3.1.