Initialize-Tpm
Initialize-Tpm
Performs part of the provisioning process for a TPM.
Syntax
Parameter Set: __AllParameterSets
Initialize-Tpm [[-AllowClear]] [[-AllowPhysicalPresence]] [ <CommonParameters>]
Detailed 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 at https://technet.microsoft.com/en-us/library/jj131725.aspx.
Parameters
-AllowClear
Indicates that the provisioning process clears the TPM, if necessary, to move the TPM closer to complying with Windows Server® 2012 standards.
Aliases |
none |
Required? |
false |
Position? |
2 |
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.
Aliases |
none |
Required? |
false |
Position? |
3 |
Default Value |
none |
Accept Pipeline Input? |
false |
Accept Wildcard Characters? |
false |
<CommonParameters>
This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Inputs
The input type is the type of the objects that you can pipe to the cmdlet.
- SwitchParameter
Outputs
The output type is the type of the objects that the cmdlet emits.
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.
Examples
Example 1: Initialize a TPM
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.
PS C:\> Initialize-Tpm -ForceClearAllowed -PhysicalPresenceAllowed