Initialize-Tpm

  • Reference
Module:
TrustedPlatformModule

Performs part of the provisioning process for a TPM.

Syntax

Initialize-Tpm
          [-AllowClear]
          [-AllowPhysicalPresence]
          [<CommonParameters>]

Description

The Initialize-Tpm cmdlet performs part of the provisioning process for a Trusted Platform Module (TPM). Provisioning is the process of preparing a TPM to be used. You may need to perform other steps to fully provision a TPM.

For more information on TPM, see the Trusted Platform Module Technology Overview in the Technet library.

Examples

Example 1: Initialize a TPM

PS C:\> Initialize-Tpm -AllowClear -AllowPhysicalPresence
TpmReady                 : False
RestartRequired          : True
ShutdownRequired         : False
ClearRequired            : True
PhysicalPresenceRequired : True

This command initializes a TPM. The AllowClear parameter means that a TPM owner authorization value stored in the registry is used to clear the TPM if the TPM is configured to accept TPM_OwnerClear commands. The AllowPhysicalPresence parameter means that the cmdlet is allowed to issue a clear request which must be confirmed by a physical present user during the next restart.

The cmdlet returns an object with information about the state of the provisioning process.

Parameters

-AllowClear

Indicates that the provisioning process clears the TPM, if necessary, to move the TPM closer to complying with latest Windows standards.

Type:SwitchParameter
Aliases:c
Position:1
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AllowPhysicalPresence

Indicates that the provisioning process may send physical presence commands that require a user to be present in order to continue.

Type:SwitchParameter
Aliases:p
Position:2
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

SwitchParameter

Outputs

TpmProvisioningObject

This cmdlet returns a TpmProvisioningObject object that includes the following information:

  • TpmReady. Whether the TPM is complies with latest Windows standards.
  • RestartRequired. Whether the computer requires a restart to continue the provisioning process.
  • ShutdownRequired. Whether the computer must be shut down to continue the provisioning process.
  • ClearRequired. If this has a value of True, you must import an owner authorization value or remove the owner authorization value.
  • PhysicalPresenceRequired. Whether a person must be at the computer during restart to continue the provisioning process.