> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell/fr/powershell-commands/new-dsentitypermission.md). # New-DSEntityPermission ### Synopsis Créer un objet de permission pour une entité ### Syntaxe #### WithExistenceCheck (Default) ``` New-DSEntityPermission [-Override] [-Right] [-User ] [-Role ] [-Application ] [] ``` #### WithoutExistenceCheck ``` New-DSEntityPermission [-Override] [-Right] [-PrincipalId] [] ``` ### Description Créer un objet de permission pour une entité. Les paramètres User, Role et Application peuvent être spécifiés par leur identifiant ou leur nom. Pour une application, le nom fait référence à l'identifiant d'application, car le nom affiché n'est pas nécessairement unique. L'existence de toutes les entités sera confirmée, avec un message d'avertissement pour celles qui sont introuvables. Le paramètre ID n'accepte que des identifiants, qu'ils correspondent à un utilisateur, un groupe d'utilisateurs ou une application. Aucune vérification d'existence ne sera effectuée sur les entités spécifiées par ce paramètre ; assurez-vous donc d'utiliser les identifiants corrects. Étant donné qu'aucune vérification n'est effectuée, le traitement est beaucoup plus rapide. ### Exemples #### Exemple 1 ```powershell PS C:\> $permission = New-DSEntityPermission -Override Custom -Right Delete -User MyUserA, MyUserB $pamRoot = Get-DSPamFolder -VaultID $pamVaultID -Root Set-DSEntityPermission -EntityID $pamRoot.ID -Permissions $permission ``` Pour les comptes PAM dans le coffre PAM dont l'identifiant est $pamVaultID, le droit de suppression par défaut sera attribué à MyUserA et MyUserB. #### Exemple 2 ```powershell PS C:\> $userIDs = Get-DSUser | Where Name -like *something* | Select -ExpandProperty ID $permission = New-DSEntityPermission -Override CustomInherited -Right Edit -PrincipalId $userIDs Set-DSEntityPermission -EntityID $entryID -Permissions $permission ``` Ajouter 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 #### -Application Identités d'application autorisées à accéder au droit. Peuvent être spécifiées par leur identifiant d'application ou leur identifiant. ```yaml Type: System.String[] DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: WithExistenceCheck Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Override Définit la façon dont les permissions sont déterminées. Cinq modes sont disponibles : Custom : Spécifier une valeur personnalisée pour la permission. Seuls les utilisateurs, groupes d'utilisateurs et applications spécifiés auront la permission. CustomInherited : Combinaison de Inherited et Custom. Ajoute des utilisateurs, groupes d'utilisateurs et applications supplémentaires aux éléments hérités. Everyone : Identique à Allowed dans l'interface. Tout le monde se voit accorder la permission. Inherited : Hérite la permission du parent. Never : Identique à Disallowed dans l'interface. Personne, à l'exception des administrateurs, ne se voit accorder la permission. ```yaml Type: Devolutions.RemoteDesktopManager.SecurityRoleOverride DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 0 IsRequired: true ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -PrincipalId Identifiants des utilisateurs, rôles et applications sans vérification de leur existence. Le traitement avec ce paramètre est beaucoup plus rapide qu'avec les paramètres User, Role ou Application. ```yaml Type: System.Guid[] DefaultValue: '' SupportsWildcards: false Aliases: - ID ParameterSets: - Name: WithoutExistenceCheck Position: 2 IsRequired: true ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Right Définit quel droit est modifié. ```yaml Type: Devolutions.RemoteDesktopManager.SecurityRoleRight DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: (All) Position: 1 IsRequired: true ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -Role Rôles (groupes d'utilisateurs) autorisés à accéder au droit. Peuvent être spécifiés par leur nom ou leur identifiant. ```yaml Type: System.String[] DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: WithExistenceCheck Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### -User Utilisateurs autorisés à accéder au droit. Peuvent être spécifiés par leur nom ou leur identifiant. ```yaml Type: System.String[] DefaultValue: '' SupportsWildcards: false Aliases: [] ParameterSets: - Name: WithExistenceCheck Position: Named IsRequired: false ValueFromPipeline: false ValueFromPipelineByPropertyName: false ValueFromRemainingArguments: false DontShow: false AcceptedValues: [] HelpMessage: '' ``` #### CommonParameters 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, consultez [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Notes Pour plus d'informations, saisissez « Get-Help New-DSEntityPermission -detailed ». Pour des informations techniques, saisissez « Get-Help New-DSEntityPermission -full ». --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.devolutions.net/powershell/fr/powershell-commands/new-dsentitypermission.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.