Set-SecretStoreConfiguration

SecretStore を構成します。

構文

Set-SecretStoreConfiguration
   [-Scope <SecureStoreScope>]
   [-Authentication <Authenticate>]
   [-PasswordTimeout <Int32>]
   [-Interaction <Interaction>]
   [-Password <SecureString>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-SecretStoreConfiguration
   [-Default]
   [-Password <SecureString>]
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

このコマンドレットは、現在のユーザーの SecretStore を構成します。

例 1

PS C:\> Set-SecretStoreConfiguration -Default

Confirm
Are you sure you want to perform this action?
Performing the operation "Changes local store configuration" on target "SecretStore module local store".
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "Y"): Y

      Scope Authentication PasswordTimeout Interaction
      ----- -------------- --------------- -----------
CurrentUser       Password             900      Prompt

次の使用例は、 SecretStore を既定の構成に復元します。

パラメーター

-Authentication

SecretStore へのアクセスを認証する方法を指定します。 値は Password または None である必要があります。 として None指定した場合、コマンドレットはパスワードなしで SecretStore にアクセスできるようにします。 既定の認証は です Password

注意事項

認証を に設定するとNone、 よりも安全性が低くなりますPassword。 の指定は、シナリオの None テストに役立ちますが、重要なシークレットでは使用しないでください。

Type:Authenticate
Position:Named
Default value:Password
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Default

SecretStore を既定の構成に設定する必要があることを示します。

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

-Interaction

SecretStore がユーザーにアクセスするときにプロンプトを表示するかどうかを指定します。 値が の場合、 Promptユーザーは必要に応じて対話型セッションでパスワードの入力を求められます。 値が の None場合、ユーザーはパスワードの入力を求めません。 値が で None 、パスワードが必要な場合、パスワードを必要とするコマンドレットは Microsoft.PowerShell.SecretStore.PasswordRequiredException エラーをスローします。

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

-PassThru

コマンドレットを更新した後に SecretStore 構成を返す必要があることを示します。 既定では、コマンドレットは出力を返しません。

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

-Password

SecretStore にアクセスするために必要なパスワードを指定します。 このパラメーターを使用して既存のパスワードを変更することはできません。 既存のパスワードを変更するには、 を使用します Set-SecretStorePassword

認証の構成を から None に変更するために Authenticate パラメーターと共にこのパラメーターをPassword使用する場合、このパラメーターの値は SecretStore の新しいパスワードとして設定されます。

認証の構成を から Password に変更するために Authenticate パラメーターと共にこのパラメーターを使用するNone場合、このパラメーターの値は SecretStore の現在のパスワードである必要があります。 構成の変更を承認するために使用されます。

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

-PasswordTimeout

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

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

-Scope

SecretStore が構成されているコンテキストを指定します。 現在は、CurrentUser のみがサポートされています。

Type:SecureStoreScope
Accepted values:CurrentUser, AllUsers
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

出力

Microsoft.PowerShell.SecretStore.SecureStoreConfig