Set-DSEntityPermission

Synopsis

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

Syntaxe

__AllParameterSets

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

Description

Définir 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 existantes, veuillez utiliser le paramètre switch 'OverrideExistingPermissions'. - Lorsque vous utilisez cette CMDlet, le mode de remplacement de votre entité sera défini par défaut sur 'Personnalisé'. Utilisez le paramètre 'PermissionOverride' si vous souhaitez le définir sur autre chose.

Exemple 2

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

Pour l'entrée dont l'ID 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

Ajouter des utilisateurs dont le nom contient « something » aux utilisateurs hérités qui peuvent modifier l'entrée dont l'ID est stocké dans $entryID

Paramètres

-AsLegacyResponse

Dans les versions antérieures à 2024.2, de nombreux applets de commande DS renvoyaient un objet ServerResponse. Activer ce commutateur de compatibilité arrière permet aux scripts développés pour les anciennes versions 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

ID de l'entité pour laquelle vous souhaitez changer 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

Écraser les permissions existantes. Sans ce paramètre, toutes les permissions personnalisées existantes ne seront pas remplacé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éterminer les permissions pour l'entrée. Si non spécifié et que le paramètre Permissions est utilisé, il sera défini sur 'Personnalisé'. Quatre options sont disponibles Par défaut => Hérite des permissions des groupes parents. Personnalisé => Vous permet de spécifier une valeur personnalisée pour chacune des permissions. Tout le monde => Identique à Autorisé dans l'interface utilisateur. Accorde toutes les permissions à tout le monde. Jamais => Identique à Non autorisé dans l'interface utilisateur. Accorde la permission à personne sauf les 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 du 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: ''

ParamètresCommuns

Cette applet de commande prend en charge les paramètres communs: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, et -WarningVariable. Pour plus d'informations, voir about_CommonParameters.

Notes

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

Devolutions Forum logo Donnez-nous vos commentaires