> 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/fr/commandes-powershell/new-psurole.md). # New-PSURole New-PSURole définit un nouveau rôle d'autorisation dans PowerShell Universal, attribué de façon statique ou dynamique au moyen d'un bloc de script de stratégie. ## SYNOPSIS Définit un nouveau rôle dans PowerShell Universal. ## SYNTAXE ### Stratégie (par défaut) ``` New-PSURole -Name [-Description ] [-Policy ] [-Disabled] [-DefaultRoute ] [-Roles ] [-Permissions ] [-Priority ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Revendication ``` New-PSURole -Name [-Description ] -ClaimType -ClaimValue [-Disabled] [-DefaultRoute ] [-Roles ] [-Permissions ] [-Priority ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPTION Définit un nouveau rôle dans PowerShell Universal. Les rôles servent à définir l'autorisation au sein de la plateforme PowerShell Universal. Les rôles peuvent être attribués de façon statique à une identité ou être attribués par le bloc de script -Policy. Le bloc de script de stratégie reçoit un paramètre $User qui contient les informations d'identité et les revendications qu'une identité a obtenues lors de l'authentification. Les blocs de script de stratégie doivent retourner soit $true, soit $false afin de déterminer si cette identité particulière devrait se voir attribuer le rôle. Les configurations des rôles sont stockées dans .universal/roles.ps1 Vous pouvez aussi utiliser cette applet de commande pour créer des rôles au moyen de l'API REST. ## EXEMPLES ### Exemple 1 ``` New-PSURole -Name 'Developers' -Policy { param($User) $User.Claims.HasClaim('myGroup') } ``` Crée un nouveau rôle avec une stratégie définie qui vérifie si la revendication de l'utilisateur contient la revendication « myGroup ». ## PARAMÈTRES ### -AppToken Le AppToken utilisé pour appeler l'API de gestion de PowerShell Universal. Vous pouvez aussi appeler Connect-PSUServer avant d'appeler cette applet de commande pour définir le AppToken pour toute la session. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName Spécifie le nom d'ordinateur ou l'URL qui devrait être appelé lors de l'accès à l'API de gestion de PowerShell Universal. Vous pouvez aussi utiliser Connect-PSUServer avant d'appeler cette applet de commande pour définir le nom d'ordinateur pour toute la session. ```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 description de ce rôle à afficher dans la console d'administration. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name Le nom de ce rôle. Le nom est utilisé à la fois pour l'affichage et pour l'attribution de ressources comme les API et les tableaux de bord. ```yaml Type: String Parameter Sets: (All) Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Policy Le bloc de script de stratégie à exécuter pour déterminer s'il faut attribuer ce rôle. ```yaml Type: ScriptBlock Parameter Sets: Policy Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -UseDefaultCredentials Utiliser les identifiants par défaut lors de la connexion à l'API de gestion ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Integrated Exécute la commande en interne plutôt qu'en utilisant l'API de gestion. Fonctionne uniquement lors de l'exécution d'un script à partir 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 Le type de revendication à mapper pour ce rôle. Voir le mappage des rôles aux revendications dans notre documentation. ```yaml Type: String Parameter Sets: Claim Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ClaimValue La valeur de revendication à mapper pour ce rôle. Voir le mappage des rôles aux revendications dans notre documentation. ```yaml Type: String Parameter Sets: Claim Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Disabled Si le rôle est désactivé. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -DefaultRoute L'URL par défaut vers laquelle rediriger les utilisateurs de ce rôle. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Roles Les rôles enfants qui devraient être attribués aux utilisateurs auxquels ce rôle est attribué. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Credential Identifiants pour se connecter à l'API de gestion 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 Permissions attribuées aux utilisateurs auxquels ce rôle est accordé. ```yaml Type: String[] Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -TrustCertificate Si l'applet de commande devrait ignorer les problèmes de certificat. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Priority La priorité de ce rôle. Détermine quelle redirection utiliser lorsque plusieurs rôles sont attribués à un utilisateur. ```yaml Type: Int32 Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Cookies Réutilise et conserve les témoins d'authentification pour la session PowerShell en cours. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### CommonParameters Cette applet de commande prend en charge les paramètres communs : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable et -ProgressAction. Pour plus d'informations, consultez [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216). ## ENTRÉES ### Aucune ## SORTIES ### System.Object ## NOTES ## LIENS CONNEXES --- # 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/fr/commandes-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.