New-DSPamSecurity

Synopsis

Create a new PamUserPermission object

Syntax

__AllParameterSets

New-DSPamSecurity [-Role] <PamRoleType> [-Mode] <PermissionResolutionMode> [[-UserID] <guid[]>]
 [<CommonParameters>]

Description

Create a new PamUserPermission object. This can be used to update the security of pam vaults and pam accounts.

Examples

Example 1

PS C:\> $security = New-DSPamSecurity -Role Approver -Mode Global;
    Update-DSPamFolder -FolderID $pamFolderID -Security $security

For the PAM folder whose ID is stored in $pamFolderID, its approver security will be set to 'System default'.

Example 2

PS C:\> $usersResponse = Get-DSUser;
    $user = $usersResponse.Data | Where Name -eq 'MyUserName';
    $security = New-DSPamSecurity -Role Owner -Mode Override -UserID $user.ID;
    New-DSPamFolder -Name 'MyNewPamVault' -Security $security -AsNewvault

Create a new PAM vault whose owner is 'MyUserName'

Parameters

-Mode

Resolution mode: Global (System default | Inherited), Override (Custom), Both

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

-Role

Predefined role.

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

-UserID

Ids of the users or applications to give access

Type: System.Guid[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 2
  IsRequired: false
  ValueFromPipeline: false
  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.

Notes

For more information, type "Get-Help New-DSPamSecurity -detailed". For technical information, type "Get-Help New-DSPamSecurity -full".