Enable-DSPamProviderSelfRotation

Synopsis

Enable self-rotation for a PAM Provider.

Syntax

__AllParameterSets

Enable-DSPamProviderSelfRotation -Provider <PamProvider> [<CommonParameters>]

Description

Converts a PAM provider's own custom username/password into a server-managed, self-rotating PAM account (a sub-entry of the provider), so the provider's own credentials can be rotated, checked out, and heartbeat-verified like any other PAM account. Works on a provider just created or on any pre-existing provider that still holds its own custom credentials.

Examples

Example 1

PS C:\> $provider = New-DSPamProvider -Name "MyProvider" -CredentialType LocalUser -Username "admin" -Password "P@ssw0rd"
PS C:\> $provider | Enable-DSPamProviderSelfRotation

Create a provider with custom credentials, then convert those credentials into a self-rotating managed PAM account.

Example 2

PS C:\> $provider = Get-DSPamProvider | Where-Object { $_.Label -eq 'MyProvider' }
PS C:\> Enable-DSPamProviderSelfRotation -Provider $provider

Enable self-rotation on a provider that was created before this feature existed.

Parameters

-Provider

Provider object obtained from New-DSPamProvider or Get-DSPamProvider

Type: Devolutions.Server.Pam.Dto.PamProvider
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: true
  ValueFromPipeline: true
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

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.

Inputs

Devolutions.Server.Pam.Dto.PamProvider

PAM provider object obtained from New-DSPamProvider or Get-DSPamProvider

Notes

For more information, type "Get-Help Enable-DSPamProviderSelfRotation -detailed". For technical information, type "Get-Help Enable-DSPamProviderSelfRotation -full".