Edit

Share via

Initialize-Tpm

Module:
TrustedPlatformModule Module

Performs part of the provisioning process for a TPM.

Syntax

Default (Default) 

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.

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:c

Parameter sets

(All)
Position:1
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AllowPhysicalPresence

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

Parameter properties

Type:SwitchParameter
Default value:None
Supports wildcards:False
DontShow:False
Aliases:p

Parameter sets

(All)
Position:2
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

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.