> 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/es/powershell-commands/new-dsentitypermission.md). # New-DSEntityPermission ### Sinopsis Crear un objeto de permiso para una entidad ### Sintaxis #### WithExistenceCheck (predeterminado) ``` New-DSEntityPermission [-Override] [-Right] [-User ] [-Role ] [-Application ] [] ``` #### WithoutExistenceCheck ``` New-DSEntityPermission [-Override] [-Right] [-PrincipalId] [] ``` ### Descripción Crear un objeto de permiso para una entidad. Los parámetros User, Role y Application pueden especificarse mediante su ID o su nombre. En el caso de una aplicación, el nombre hace referencia al Application ID, ya que el nombre mostrado no es necesariamente único. Se confirmará la existencia de todas las entidades, con un mensaje de advertencia para aquellas que no se encuentren. El parámetro ID acepta únicamente ID, ya sea que correspondan a un usuario, a un grupo de usuarios o a una aplicación. No se realizará ninguna verificación de existencia sobre las entidades especificadas mediante este parámetro, así que asegúrese de utilizar los ID correctos. Como no se realiza ninguna verificación, es mucho más rápido. ### Ejemplos #### Ejemplo 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 ``` Para las cuentas PAM de la bóveda PAM cuyo ID es $pamVaultID, se asignará el derecho predeterminado de eliminación a MyUserA y MyUserB. #### Ejemplo 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 ``` Añadir los usuarios cuyo nombre contenga 'something' a los usuarios heredados que pueden editar la entrada cuyo ID está almacenado en $entryID ### Parámetros #### -Application Identidades de aplicación autorizadas a acceder al derecho. Pueden especificarse mediante su Application ID o su 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 Define cómo se determinan los permisos. Hay cinco modos disponibles: Custom: especificar un valor personalizado para el permiso. Solo los usuarios, grupos de usuarios y aplicaciones especificados tendrán el permiso. CustomInherited: combinación de Inherited y Custom. Añade usuarios, grupos de usuarios y aplicaciones adicionales a los heredados. Everyone: igual que Allowed en la interfaz de usuario. El permiso se concede a todo el mundo. Inherited: hereda el permiso del elemento principal. Never: igual que Disallowed en la interfaz de usuario. El permiso no se concede a nadie salvo a los administradores ```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 de usuarios, roles y aplicaciones sin verificar su existencia. Es mucho más rápido proceder con este parámetro que con los parámetros User, Role o 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 Define qué derecho se modifica ```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 Roles (grupos de usuarios) autorizados a acceder al derecho. Pueden especificarse mediante su nombre o su 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 Usuarios autorizados a acceder al derecho. Pueden especificarse mediante su nombre o su 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 Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216). ### Notas Para más información, escriba "Get-Help New-DSEntityPermission -detailed". Para obtener información técnica, escriba "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/es/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.