Win32_Tpm クラスの TakeOwnership メソッド
Win32_Tpm クラスの TakeOwnership メソッドは、TPM の所有者をインストールします。 TPM の所有者は、TPM のすべての機能を利用できます。 所有者が設定されると、他のユーザーやソフトウェアが TPM の所有権を要求することはできません。
TakeOwnership メソッドが成功するには、IsEnabled メソッド、IsActivated メソッド、IsOwnershipAllowed メソッドがすべて true である必要があります。
構文
uint32 TakeOwnership(
[in, optional] string OwnerAuth
);
パラメーター
-
OwnerAuth [in, optional]
-
型: string
TPM 所有者を識別する文字列。 この文字列は、20 バイトのバイナリ データを含む base64 でエンコードされた null で終わる文字列である必要があります。 パスフレーズをこの予期される形式に変換するには、 ConvertToOwnerAuth メソッドを使用します。 OwnerAuth パラメーターが指定されていない場合は、レジストリから読み取られます。
戻り値
型: uint32
すべての TPM エラーと、TPM 基本サービスに固有のエラーを返すことができます。
次の表に、一般的なリターン コードの一部を示します。
| リターン コード/値 | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
|
OwnerAuth パラメーターが無効です。 |
|
所有者は TPM に既に存在します。 |
|
TPM に保証キーが見つかりません。 TPM で保証キーペアを作成するには、 CreateEndorsementKeyPair メソッドを参照してください。 |
|
所有者は、この TPM にインストールできません。 デバイス所有者のインストールを許可する方法については、「 SetPhysicalPresenceRequest」を参照してください。 |
|
TPM はディクショナリ攻撃から防御しており、タイムアウト期間です。 詳細については、 ResetAuthLockOut メソッドを参照してください。 |
解説
TakeOwnership を成功させるには、IsEnabled、IsActivated、IsOwnershipAllowed の各メソッドがすべて true である必要があります。
ConvertToOwnerAuth メソッドを使用して、パスフレーズを OwnerAuth パラメーターに使用される入力値に変更する必要があります。
TakeOwnership メソッドは、適切なグループ ポリシー設定が構成されている場合、所有者の承認値を Active Directory にバックアップします。
マネージド オブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Windows SDK の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられているロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2008 [デスクトップ アプリのみ] |
| 名前空間 |
Root\CIMV2\Security\MicrosoftTpm |
| MOF |
|
| [DLL] |
|
関連項目