Unlock-SecretStore

  • リファレンス
モジュール:
Microsoft.PowerShell.SecretStore

指定されたパスワードを使用して SecretStore のロックを解除します。

構文

Unlock-SecretStore
      -Password <SecureString>
      [-PasswordTimeout <Int32>]
      [<CommonParameters>]

説明

このコマンドレットは、指定されたパスワードを使用して、現在のユーザーの SecretStore のロックを解除します。 構成にパスワードが必要で、プロンプト構成オプションが無効になっている場合に 、SecretStore のロックを解除するために使用できます。 SecretStore は、構成されたパスワード タイムアウトが経過するまで、セッションでロック解除されたままになります。

例

例 1

PS C:\> Get-Secret Secret1 -Vault LocalStore
Get-Secret: A valid password is required to access the Microsoft.PowerShell.SecretStore vault.
Get-Secret: The secret Secret1 was not found.

PS C:\> Unlock-SecretStore

cmdlet Unlock-SecretStore at command pipeline position 1
Supply values for the following parameters:
SecureStringPassword: *******

PS C:\> Get-Secret Secret1 -Vault LocalStore
System.Security.SecureString

この例では、 Get-Secretは SecretStore コンテナーがロックされているため、取得Secret1に失敗します。 Unlock-SecretStore コンテナーのロックを解除します。 Password パラメーターが指定されていないため、このコマンドレットはパスワードの入力を求めます。 コンテナーのロックを解除すると、 Get-Secret は Secret1SecureString オブジェクトとして を返します。

パラメーター

-Password

SecretStore にアクセスするために必要なパスワードを指定します。

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PasswordTimeout

パスワードで認証した後に SecretStore のロックを解除したままの秒数を指定します。 このパラメーターは、構成されたパスワード タイムアウト値をオーバーライドします。 タイムアウトが経過すると、セッションの現在のパスワード値が無効になります。 タイムアウト後に SecretStore にアクセスするには、もう一度パスワードが必要です。

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

SecureString

出力

None