Initialize-Tpm

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 -ForceClearAllowed -PhysicalPresenceAllowed
TpmReady                 : False
RestartRequired          : True
ShutdownRequired         : False
ClearRequired            : True
PhysicalPresenceRequired : True

This command initializes a TPM. The ForceClearAllowed parameter means that the owner authorization value needs to be imported or reset in order for provisioning to continue. The PhysicalPresenceAllowed parameter means that a user must be present during a restart to continue the process.

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

Optional Parameters

-AllowClear

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

Type: SwitchParameter
Aliases: c
Position: 1
Default value: None
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
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 Windows Server® 2012 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.