> 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/grant-psuapptoken.md).

# Grant-PSUAppToken

## SINOPSIS

Concede un nuevo token de aplicación.

## SINTAXIS

### CurrentUser (Predeterminado)

```
Grant-PSUAppToken [-Expiry <DateTime>] [-Description <String>] [-ComputerName <String>] [-AppToken <String>]
 [-Credential <PSCredential>] [-UseDefaultCredentials] [-Integrated] [-TrustCertificate] [-Cookies]
 [<CommonParameters>]
```

### Grant

```
Grant-PSUAppToken -Identity <Identity> [-Expiry <DateTime>] [-Role <String[]>] [-Description <String>]
 [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]
```

### GrantCustom

```
Grant-PSUAppToken -IdentityName <String> [-Expiry <DateTime>] [-Role <String[]>] [-Description <String>]
 [-ComputerName <String>] [-AppToken <String>] [-Credential <PSCredential>] [-UseDefaultCredentials]
 [-Integrated] [-TrustCertificate] [-Cookies] [<CommonParameters>]
```

## DESCRIPCIÓN

Concede un nuevo token de aplicación. Los tokens de aplicación se pueden utilizar para llamar a la API de gestión de PowerShell Universal y a otras API REST personalizadas.

## EJEMPLOS

### Ejemplo 1

```powershell
PS C:\> Grant-PSUAppToken -IdentityName 'MyIdentity' -Expiry (Get-Date).AddDays(30) -Role 'Reader'
```

Concede un nuevo token de aplicación al usuario MyIdentity que caduca en 30 días y proporciona acceso de lectura (Reader).

### Ejemplo 2

```powershell
PS C:\> Grant-PSUAppToken -IdentityName 'MyIdentity' -Expiry (Get-Date).AddDays(30) -Role 'Reader' -SigningKey 'MySigningKey'
```

Genera un nuevo token de aplicación utilizando la clave de firma especificada para el usuario MyIdentity.

## 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 ejecutar 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 que se debe llamar al acceder a la API de gestión de PowerShell Universal. También puede usar Connect-PSUServer antes de ejecutar 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
```

### -Expiry

La fecha de caducidad del token de aplicación.

```yaml
Type: DateTime
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Identity

El objeto Identity para el que se crea el token de aplicación. Utilice Get-PSUIdentity para recuperar las identidades.

```yaml
Type: Identity
Parameter Sets: Grant
Aliases:

Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -IdentityName

El nombre de la identidad que se va a generar o conceder para el token de aplicación.

```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

El rol que se concede a la identidad del token de aplicación.

```yaml
Type: String[]
Parameter Sets: Grant, GrantCustom
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 utilizar la API de gestión. Solo funciona cuando se ejecuta el script desde 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

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
```

### -TrustCertificate

Indica si el cmdlet debe ignorar los problemas de certificados.

```yaml
Type: SwitchParameter
Parameter Sets: (All)
Aliases:

Required: False
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -Description

Proporciona la descripción del token de aplicación.

```yaml
Type: String
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
```

### Parámetros comunes

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -Verbose, -WarningAction, -WarningVariable y -ProgressAction. Para obtener más información, consulte [about\_CommonParameters](http://go.microsoft.com/fwlink/?LinkID=113216).

## ENTRADAS

### Ninguno

## SALIDAS

### System.Object

## NOTAS

## ENLACES RELACIONADOS

[Get-PSUIdentity](/powershell-universal/es/comandos-de-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/es/comandos-de-powershell/grant-psuapptoken.md?ask=<question>&goal=<endgoal>
```

`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.
