Preview3 changes

.ci/templates/sign.yml

@@ -66,6 +66,7 @@ steps:
     Copy-Item ${{ parameters.buildOutputPath }}\* ${{ parameters.signOutputPath }}\ -Recurse -Force -Verbose
   displayName: Prepare output folder
   timeoutInMinutes: 10
+  condition: and(and(and(succeeded(), eq(variables['Build.Reason'], 'Manual')), ne(variables['SkipSigning'], 'True')), ne(variables['SigningServer'], ''))
 
 - task: SFP.build-tasks.custom-build-task-1.EsrpCodeSigning@1
   displayName: Sign files

CHANGELOG.md

@@ -1,5 +1,25 @@
 # CHANGELOG
 
+## 0.5.3-Preview3 - 2020-11-4
+
+### Fixes
+
+### Changes
+
+- `Set-SecretStoreConfiguration` now has a `-PassThru` parameter to write the store configuration object to the pipeline, and no longer writes the configuration object by default (Issue #25).
+
+- A `-PasswordTimeout` value of zero now allows the provided password to be used only once (Issue #30).
+
+- When setting a password, an empty password is no longer accepted (Issue #31).
+
+- `Set-SecretStorePassword` now has a parameter set that takes old/new password arguments, to allow setting password by automation (Issue #26).
+
+- `Reset-SecretStore` now has a new `-Password` and `-PassThru` parameter.
+
+- `Reset-SecretStore` will now prompt immediately for a new password, if password authentication is selected and prompt interaction is allowed (Issue #34)
+
+### New Features
+
 ## 0.5.2-Preview2 - 2020-10-01
 
 ### Breaking Changes

build.ps1

@@ -40,7 +40,7 @@ param (
     [string] $BuildFramework = "netstandard2.0"
 )
 
-if ( ! ( Get-Module -ErrorAction SilentlyContinue PSPackageProject) ) {
+if ( ! (Get-Module -ErrorAction SilentlyContinue PSPackageProject -ListAvailable)) {
     Install-Module -Name PSPackageProject -MinimumVersion 0.1.17 -Force
 }
 

help/Reset-SecretStore.md

@@ -26,12 +26,17 @@ Default configuration options can be overridden by specifying individual command
 
 ### Example 1
 ```powershell
-PS C:\> Reset-SecretStore
+PS C:\> Reset-SecretStore -PassThru
 WARNING: !!This operation will completely remove all SecretStore module secrets and reset configuration settings to default values!!
 
 Reset SecretStore
 Are you sure you want to erase all secrets in SecretStore and reset configuration settings to default?
 [Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"): Y
+Creating a new Microsoft.PowerShell.SecretStore vault. A password is required by the current store configuration.
+Enter password:
+********
+Enter password again for verification:
+********
 
       Scope Authentication PasswordTimeout Interaction
       ----- -------------- --------------- -----------
@@ -62,7 +67,7 @@ Accept wildcard characters: False
 ```
 
 ### -Force
-When true, the user will not be asked to confirm and the SecretStore will be reset without prompting.
+When used, the user will not be asked to confirm and the SecretStore will be reset without prompting.
 Default value is false, and user will be asked to confirm the operation.
 
 ```yaml
@@ -77,6 +82,37 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -Password
+Sets the provided Password to the newly reset store.
+If the reset store is not configured for password authentication, an error will be returned.
+
+```yaml
+Type: SecureString
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value:
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
+### -PassThru
+Writes the newly reset store configuration object (SecureStorConfig) to the pipeline.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -PasswordTimeout
 Configuration option that provides the session password timeout in seconds.
 Takes an argument whose value determines the session password timeout in seconds.

help/Set-SecretStoreConfiguration.md

@@ -81,7 +81,7 @@ Accept wildcard characters: False
 ```
 
 ### -Force
-When true, the user will not be asked to confirm and the SecretStore will be reset without prompting.
+When used, the user will not be asked to confirm and the SecretStore will be reset without prompting.
 Default value is false, and user will be asked to confirm the operation.
 
 ```yaml
@@ -96,6 +96,21 @@ Accept pipeline input: False
 Accept wildcard characters: False
 ```
 
+### -PassThru
+When used, will write the current SecretStore configuration to the pipeline.
+
+```yaml
+Type: SwitchParameter
+Parameter Sets: (All)
+Aliases:
+
+Required: False
+Position: Named
+Default value: False
+Accept pipeline input: False
+Accept wildcard characters: False
+```
+
 ### -PasswordTimeout
 Configuration option that provides the session password timeout in seconds.
 Takes an argument whose value determines the session password timeout in seconds.

help/Set-SecretStorePassword.md

@@ -39,8 +39,47 @@ This example runs the command with no parameter arguments.
 The user is first prompted for the old password.
 And then prompted for the new password twice for verification.
 
+### Example 2
+```powershell
+PS C:\> Set-SecretStorePassword -NewPassword $newPassword -Password $oldPassword
+```
+
+This example runs the command passing in both the current store password and the new
+password to be set.
+
 ## PARAMETERS
 
+### -NewPassword
+New password to be applied to the store.
+
+```yaml
+Type: SecureString
+Parameter Sets: ParameterSet
+Aliases:
+
+Required: True
+Position: Named
+Default value:
+Accept pipeline input: True
+Accept wildcard characters: False
+```
+
+### -Password
+Existing password needed to unlock the store.
+This can be ignored if the store doesn't currently use a password.
+
+```yaml
+Type: SecureString
+Parameter Sets: ParameterSet
+Aliases:
+
+Required: False
+Position: Named
+Default value:
+Accept pipeline input: False
+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](http://go.microsoft.com/fwlink/?LinkID=113216).