New-DSPamSecurity

2025-01-21

New-DSPamSecurity

SYNOPSIS

Create a new PamUserPermission object

SYNTAX

__AllParameterSets

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

ALIASES

This cmdlet has the following aliases,

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
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
  Position: 2
  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
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  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
ParameterValue: []
Aliases: []
ParameterSets:
- Name: (All)
  Position: 3
  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.

INPUTS

OUTPUTS

Devolutions.Server.ApiWrapper.Models.Pam.Dto.Permission.PamUserPermission

NOTES

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

RELATED LINKS