> 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 New-DSEntityPermission crée un objet de permission pour une entité dans Devolutions Server, en spécifiant les utilisateurs, les rôles ou les applications et leurs droits. ### Résumé Créer un objet de permission pour une entité ### Syntaxe #### WithExistenceCheck (par défaut) ``` 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 ID ou par leur nom. Pour une application, le nom fait référence à l'Application ID, 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 ne sont pas trouvées. Le paramètre ID accepte uniquement les ID, 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, donc assurez-vous d'utiliser les bons ID. Comme aucune vérification n'a lieu, c'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'ID est $pamVaultID, le droit par défaut de supprimer sera assigné à 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 qui peuvent modifier l'entrée dont l'ID est stocké dans $entryID ### Paramètres #### -Application Identités d’application autorisées à accéder au droit. Peuvent être spécifiées par leur application ID ou par leur ID. ```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 comment 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 à ceux hérités. Everyone : Identique à Allowed dans l'interface. La permission est accordée à tout le monde. Inherited : Hériter la permission du parent Never : Identique à Disallowed dans l'interface. La permission n'est accordée à personne, sauf aux administrateurs ```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 ID des utilisateurs, rôles et applications sans vérifier leur existence. Il est beaucoup plus rapide de procéder avec ce paramètre 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 par leur ID. ```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 par leur ID. ```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'information, voir [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Notes Pour plus d'information, tapez "Get-Help New-DSEntityPermission -detailed". Pour de l'information technique, tapez "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, and the optional `goal` query parameter: ``` GET https://docs.devolutions.net/powershell/fr/powershell-commands/new-dsentitypermission.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.