> 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/grant-psuapptoken.md). # Grant-PSUAppToken Grant-PSUAppToken émet un nouveau jeton d'appli dans PowerShell Universal pour appeler de façon sécurisée l'API de gestion ou des API REST personnalisées. ## SYNOPSIS Accorde un nouveau jeton d'appli. ## SYNTAXE ### CurrentUser (Défaut) ``` Grant-PSUAppToken [-Expiry ] [-Description ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### Grant ``` Grant-PSUAppToken -Identity [-Expiry ] [-Role ] [-Description ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ### GrantCustom ``` Grant-PSUAppToken -IdentityName [-Expiry ] [-Role ] [-Description ] [-ComputerName ] [-AppToken ] [-Credential ] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies] [] ``` ## DESCRIPTION Accorde un nouveau jeton d'appli. Les jetons d'appli peuvent être utilisés pour appeler l'API de gestion de PowerShell Universal et d'autres API REST personnalisées. ## EXEMPLES ### Exemple 1 ```powershell PS C:\> Grant-PSUAppToken -IdentityName 'MyIdentity' -Expiry (Get-Date).AddDays(30) -Role 'Reader' ``` Accorde un nouveau jeton d'appli à l'utilisateur MyIdentity qui expire dans 30 jours et fournit un accès Reader. ### Exemple 2 ```powershell PS C:\> Grant-PSUAppToken -IdentityName 'MyIdentity' -Expiry (Get-Date).AddDays(30) -Role 'Reader' -SigningKey 'MySigningKey' ``` Génère un nouveau jeton d'appli en utilisant la clé de signature spécifiée pour l'utilisateur MyIdentity. ## 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 ``` ### -Expiry La date d'expiration du jeton d'appli. ```yaml Type: DateTime Parameter Sets: (All) Aliases: Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Identity L'objet Identity pour lequel créer le jeton d'appli. Utilisez Get-PSUIdentity pour récupérer les identités. ```yaml Type: Identity Parameter Sets: Grant Aliases: Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -IdentityName Le nom de l'identité à générer ou à accorder pour le jeton d'appli. ```yaml Type: String Parameter Sets: GrantCustom Aliases: UserName, Application Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` ### -Role Le rôle à accorder à l'identité du jeton d'appli. ```yaml Type: String[] Parameter Sets: Grant, GrantCustom 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 à l'interne plutôt que d'utiliser l'API de gestion. Fonctionne uniquement lors de l'exécution d'un 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 ``` ### -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 ``` ### -Description Fournit la description du jeton d'appli. ```yaml Type: String 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 ``` ### 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 [Get-PSUIdentity](/powershell-universal/fr/commandes-powershell/get-psuidentity.md) --- # 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/grant-psuapptoken.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.