Functions/User/Set-PASUserPassword.ps1
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 |
# .ExternalHelp psPAS-help.xml function Set-PASUserPassword { [CmdletBinding(SupportsShouldProcess)] param( [parameter( Mandatory = $true, ValueFromPipelinebyPropertyName = $true )] [int]$id, [parameter( Mandatory = $true, ValueFromPipelinebyPropertyName = $true )] [securestring]$NewPassword ) BEGIN { Assert-VersionRequirement -RequiredVersion 10.10 }#begin PROCESS { #Get request parameters $boundParameters = $PSBoundParameters | Get-PASParameter -ParametersToRemove id $Password = ConvertTo-InsecureString -SecureString $NewPassword If ($Password.length -gt 39) { throw 'Password must not exceed 39 characters' } #Include decoded password in request $boundParameters['NewPassword'] = $Password #Create URL for request $URI = "$Script:BaseURI/api/Users/$id/ResetPassword" #create request body $body = $boundParameters | ConvertTo-Json if ($PSCmdlet.ShouldProcess($id, 'Reset Password')) { #send request to web service Invoke-PASRestMethod -Uri $URI -Method POST -Body $Body -WebSession $Script:WebSession } }#process END { }#end } |