> 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-universal/es/comandos-de-powershell/new-psurole.md). # New-PSURole ## SINOPSIS Define un nuevo rol dentro de PowerShell Universal. ## SINTAXIS ### Policy (predeterminado) ``` New-PSURole -Name [-Description ] [-Policy ] [-Disabled] [-DefaultRoute ] [-Roles ] [-Permissions ] [-Priority ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Claim ``` New-PSURole -Name [-Description ] -ClaimType -ClaimValue [-Disabled] [-DefaultRoute ] [-Roles ] [-Permissions ] [-Priority ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPCIÓN Define un nuevo rol dentro de PowerShell Universal. Los roles se utilizan para definir la autorización dentro de la plataforma PowerShell Universal. Los roles pueden asignarse estáticamente a una identidad o pueden asignarse mediante el bloque de script -Policy. El bloque de script de política recibe un parámetro $User que contiene la información de identidad y las reclamaciones que se han concedido a una identidad durante la autenticación. Los bloques de script de política deben devolver $true o $false para determinar si a esta identidad concreta se le debe proporcionar el rol. Las configuraciones de roles se almacenan en .universal/roles.ps1 También puede usar este cmdlet para crear roles a través de la API REST. ## EJEMPLOS ### Ejemplo 1 ``` New-PSURole -Name 'Developers' -Policy { param($User) $User.Claims.HasClaim('myGroup') } ``` Crea un nuevo rol con una política definida que comprueba si la reclamación del usuario contiene la reclamación 'myGroup'. ## PARÁMETROS ### -AppToken El AppToken que se utiliza para llamar a la API de gestión de PowerShell Universal. También puede llamar a Connect-PSUServer antes de llamar a este cmdlet para establecer el AppToken para toda la sesión. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Especifica el nombre del ordenador o la URL a la que se debe llamar al acceder a la API de gestión de PowerShell Universal. También puede usar Connect-PSUServer antes de llamar a este cmdlet para establecer el nombre del ordenador para toda la sesión. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Description La descripción de este rol que se mostrará en la Consola de administración. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name El nombre de este rol. El nombre se utiliza tanto para la visualización como para asignar recursos como API y dashboards. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Policy El bloque de script de política que se ejecutará al determinar si se debe asignar este rol. ```yaml Type: ScriptBlock Parameter Sets: Policy Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Usar credenciales predeterminadas al conectarse a la API de gestión ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Ejecuta el comando internamente en lugar de usar la API de gestión. Solo funciona al ejecutar el script desde dentro de PowerShell Universal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ClaimType El tipo de reclamación que se asignará a este rol. Consulte la asignación de rol a reclamación en nuestra documentación. ```yaml Type: String Parameter Sets: Claim Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ClaimValue El valor de reclamación que se asignará a este rol. Consulte la asignación de rol a reclamación en nuestra documentación. ```yaml Type: String Parameter Sets: Claim Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Disabled Si el rol está deshabilitado. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DefaultRoute La URL predeterminada a la que se reenviarán los usuarios de este rol. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Roles Roles secundarios que deben asignarse a los usuarios a los que se asigna este rol. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Credenciales para iniciar sesión en la API de gestión de PowerShell Universal. ```yaml Type: PSCredential Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Permissions Permisos asignados a los usuarios a los que se concede este rol. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Si el cmdlet debe ignorar los problemas de certificado. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Priority La prioridad de este rol. Determina qué redirección utilizar cuando se asignan varios roles a un usuario. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Reutiliza y conserva las cookies de autenticación para la sesión actual de PowerShell. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para más información, consulte [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## ENTRADAS ### Ninguna ## SALIDAS ### System.Object ## NOTAS ## ENLACES RELACIONADOS --- # 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-universal/es/comandos-de-powershell/new-psurole.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.