Win32_TSLicenseKeyPack 類別的 InstallAgreementLicenseKeyPack 方法
安裝透過授權合約購買的遠端桌面服務授權金鑰套件,並自動透過網際網路連線以驗證金鑰套件授權。
語法
uint32 InstallAgreementLicenseKeyPack(
[in] uint32 AgreementType,
[in] string sAgreementNumber,
[in] uint32 ProductVersion,
[in] uint32 ProductType,
[in] uint32 LicenseCount,
[out] uint32 KeyPackId
);
參數
AgreementType [in]
合約類型。
值 | 描述 |
---|---|
0 | 授權金鑰套件來自具有 250 部或更多電腦的客戶 (選取大量授權合約) 。 sAgreementNumber參數是 (簽署合約表單上找到的七個數值數位) 註冊編號。 |
1 | 授權金鑰套件來自具有 250 部以上電腦之客戶的 Enterprise 大量授權合約。 sAgreementNumber參數是 (簽署合約表單上找到的七個數值數位) 註冊編號。 |
2 | 授權金鑰套件來自教育機構的 Campus 大量授權合約。 sAgreementNumber參數是 (簽署合約表單上找到的七個數值數位) 註冊編號。 |
3 | 授權金鑰套件來自主要和次要機構學校大量授權合約。 sAgreementNumber參數是 (簽署合約表單上找到的七個數值數位) 註冊編號。 |
4 | 授權金鑰套件來自服務提供者授權合約,服務提供者每月授權 Microsoft 軟體。 sAgreementNumber參數是 (簽署合約表單上找到的七個數值數位) 註冊編號。 |
5 | 授權金鑰套件來自另一份授權合約,例如 Open Value、Multi-Year Open License 和 Open Subscription License。 sAgreementNumber參數是您程式資訊所提供的合約號碼。 |
sAgreementNumber [in]
合約號碼或註冊號碼。 sAgreementNumber參數是不含連字號的七位數數值字串。
ProductVersion [in]
產品版本。
值 | 描述 |
---|---|
0 | 不支援 |
1 | 不支援 |
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]
產品類型。
值 | 描述 |
---|---|
0 | 遠端桌面服務授權金鑰套件產品類型是每部裝置。 因此,連接到 RD 工作階段主機伺服器的每個裝置都必須具有授權。 |
1 | 遠端桌面服務授權金鑰套件產品類型是每個使用者。 因此,連線到 RD 工作階段主機伺服器的每個使用者都必須具有授權。 |
2 | 此產品類型無效。 |
LicenseCount [in]
要安裝的授權數目。
KeyPackId [out]
接收金鑰套件識別碼。
傳回值
如果方法成功,則會傳回零。 如果方法不成功,它會傳回非零值。 如需錯誤碼的清單,請參閱 遠端桌面服務 WMI 提供者錯誤碼。
備註
您必須是 Administrators 群組的成員,才能呼叫此方法。
Managed 物件格式 (MOF) 檔案包含 Windows Management Instrumentation (WMI) 類別的定義。 MOF 檔案不會安裝為 Microsoft Windows 軟體發展工具組的一部分, (SDK) 。 當您使用 伺服器管理員 新增相關聯的角色時,它們會安裝在伺服器上。 如需 MOF 檔案的詳細資訊,請參閱 Managed Object Format (MOF) 。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
都不支援 |
最低支援的伺服器 |
Windows Server 2008 |
命名空間 |
Root\CIMv2 |
MOF |
|
DLL |
|