Share via


MDM_WindowsLicensing クラス

[一部の情報は、商用リリース前に大幅に変更される可能性があるプレリリース製品に関連しています。 Microsoft は、ここで提供される情報に関して明示的または黙示的な保証を行いません。]

MDM_WindowsLicensing クラスは、ライセンス関連の管理シナリオ用に設計されています。 現在、スコープは、Windows 10 デスクトップおよびモバイル デバイス (Windows 10 Pro から Windows 10 Enterprise など) のエディションアップグレードに限定されています。 さらに、この CSP は、Windows 10 デスクトップ デバイスのプロダクト キーをアクティブ化または変更する機能を提供します。

次の構文は MOF コードから簡略化され、継承されたすべてのプロパティが含まれています。

構文

[InPartition("local-system"), dynamic, provider("DMWmiBridgeProv")]
class MDM_WindowsLicensing
{
  string InstanceID;
  string ParentID;
  sint32 Edition;
  sint32 Status;
  string LicenseKeyType;
};

メンバー

MDM_WindowsLicensing クラスには、次の種類のメンバーがあります:

メソッド

MDM_WindowsLicensing クラスには、これらのメソッドがあります。

メソッド 説明
ChangeProductKeyMethod Windows 10 デスクトップ デバイスのプロダクト キーをインストールします。 再起動しません。
CheckApplicabilityMethod 入力したプロダクト キーを、デスクトップ デバイスの Windows 10 のエディションのアップグレード、ライセンス認証、またはプロダクト キーの変更に使用できるかどうかを確認する方法。
UpgradeEditionWithLicenseMethod Windows 10 モバイル デバイスのエディション アップグレードのライセンスを提供します。
注: このアップグレード プロセスでは、システムの再起動は必要ありません。
日付型は XML です。
サポートされている操作は Execute です。
重要:
XML ライセンス ファイルの内容を適切にエスケープする必要があります (つまり、単にコピーした XML にすることはできません)。そうしないと、Windows 10 モバイル デバイスでのエディションのアップグレードは失敗します。 XML ライセンス ファイルの適切なエスケープの詳細については、W3C XML 仕様 のセクション 2.4 を参照してください。XML ライセンス ファイルは、Microsoft ボリューム ライセンス サービス センターから取得されます。 ポータルにアクセスするには、組織が Microsoft とボリューム ライセンス契約を締結している必要があります。
MDM またはプロビジョニング パッケージでこのノードを使用する場合の有効なエディションのアップグレード パスを次に示します:
- Windows 10 Mobileto Windows 10 Mobile Enterprise
UpgradeEditionWithProductKeyMethod デバイスがプロダクト キーを取得し、クライアントのエディションをアップグレードするようにトリガーします。
[!注意]
このアップグレード プロセスでは、システムを再起動する必要があります。


サポートされている操作は Execute です。
プロダクト キーが MDM サーバーからユーザーのデバイスにプッシュされると、 changepk.exe はプロダクト キーを使用して実行されます。 完了すると、Windows 10 の新しいエディションが使用可能であることを示す通知がユーザーに表示されます。 その後、ユーザーはシステムを手動で再起動するか、2 時間後にデバイスが自動的に再起動してアップグレードを完了できます。 ユーザーは、自動再起動の 10 分前にリマインダー通知を受け取ります。
デバイスの再起動後、エディションのアップグレード プロセスが完了します。 ユーザーは、アップグレードが成功したことを示す通知を受け取ります。
[!Important]
changepk.exe の実行中に発生するシステムの再起動が別のポリシーで必要な場合、エディションのアップグレードは失敗します。


プロビジョニング パッケージにプロダクト キーが入力され、ユーザーがパッケージのインストールを開始すると、システムが再起動してパッケージのインストールが完了するという通知がユーザーに表示されます。 続行するユーザーからの明示的な同意が得られ、パッケージはインストールを続行し、プロダクト キーを使用して changepk.exe が実行されます。 ユーザーは、自動再起動の 30 秒前にリマインダー通知を受け取ります。
デバイスの再起動後、エディションのアップグレード プロセスが完了します。 ユーザーは、アップグレードが成功したことを示す通知を受け取ります。
このノードを使用して、プロダクト キーを入力することで、Windows 10 デスクトップ デバイスの特定のエディションでプロダクト キーをアクティブ化または変更することもできます。 プロダクト キーをアクティブ化または変更する場合、再起動は必要なく、ユーザーにとってサイレント プロセスです。
[!Important]
入力するプロダクト キーは 29 文字にする必要があります (ダッシュを含める必要があります)。そうしないと、Windows 10 デスクトップ デバイスでのライセンス認証、エディションのアップグレード、またはプロダクト キーの変更は失敗します。 プロダクト キーは、Microsoft ボリューム ライセンス サービス センターから取得されます。 ポータルにアクセスするには、組織が Microsoft とボリューム ライセンス契約を締結している必要があります。

MDM 経由でこのノードを使用する場合の有効なエディションのアップグレード パスを次に示します:
  • Windows 10 Enterprise から Windows 10 Education
  • Windows 10 Home から Windows 10 Education
  • Windows 10 Pro から Windows 10 Education
  • Windows 10 Pro から Windows 10 Enterprise

プロダクト キーのアクティブ化または変更は、次のエディションで実行できます:
  • Windows 10 Education
  • Windows 10 Enterprise
  • Windows 10 Home
  • Windows 10 Pro

Properties

MDM_WindowsLicensing クラスには、次のプロパティがあります。

エディション

データ型 : sint32

アクセスの種類: 読み取り/書き込み

InstanceID

データ型: string

アクセスの種類: 読み取り専用

修飾子: Key

親ノードの名前を識別します。

LicenseKeyType

データ型: string

アクセスの種類: 読み取り/書き込み

ParentID

データ型: string

アクセスの種類: 読み取り専用

修飾子: Key

親ノードへの完全なパスを説明します。 このクラスの文字列は "./Vendor/MSFT/" です

状態

データ型 : sint32

アクセスの種類: 読み取り/書き込み

必要条件

要件 Value
サポートされている最小のクライアント
Windows 10 [デスクトップ アプリのみ]
サポートされている最小のサーバー
サポートなし
名前空間
Root\CIMv2\MDM\DMMap
MOF
DMWmiBridgeProv.mof
[DLL]
DMWmiBridgeProv.dll

関連項目

WMI ブリッジ プロバイダーでの PowerShell スクリプトの使用