ConvertTo-DSAccountLifecyclePolicyInfo

Convert an account lifecycle policy to PowerShell format.

ConvertTo-DSAccountLifecyclePolicyInfo -AccountLifecyclePolicy <AccountLifecyclePolicyInfo>
 [<CommonParameters>]

Convert an account lifecycle policy to the PowerShell-friendly PSAccountLifecyclePolicyInfo format.

PS C:\> $provider = Get-DSPamProvider | Where-Object { $_.Label -eq 'MyProvider' }
PS C:\> $template = Get-DSPasswordPolicy -Name "Strong password"
PS C:\> $script = Get-DSScriptConfigurationSummary -Name "My propagation script"
PS C:\> $gateway = Get-DSGateway -Name 'MyGateway'
PS C:\> $policy = ConvertTo-DSAccountLifecyclePolicyInfo -AccountLifecyclePolicy $provider.AccountLifecyclePolicy
PS C:\> $policy.Source = 'Custom'
PS C:\> $policy.PolicyID = 'Custom'
PS C:\> $policy.Policy.PasswordTemplate.Mode = 'Custom'
PS C:\> $policy.Policy.PasswordTemplate.TemplateID = $template.ID
PS C:\> $policy.Policy.CheckInAction.Mode = 'Custom'
PS C:\> $policy.Policy.CheckInAction.Actions = @('ResetPassword')
PS C:\> $policy.Policy.PasswordReset.ScheduleMode = 'Custom'
PS C:\> $policy.Policy.PasswordReset.ScheduleFrequency = 30
PS C:\> $policy.Policy.PasswordReset.ScheduleFrequencyUnit = 'Day'
PS C:\> $policy.Policy.PasswordReset.ScheduleAtDateTime = Get-Date -Hour 14 -Minute 0 -Second 0
PS C:\> $policy.Policy.Propagation.Mode = 'Custom'
PS C:\> $policy.Policy.Propagation.ScriptConfigurationIds = @($script.ID)
PS C:\> Update-DSPamProvider -ProviderID $provider.ID -AccountLifecyclePolicy $policy -Gateway $gateway

Get an existing PAM provider, convert its account lifecycle policy to PowerShell format, modify multiple properties, and update the provider. Note: ResetPassword in CheckInAction.Actions corresponds to the Password rotation option in the UI.

The account lifecycle policy to convert.

Type: Devolutions.RemoteDesktopManager.Business.AccountLifecyclePolicyInfo
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: true
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

Account lifecycle policy from a PAM provider.

For more information, type "Get-Help ConvertTo-DSAccountLifecyclePolicyInfo -detailed". For technical information, type "Get-Help ConvertTo-DSAccountLifecyclePolicyInfo -full".