> 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/get-psurole.md). # Get-PSURole Get-PSURole récupère les rôles définis dans PowerShell Universal qui précisent quelles actions les identités sont autorisées à effectuer. ## SYNOPSIS Retourne les rôles définis dans PSU. ## SYNTAXE ### All (Par défaut) ``` Get-PSURole [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Name ``` Get-PSURole [[-Name] ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Id ``` Get-PSURole [[-Id] ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPTION Retourne les rôles définis dans PSU. Les rôles précisent ce que les identités peuvent faire dans PSU. ## EXEMPLES ### Exemple 1 ``` PS C:\> Get-UARole ``` Retourne tous les rôles définis dans PSU. ### Exemple 2 ``` PS C:\> Get-UARole -Name 'Administrator' ``` Retourne le rôle Administrator. ## PARAMÈTRES ### -AppToken Un jeton d'appli pour accéder à l'API PSU. ```yaml Type: String Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -ComputerName L'adresse HTTP du serveur de l'API REST de PSU. ```yaml Type: String Parameter Sets: (All) Aliases: Uri Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Id L'ID du rôle à retourner. ```yaml Type: Int64 Parameter Sets: Id Aliases: Required: False Position: 0 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 du script depuis PowerShell Universal. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Name Le nom du rôle à retourner. ```yaml Type: String Parameter Sets: Name Aliases: Required: False Position: 0 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 ``` ### -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 ``` ### -TrustCertificate Indique si l'applet de commande doit 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 ``` ### -Cookies Réutilise et conserve les témoins d'authentification pour la session PowerShell actuelle. ```yaml Type: SwitchParameter Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### Paramètres communs 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/get-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.