> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/implementacao/infrastructure/avd-templates.md).

# Modelos AVD

## Visão geral

Usando este recurso, você pode definir um conjunto (também conhecido como template) de aplicações. Esse conjunto de aplicações pode então ser aplicado a um computador de forma sem interface / não assistida usando o RealmJoin Client.

Isto destina-se à criação de imagens douradas para hosts em pool multissessão do Azure Virtual Desktop.

{% hint style="info" %}
Criar e gerenciar templates do Azure Virtual Desktop (AVD) é uma tarefa complexa que requer conhecimento especializado, planejamento minucioso e configuração precisa. Embora ofereçamos suporte total a todos os tópicos relacionados ao RealmJoin descritos nesta página, nossa capacidade de ajudar com tópicos mais amplos de templating do AVD é limitada. Isso inclui — mas não se limita a — orientação geral sobre criação, personalização, implantação e solução de problemas de templates do AVD.
{% endhint %}

## Permissões

Para ativar o recurso, você deve definir um [função personalizada](/pt/administracao-e-configuracoes/permission/custom-roles.md) e atribuir a função a um grupo ou usuário.

Copie a definição a seguir e certifique-se de alterar o GroupID de acordo.

```json
{
  "Rules": [
    {
      "Name": "Permitir que administradores acessem o recurso de template",
      "Groups": [
        "<ID do grupo de administradores>"
      ],
      "Permissions": [
        "CanReadTemplateTable",
        "CanReadTemplateDetails",
        "CanEditTemplate",
        "CanDeleteTemplate",
        "CanChangeTemplatePackages",
        "CanChangeTemplateTokens"
      ]
    }
  ]
}
```

## Gerenciando templates

### Criando um template

1. Clique no ícone "templates" ou abra a seção Templates digitando a URL: <https://portal.realmjoin.com/templates>

<figure><img src="/files/05509a951a3db4271e1e383b328ee8e43d96558f" alt=""><figcaption><p>Lista de templates</p></figcaption></figure>

2. Selecione a <img src="/files/ec9d610653660bf74e61846a16cca94c5d7accb9" alt="" data-size="line"> ícone (1), insira um nome significativo (2) e clique em "Salvar" (3).

<figure><img src="/files/1ac8458a69e4adc25924c83842cc11d658c5811e" alt=""><figcaption><p>Criar um template</p></figcaption></figure>

### Adicionar Aplicações a um Template

1. Abra o template clicando no seu nome.
2. Para adicionar pacotes ao template, clique no <img src="/files/ec9d610653660bf74e61846a16cca94c5d7accb9" alt="" data-size="line"> ícone.

<figure><img src="/files/16795fd677efed3ed5410aeb380d58f3f5fd109c" alt=""><figcaption><p>Adicionar pacotes a um template - 1</p></figcaption></figure>

3. Procure um pacote e clique no ![](/files/76cd20ccafe80ec593e3f09a9c71842b91e1526c) ícone para adicioná-lo ao seu template. A lista representa todos os pacotes RealmJoin aos quais você assinou em seu ambiente.
4. Quando terminar, clique no **Fechar** botão.

<figure><img src="/files/ec4a0895c5c8dee707e44107fecf7f7e9787e531" alt=""><figcaption><p>Adicionar pacotes a um template - 2</p></figcaption></figure>

{% hint style="info" %}
Os pacotes do Intune não podem ser atribuídos usando templates do AVD.
{% endhint %}

### Remover Aplicações de um Template

1. Abra o template clicando no seu nome.
2. Se você quiser remover aplicações, clique em **Desatribuir**. Se quiser definir argumentos que substituam os definidos no nível do pacote, você pode fazer isso clicando em **Configurações**.

<figure><img src="/files/bd5478ddbea347be7447c1185b2d3fd5465b7313" alt=""><figcaption><p>Remover pacotes de um template</p></figcaption></figure>

### Criar um Token

Para usar o template via RealmJoin Client, você também precisa de um token.

{% hint style="warning" %}
Manuseie o token com cuidado. Se você acha que o token pode ter vazado, revogue-o clicando no **Revogar** botão ao lado do token.
{% endhint %}

1. Para criar um token, clique em **Tokens** separador.
2. Clique no <img src="/files/ec9d610653660bf74e61846a16cca94c5d7accb9" alt="" data-size="line"> ícone (1), insira um nome significativo (2) e clique em **Guardar** (3).

<figure><img src="/files/b2a576067fd8029c725ba979843d6bb66e54825d" alt=""><figcaption><p>Criar um token</p></figcaption></figure>

## Melhores práticas

Siga estas recomendações para manter seus templates AVD estáveis e evitar que pacotes sejam removidos inesperadamente de um template.

### Use uma assinatura de pacote dedicada por app

Crie sempre uma **assinatura de pacote separada** para cada aplicação que você adicionar a um template e renomeie-a para `AVD - [PACKAGENAME]`.

{% hint style="warning" %}
Nunca reutilize uma assinatura de app existente (não AVD) em um template. Os pacotes usados em templates AVD são tratados de forma diferente das implantações regulares, então compartilhar uma assinatura entre ambos pode levar a um comportamento inesperado.
{% endhint %}

### Ative a automação apenas no canal principal

Ative a automação no **principal** canal apenas — nunca no **prévia** canal.

{% hint style="danger" %}
Não há opções de prévia para AVD, e alternar uma assinatura de **prévia** para **principal** cria uma **nova** assinatura. Isso exclui o pacote existente e o recria, o que remove o pacote de qualquer template do qual ele fazia parte.

Atualizar de **principal** para **principal** não cria uma nova assinatura, então o pacote permanece no template.
{% endhint %}

## Usando um Template

### Provisionamento AVD / sem interface

Reúna o ID do template e o token que você deseja usar para a implantação.

<figure><img src="/files/dc45a2eee5ce303f2d4c99edc046089b2aaf1105" alt=""><figcaption><p>Encontrar ID do template e token</p></figcaption></figure>

Execute o seguinte comando de dentro do seu sistema/VM que você deseja preparar como imagem dourada:

1. Baixe o RealmJoin: `Invoke-WebRequest -Uri "https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe" -OutFile "C:\temp\RealmJoin.exe"`
2. Instale o RealmJoin: `Start-Process -FilePath "C:\temp\RealmJoin.exe" -ArgumentList "-install" -Wait`
3. Execute a implantação sem interface. Certifique-se de inserir seu ID de template e token individuais: `Start-Process -FilePath "C:\Program Files\RealmJoin\RealmJoinService.exe" -ArgumentList " -avdprovision <Template ID> <Template Token>"`

### Logs e rastreamentos

Tanto na instalação do RealmJoin quanto na implantação sem interface, você pode adicionar um argumento adicional `-trace` para ampliar o registro. Para verificar o status/logs durante a implantação sem interface, abra e atualize periodicamente o realmjoin.log, que pode ser encontrado em `C:\Windows\Logs\`


---

# 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.realmjoin.com/pt/implementacao/infrastructure/avd-templates.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.