Share via

NewByGuardians method of the MSFT_HgsKeyProtector class

  • Article

Creates a new key protector.

Syntax

uint32 NewByGuardians(
  [in]  boolean              AllowUntrustedRoot,
  [in]  boolean              AllowExpired,
  [in]  MSFT_HgsGuardian     Owner,
  [in]  MSFT_HgsGuardian     Guardian[],
  [out] MSFT_HgsKeyProtector cmdletOutput
);

Parameters

AllowUntrustedRoot [in]

When specified, allows new key protector creation with one or more guardians using self-signed certificates.

AllowExpired [in]

When specified allows new key protector creation with one or more guardians using expired certificates.

Owner [in]

An embedded instance of a MSFT_HgsGuardian class that represents the owner.

Guardian [in]

An array of embedded instances of MSFT_HgsGuardian classes that represents the guardians who are granted access to the key protected by the new key protector.

cmdletOutput [out]

Returns an embedded instance of a MSFT_HgsKeyProtector class that represents the new key protector.

Requirements
Minimum supported client
 Windows 10 [desktop apps only]
Minimum supported server
 Windows Server 2016
Namespace
 Root\Microsoft\Windows\Hgs
MOF
HgsClientWmi.mof
DLL
HgsClientWmi.dll

See also

MSFT_HgsKeyProtector