# AVD テンプレート

## 概要

この機能を使用すると、アプリケーションのセット（テンプレートとも呼ばれます）を定義できます。このアプリケーションセットは、RealmJoin Client を使用して、ヘッドレス／無人の方法でコンピューターに適用できます。

これは、Azure Virtual Desktop のマルチセッションのプールホスト向けのゴールデンイメージを作成することを目的としています。

{% hint style="info" %}
Azure Virtual Desktop (AVD) テンプレートの作成と管理は、専門知識、綿密な計画、正確な構成を必要とする複雑な作業です。このページで説明されている RealmJoin 関連のトピックはすべて完全にサポートしていますが、より広範な AVD テンプレート作成のトピックについては、支援できる範囲に限りがあります。これには、AVD テンプレートの作成、カスタマイズ、展開、およびトラブルシューティングに関する一般的なガイダンスが含まれますが、これに限定されるものではありません。
{% endhint %}

## 権限

この機能を有効にするには、 [カスタム ロール](https://docs.realmjoin.com/ja/realmjoin-no/permission/custom-roles) を定義し、そのロールをグループまたはユーザーに割り当てる必要があります。

次の定義をコピーし、GroupID を適切に変更してください。

```json
{
  "Rules": [
    {
      "Name": "管理者がテンプレート機能にアクセスできるようにする",
      "Groups": [
        "<管理グループのグループ ID>"
      ],
      "Permissions": [
        "CanReadTemplateTable",
        "CanReadTemplateDetails",
        "CanEditTemplate",
        "CanDeleteTemplate",
        "CanChangeTemplatePackages",
        "CanChangeTemplateTokens"
      ]
    }
  ]
}
```

## テンプレートの管理

### テンプレートの作成

1. "templates" アイコンをクリックするか、次の URL を入力して Templates セクションを開きます: <https://portal.realmjoin.com/templates>

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FxXuRmmsPeWTAz5UJG5Mm%2Fimage.png?alt=media&#x26;token=8b474fea-95ba-4b94-9b29-596d2d61192b" alt=""><figcaption><p>テンプレート一覧</p></figcaption></figure>

2. を選択してください <img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FHmyI4SpDdXwH2CwGu7yt%2Fimage.png?alt=media&#x26;token=4778665b-3ac9-4752-96ed-53ece4633280" alt="" data-size="line"> アイコン (1) をクリックし、意味のある名前 (2) を入力して、"Save" (3) をクリックします。&#x20;

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FuQUkRsaiVgISctj4Zb8S%2Fimage-1.png?alt=media&#x26;token=5cc20b3b-0f47-4d1b-bb7e-fb693e4f6498" alt=""><figcaption><p>テンプレートの作成</p></figcaption></figure>

### テンプレートにアプリケーションを追加する

1. 名前をクリックしてテンプレートを開きます。
2. テンプレートにパッケージを追加するには、 <img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FHvBdWctDPfuVmTP12ZRK%2Fimage.png?alt=media&#x26;token=d520017f-4e10-4236-87ca-809154e79403" alt="" data-size="line"> アイコンをクリックします。&#x20;

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fe2WNicG057XlC2Zjw2TX%2Fimage-2.png?alt=media&#x26;token=dc4c9bee-a032-4c7f-831b-86f6506737d6" alt=""><figcaption><p>テンプレートにパッケージを追加する - 1</p></figcaption></figure>

3. パッケージを検索し、 ![](https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBdRIwooSznEKFEutEiNJ%2Fimage.png?alt=media\&token=67b30b07-0391-4252-a3c9-108e425452f8) アイコンを押してテンプレートに追加します。この一覧には、あなたの環境で購読しているすべての RealmJoin パッケージが表示されます。
4. 完了したら、 **Close** ボタンをクリックします。

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FcaiKnyWcTB03y2fsTYfw%2Fimage-3.png?alt=media&#x26;token=cb1c1ddd-a678-4f92-be44-49d46fe95db2" alt=""><figcaption><p>テンプレートにパッケージを追加する - 2</p></figcaption></figure>

{% hint style="info" %}
Intune パッケージは AVD テンプレートを使用して割り当てることはできません。
{% endhint %}

### テンプレートからアプリケーションを削除する

1. 名前をクリックしてテンプレートを開きます。
2. アプリケーションを削除したい場合は、 **Unassign**をクリックします。パッケージ レベルで設定された内容を上書きする引数を定義したい場合は、 **Settings**.&#x20;

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FBIajMVAI5JNGAdsznMZ9%2Fimage-4.png?alt=media&#x26;token=29c19b9e-0b05-4d71-be2c-70e35750ab25" alt=""><figcaption><p>テンプレートからパッケージを削除する</p></figcaption></figure>

### トークンの作成

RealmJoin Client を介してテンプレートを使用するには、トークンも必要です。&#x20;

{% hint style="warning" %}
トークンは慎重に扱ってください。トークンが漏えいした可能性があると思われる場合は、次のボタンを押して無効化してください。 **Revoke** トークンの横にあるボタン。&#x20;
{% endhint %}

1. トークンを作成するには、 **Tokens** タブを開きます。
2. アイコンをクリックし、(1) 意味のある名前を入力して (2)、 <img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FHmyI4SpDdXwH2CwGu7yt%2Fimage.png?alt=media&#x26;token=4778665b-3ac9-4752-96ed-53ece4633280" alt="" data-size="line"> アイコン (1) をクリックし、意味のある名前 (2) を入力して、 **保存** (3).&#x20;

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FgPVq1LS6wTVvp5iI2iJa%2Fimage-6.png?alt=media&#x26;token=39640bf1-7dfb-4433-aa00-6b0e6e1892dd" alt=""><figcaption><p>トークンの作成</p></figcaption></figure>

## テンプレートの使用&#x20;

### AVD / ヘッドレス プロビジョニング

展開に使用するテンプレート ID とトークンを用意してください。

<figure><img src="https://3438325150-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2FVW0SRqoDYrJkVNXMF8Co%2Fimage.png?alt=media&#x26;token=56d936a7-b26e-44f0-91a0-7ffb7556ffc9" alt=""><figcaption><p>テンプレート ID とトークンを見つける</p></figcaption></figure>

ゴールデン イメージとして準備したいシステム／VM 内から、次のコマンドを実行します:

1. RealmJoin をダウンロード: `Invoke-WebRequest -Uri "https://gkrealmjoin.s3.amazonaws.com/win-release/RealmJoin.exe" -OutFile "C:\temp\RealmJoin.exe"`
2. RealmJoin をインストール: `Start-Process -FilePath "C:\temp\RealmJoin.exe" -ArgumentList "-install" -Wait`
3. ヘッドレス展開を実行します。個別のテンプレート ID とトークンを必ず入力してください: `Start-Process -FilePath "C:\Program Files\RealmJoin\RealmJoinService.exe" -ArgumentList " -avdprovision <Template ID> <Template Token>"`

### ログとトレース

RealmJoin のインストールとヘッドレス展開の両方で、追加の引数 `-trace` を指定してログを詳細化できます。ヘッドレス展開中の状態／ログを確認するには、次の場所にある realmjoin.log を開いて定期的に更新してください: `C:\Windows\Logs\`