InstallAgreementLicenseKeyPack-Methode der Win32_TSLicenseKeyPack-Klasse
Installiert ein Remotedesktopdienste-Lizenzschlüsselpaket, das über eine Lizenzvereinbarung erworben wurde, und stellt automatisch eine Verbindung über das Internet her, um die Key Pack-Lizenz zu überprüfen.
Syntax
uint32 InstallAgreementLicenseKeyPack(
[in] uint32 AgreementType,
[in] string sAgreementNumber,
[in] uint32 ProductVersion,
[in] uint32 ProductType,
[in] uint32 LicenseCount,
[out] uint32 KeyPackId
);
Parameter
AgreementType [in]
Vereinbarungstyp.
| Wert | BESCHREIBUNG |
|---|---|
| 0 | Das Lizenzschlüsselpaket stammt aus einer Volumenlizenzvereinbarung auswählen (für Kunden mit mindestens 250 Computern). Der sAgreementNumber-Parameter ist die Registrierungsnummer (sieben numerische Ziffern), die sich auf dem unterzeichneten Vertragsformular befindet. |
| 1 | Das Lizenzschlüsselpaket stammt aus einer Enterprise-Volumenlizenzvereinbarung für Kunden mit mindestens 250 Computern. Der sAgreementNumber-Parameter ist die Registrierungsnummer (sieben numerische Ziffern), die sich auf dem unterzeichneten Vertragsformular befindet. |
| 2 | Das Lizenzschlüsselpaket stammt aus einer Campus-Volumenlizenzvereinbarung für eine Hochschule. Der sAgreementNumber-Parameter ist die Registrierungsnummer (sieben numerische Ziffern), die sich auf dem unterzeichneten Vertragsformular befindet. |
| 3 | Das Lizenzschlüsselpaket stammt aus einer Volumenlizenzvereinbarung für Schulen für primäre und sekundäre Einrichtungen. Der sAgreementNumber-Parameter ist die Registrierungsnummer (sieben numerische Ziffern), die sich auf dem unterzeichneten Vertragsformular befindet. |
| 4 | Das Lizenzschlüsselpaket stammt aus einem Dienstanbieter-Lizenzvertrag für Dienstanbieter, um Microsoft-Software monatlich zu lizenzieren. Der sAgreementNumber-Parameter ist die Registrierungsnummer (sieben numerische Ziffern), die sich auf dem unterzeichneten Vertragsformular befindet. |
| 5 | Das Lizenzschlüsselpaket stammt aus einer anderen Lizenzvereinbarung, z. B. Open Value, Multi-Year Open License und Open Subscription License. Der sAgreementNumber-Parameter ist die Vereinbarungsnummer, die mit Ihren Programminformationen angegeben wird. |
sAgreementNumber [in]
Vertragsnummer oder Registrierungsnummer. Der sAgreementNumber-Parameter ist eine siebenstellige numerische Zeichenfolge ohne Bindestriche.
ProductVersion [in]
Die Produktversion.
| Wert | BESCHREIBUNG |
|---|---|
| 0 | Nicht unterstützt |
| 1 | Nicht unterstützt |
| 2 | Windows Server 2008/Windows Server 2008 R2 |
| 4 | Windows Server 2012/Windows Server 2012 R2 |
| 5 | Windows Server 2016 |
| 6 | Windows Server 2019 |
ProductType [in]
Produkttyp.
| Wert | BESCHREIBUNG |
|---|---|
| 0 | Der Produkttyp des Remotedesktopdienste-Lizenzschlüsselpakets ist pro Gerät. Daher muss jedes Gerät, das eine Verbindung mit dem RD-Sitzungshostserver herstellt, über eine Lizenz verfügen. |
| 1 | Der Produkttyp des Remotedesktopdienste-Lizenzschlüsselpakets ist pro Benutzer. Daher muss jeder Benutzer, der eine Verbindung mit dem RD-Sitzungshostserver herstellt, über eine Lizenz verfügen. |
| 2 | Dieser Produkttyp ist ungültig. |
LicenseCount [in]
Anzahl der zu installierenden Lizenzen.
KeyPackId [out]
Empfängt den Key Pack-Bezeichner.
Rückgabewert
Wenn die Methode erfolgreich ist, wird null zurückgegeben. Wenn die Methode nicht erfolgreich ist, gibt sie einen wert ohne Zero zurück. Eine Liste der Fehlercodes finden Sie unter WMI-Anbieterfehlercodes für Remotedesktopdienste.
Bemerkungen
Sie müssen Mitglied der Gruppe Administratoren sein, um diese Methode aufrufen zu können.
MOF-Dateien (Managed Object Format) enthalten die Definitionen für WMI-Klassen (Windows Management Instrumentation). MOF-Dateien werden nicht als Teil des Microsoft Windows Software Development Kit (SDK) installiert. Sie werden auf dem Server installiert, wenn Sie die zugeordnete Rolle mithilfe des Server-Manager hinzufügen. Weitere Informationen zu MOF-Dateien finden Sie unter Verwaltetes Objektformat (MOF).
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Nicht unterstützt |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| Namespace |
Root\CIMv2 |
| MOF |
|
| DLL |
|