Set-DSEntityPermission

Synopsis

Définit les permissions sur une entité donnée.

Syntaxe

__AllParameterSets

Set-DSEntityPermission [-EntityId] <guid> [[-Permissions] <PSPermissionWrapper[]>]
 [[-PermissionOverride] <SecurityRoleOverride>] [-OverrideExistingPermissions] [-AsLegacyResponse]
 [<CommonParameters>]

Description

Définit les permissions sur une entité donnée (coffre, dossier ou entrée).

Exemples

Exemple 1

$Permissions = @( [Devolutions.RemoteDesktopManager.Business.ConnectionPermission]@{ Override = [Devolutions.RemoteDesktopManager.SecurityRoleOverride]::Custom Right = [Devolutions.RemoteDesktopManager.SecurityRoleRight]::View Roles = @($UserId1, $UserId2, $RoleId1) }, [Devolutions.RemoteDesktopManager.Business.ConnectionPermission]@{ Override = [Devolutions.RemoteDesktopManager.SecurityRoleOverride]::Inherited Right = [Devolutions.RemoteDesktopManager.SecurityRoleRight]::Edit Roles = @($UserId1, $UserId2, $RoleId1) } ) > Set-DSEntityPermissions -EntityId $ID -Permissions $Permissions

• Pour remplacer les permissions déjà existantes, veuillez utiliser le paramètre de commutateur 'OverrideExistingPermissions'. - Lors de l'utilisation de ce cmdlet, le mode de remplacement de votre entité sera défini par défaut sur 'Custom'. Utilisez le paramètre 'PermissionOverride' si vous souhaitez le définir autrement.

Exemple 2

PS C:\> Set-DSEntityPermissions -EntityId $ID -PermissionOverride 'Default'

Pour l'entrée dont l'identifiant est stocké dans $ID, toutes ses permissions seront héritées du parent.

Exemple 3

PS C:\> $userIDs = Get-DSUser | Where Name -like *something* | Select -ExpandProperty ID
        $permission = New-DSEntityPermission -Override CustomInherited -Right Edit -ID $userIDs
        Set-DSEntityPermission -EntityID $entryID -Permissions $permission

Ajoute les utilisateurs dont le nom contient 'something' aux utilisateurs hérités pouvant modifier l'entrée dont l'identifiant est stocké dans $entryID.

Paramètres

-AsLegacyResponse

Dans les versions antérieures à 2024.2, de nombreux cmdlets DS retournaient un objet ServerResponse. L'activation de ce commutateur de compatibilité descendante permet aux scripts développés pour des versions antérieures de fonctionner correctement.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: Named
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-EntityId

Identifiant de l'entité pour laquelle vous souhaitez modifier les permissions.

Type: System.Guid
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 0
  IsRequired: true
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-OverrideExistingPermissions

Remplace les permissions existantes. Sans ce paramètre, toutes les permissions personnalisées existantes ne seront pas écrasées par celles spécifiées avec le paramètre Permissions.

Type: System.Management.Automation.SwitchParameter
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 3
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

-PermissionOverride

Détermine les permissions pour l'entrée. Si non spécifié et que le paramètre Permissions est utilisé, la valeur sera définie sur 'Custom'. Quatre options sont disponibles : Default => Hérite les permissions des groupes parents. Custom => Vous permet de spécifier une valeur personnalisée pour chacune des permissions. Everyone => Identique à Allowed dans l'interface. Accorde toutes les permissions à tout le monde. Never => Identique à Disallowed dans l'interface. Accorde la permission à personne, à l'exception des administrateurs.

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

-Permissions

Objet de permission. L'objet peut être créé à partir de New-DSEntityPermission ou directement depuis le type [Devolutions.RemoteDesktopManager.Business.ConnectionPermission].

Type: RemoteDesktopManager.PowerShellModule.PSOutputObject.PSWrapper.PSPermissionWrapper[]
DefaultValue: ''
SupportsWildcards: false
Aliases: []
ParameterSets:
- Name: (All)
  Position: 1
  IsRequired: false
  ValueFromPipeline: false
  ValueFromPipelineByPropertyName: false
  ValueFromRemainingArguments: false
DontShow: false
AcceptedValues: []
HelpMessage: ''

CommonParameters

Ce cmdlet prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d'informations, consultez about_CommonParameters.

Notes

Pour plus d'informations, tapez "Get-Help Set-DSEntityPermission -detailed". Pour des informations techniques, tapez "Get-Help Set-DSEntityPermission -full".