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
PowerShell