From bb1d81e6eee28ee02fc454f3eeccb00f1a999c70 Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Wed, 25 Aug 2021 15:25:48 +0000 Subject: [PATCH 1/7] Add param to docs. --- .../trustedplatformmodule/Clear-Tpm.md | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md index 665f4580fe..d9e868757e 100644 --- a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md +++ b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md @@ -17,7 +17,7 @@ Resets a TPM to its default state. ### Owner Auth (Default) ``` -Clear-Tpm [[-OwnerAuthorization] ] [] +Clear-Tpm [-UsePPI] [[-OwnerAuthorization] ] [] ``` ### File @@ -115,6 +115,21 @@ Accept pipeline input: True (ByValue) Accept wildcard characters: False ``` +### -UsePPI +{{ Fill UsePPI Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: Owner Auth +Aliases: ppi + +Required: False +Position: Named +Default value: None +Accept pipeline input: True (ByValue) +Accept wildcard characters: False +``` + ### CommonParameters This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). From 4229d1c9d0fb55165e69a8abdd0653aa1e0a5f65 Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Fri, 27 Aug 2021 12:45:56 -0700 Subject: [PATCH 2/7] Add desc and example. --- .../trustedplatformmodule/Clear-Tpm.md | 23 ++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md index d9e868757e..8000df15b0 100644 --- a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md +++ b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md @@ -82,6 +82,25 @@ SelfTest : {191, 191, 245, 191...} This command resets the TPM by using the owner authorization value included in the specified file. +### Example 4: Reset TPM with Physical Presence Interface +``` +PS C:\> Clear-Tpm -UsePPI +TpmReady : False +TpmPresent : True +ManagedAuthLevel : Full +OwnerAuth : +OwnerClearDisabled : True +AutoProvisioning : Disabled +LockedOut : False +SelfTest : {191, 191, 245, 191...} +``` + +This command resets the TPM by using the Physical Presence Interface (PPI). +PPI does not use a value for owner authorization. + +Restart the system for the clear action to take effect. +That restart might require user input to approve the clear request. + ## PARAMETERS ### -File @@ -116,7 +135,9 @@ Accept wildcard characters: False ``` ### -UsePPI -{{ Fill UsePPI Description }} +Use the PPI for the TPM reset. +Restart the system for the changes to take effect. +The restart might require user input to approve the clear request. ```yaml Type: SwitchParameter From d3eab6ed100f52ef7b71d280f580004a6a96d7d8 Mon Sep 17 00:00:00 2001 From: Tim Sherer <28902327+TimShererWithAquent@users.noreply.github.com> Date: Mon, 30 Aug 2021 14:41:23 +0000 Subject: [PATCH 3/7] Apply suggestions from code review Co-authored-by: JohanFreelancer9 <48568725+JohanFreelancer9@users.noreply.github.com> --- docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md index 8000df15b0..dc2367d095 100644 --- a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md +++ b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md @@ -96,10 +96,10 @@ SelfTest : {191, 191, 245, 191...} ``` This command resets the TPM by using the Physical Presence Interface (PPI). -PPI does not use a value for owner authorization. +The PPI does not use a value for owner authorization. Restart the system for the clear action to take effect. -That restart might require user input to approve the clear request. +The restart might require user input to approve the clear request. ## PARAMETERS From 1844ccaedec0f79695268c65872baad729b8b65c Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Thu, 9 Sep 2021 13:02:25 -0700 Subject: [PATCH 4/7] Add feedback. --- .../trustedplatformmodule/Clear-Tpm.md | 20 +++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md index 8000df15b0..af6e2b093e 100644 --- a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md +++ b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md @@ -37,8 +37,11 @@ For more information on TPM, see the [Trusted Platform Module Technology Overvie ## EXAMPLES ### Example 1: Reset TPM -``` +```powershell PS C:\> Clear-Tpm +``` + +```output TpmReady : False TpmPresent : True ManagedAuthLevel : Full @@ -53,8 +56,11 @@ This command resets the TPM. The command uses the owner authorization value stored in the registry instead of specifying a value or using a value in a file. ### Example 2: Reset TPM with a supplied authorization value -``` +```powershell PS C:\> Clear-Tpm -OwnerAuthorization "vjnuW6rToM41os3xxEpjLdIW2gA=" +``` + +```output TpmReady : False TpmPresent : True ManagedAuthLevel : Full @@ -68,8 +74,11 @@ SelfTest : {191, 191, 245, 191...} This command resets the TPM by using the specified owner authorization value. ### Example 3: Reset TPM using authorization value from file -``` +```powershell PS C:\> Clear-Tpm -File "MyOwnerAuthFile.tpm" +``` + +```output TpmReady : False TpmPresent : True ManagedAuthLevel : Full @@ -83,8 +92,11 @@ SelfTest : {191, 191, 245, 191...} This command resets the TPM by using the owner authorization value included in the specified file. ### Example 4: Reset TPM with Physical Presence Interface -``` +```powershell PS C:\> Clear-Tpm -UsePPI +``` + +```output TpmReady : False TpmPresent : True ManagedAuthLevel : Full From c658b63e85a52c7fd9a8e944033991cc33382418 Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Thu, 9 Sep 2021 13:12:12 -0700 Subject: [PATCH 5/7] Pull prompts from examples. --- .../winserver2022-ps/trustedplatformmodule/Clear-Tpm.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md index 3bb460db3d..16ecf36ff0 100644 --- a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md +++ b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md @@ -38,7 +38,7 @@ For more information on TPM, see the [Trusted Platform Module Technology Overvie ### Example 1: Reset TPM ```powershell -PS C:\> Clear-Tpm +Clear-Tpm ``` ```output @@ -57,7 +57,7 @@ The command uses the owner authorization value stored in the registry instead of ### Example 2: Reset TPM with a supplied authorization value ```powershell -PS C:\> Clear-Tpm -OwnerAuthorization "vjnuW6rToM41os3xxEpjLdIW2gA=" +Clear-Tpm -OwnerAuthorization "vjnuW6rToM41os3xxEpjLdIW2gA=" ``` ```output @@ -75,7 +75,7 @@ This command resets the TPM by using the specified owner authorization value. ### Example 3: Reset TPM using authorization value from file ```powershell -PS C:\> Clear-Tpm -File "MyOwnerAuthFile.tpm" +Clear-Tpm -File "MyOwnerAuthFile.tpm" ``` ```output @@ -93,7 +93,7 @@ This command resets the TPM by using the owner authorization value included in t ### Example 4: Reset TPM with Physical Presence Interface ```powershell -PS C:\> Clear-Tpm -UsePPI +Clear-Tpm -UsePPI ``` ```output From ff626edffe04dd805643d99bd466778a5f08608b Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Thu, 9 Sep 2021 13:28:42 -0700 Subject: [PATCH 6/7] Add text. --- .../winserver2022-ps/trustedplatformmodule/Clear-Tpm.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md index 16ecf36ff0..745f555d89 100644 --- a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md +++ b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md @@ -41,6 +41,8 @@ For more information on TPM, see the [Trusted Platform Module Technology Overvie Clear-Tpm ``` +The cmdlet displays the following output: + ```output TpmReady : False TpmPresent : True @@ -60,6 +62,8 @@ The command uses the owner authorization value stored in the registry instead of Clear-Tpm -OwnerAuthorization "vjnuW6rToM41os3xxEpjLdIW2gA=" ``` +The cmdlet displays the following output: + ```output TpmReady : False TpmPresent : True @@ -78,6 +82,8 @@ This command resets the TPM by using the specified owner authorization value. Clear-Tpm -File "MyOwnerAuthFile.tpm" ``` +The cmdlet displays the following output: + ```output TpmReady : False TpmPresent : True @@ -96,6 +102,8 @@ This command resets the TPM by using the owner authorization value included in t Clear-Tpm -UsePPI ``` +The cmdlet displays the following output: + ```output TpmReady : False TpmPresent : True From 1adf62e06df26e49f7c971d0524eec8b244dc641 Mon Sep 17 00:00:00 2001 From: TimShererWithAquent <28902327+TimShererWithAquent@users.noreply.github.com> Date: Thu, 9 Sep 2021 13:45:56 -0700 Subject: [PATCH 7/7] Code block formatting. --- .../trustedplatformmodule/Clear-Tpm.md | 12 ------------ 1 file changed, 12 deletions(-) diff --git a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md index 745f555d89..3145fde8e4 100644 --- a/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md +++ b/docset/winserver2022-ps/trustedplatformmodule/Clear-Tpm.md @@ -40,9 +40,6 @@ For more information on TPM, see the [Trusted Platform Module Technology Overvie ```powershell Clear-Tpm ``` - -The cmdlet displays the following output: - ```output TpmReady : False TpmPresent : True @@ -61,9 +58,6 @@ The command uses the owner authorization value stored in the registry instead of ```powershell Clear-Tpm -OwnerAuthorization "vjnuW6rToM41os3xxEpjLdIW2gA=" ``` - -The cmdlet displays the following output: - ```output TpmReady : False TpmPresent : True @@ -81,9 +75,6 @@ This command resets the TPM by using the specified owner authorization value. ```powershell Clear-Tpm -File "MyOwnerAuthFile.tpm" ``` - -The cmdlet displays the following output: - ```output TpmReady : False TpmPresent : True @@ -101,9 +92,6 @@ This command resets the TPM by using the owner authorization value included in t ```powershell Clear-Tpm -UsePPI ``` - -The cmdlet displays the following output: - ```output TpmReady : False TpmPresent : True