構成設定のリファレンス

  • [アーティクル]

この記事では、FSLogix に適用されるさまざまなレジストリ設定の概要について説明します。これらの設定には以下が含まれますが、これらに限定されません。

  • アプリケーション サービス
  • プロファイル コンテナー
  • ODFC コンテナー
  • Cloud Cache
  • ログ機能

既定の設定

FSLogix をインストールした後、インストーラーによってレジストリ キーと値の基本セットが作成され、構成設定を追加するためのフレームワークが提供されます。 FSLogix では、インストールの一部として任意の構成設定の値の名前は作成されません。 このページに表示されている '既定値' を持つ構成設定は、FSLogix で自動的に既定値が使用されるため、作成または構成する必要はありません。

たとえば、RoamIdentity 設定の既定値は 0 です。 FSLogix は既定の動作として ID をローミングせず、レジストリ値の名前と値を作成または追加するために管理者を必要としません。 設定の既定の動作を変更する場合にのみ、管理者はレジストリ値の名前と値を作成または追加します。

基本レジストリ キーと値の名前

  • [HKEY_LOCAL_MACHINE\SOFTWARE\FSLogix]
    • \Apps
      • "InstallPath"="C:\Program Files\FSLogix\Apps\"
      • "InstallVersion"="version_number"
    • \Logging
    • \Profiles
    • \SystemInfo
    • \Telemetry
    • \UserModeDll
  • [HKEY_LOCAL_MACHINE\SOFTWARE\Policies\FSLogix]
    • \ODFC

カスタム環境変数

一部の FSLogix 設定では、環境変数を受け入れます。 これらの設定は、ユーザーのサインイン時に使用できるカスタム環境変数と変数の一覧を受け入れます。

FSLogix カスタム変数:

変数 説明
%username% サインインしているユーザーの SAMAcountName。
%userdomain% ユーザーのアカウントが存在する NETBIOS ドメイン名。
%sid% セキュリティ ID
%osmajor% 次に示すように、オペレーティング システムのメジャー バージョン: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\CurrentMajorVersionNumber
%osminor% 次に示すように、オペレーティング システムのマイナー バージョン: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\CurrentMinorVersionNumber
%osbuild% 次に示すように、オペレーティング システムのビルド バージョン: HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\CurrentBuildNumber
%osservicepack% レガシから Windows サービス パックになり、使用されなくなりました。
%profileversion% Windows バージョンに基づくプロファイル のバージョン。
%clientname% ホストへの接続を開始するクライアントの COMPUTERNAME。

App Services の設定

次の設定が FSLogix に適用されます。これらは、プロファイルまたは ODFC コンテナー、Cloud Cache に固有のものではありません。

CleanupInvalidSessions

レジストリ ハイブ: HKEY_LOCAL_MACHINE

レジストリ パス: SOFTWARE\FSLogix\Apps

値の名前: CleanupInvalidSessions

値の種類: DWORD

有効な値: 1

無効な値: 0 (既定値)

ユーザーのセッションが突然終了した場合、ユーザーのプロファイル用にマウントされた VHD(x) が正しくデタッチされず、ユーザーの次のサインインで VHD(x) コンテナーが正常にアタッチされない場合があります。 この設定を有効にすると、FSLogix はこれらの無効なセッションをクリーンアップし、サインインの成功を許可しようとします。 この設定は、プロファイル コンテナーと ODFC コンテナーの両方に影響します。

RoamRecycleBin

レジストリ ハイブ: HKEY_LOCAL_MACHINE

レジストリ パス: SOFTWARE\FSLogix\Apps

値の名前: RoamRecycleBin

値の種類: DWORD

有効な値: 1 (デフォルト)

無効な値: 0

この設定を有効にすると、ユーザーの特定のごみ箱用のリダイレクトが VHD(x) コンテナーに作成されます。 これにより、削除元のコンピューターに関係なく、ユーザーは項目を復元できます。

VHDCompactDisk

レジストリ ハイブ: HKEY_LOCAL_MACHINE

レジストリ パス: SOFTWARE\FSLogix\Apps

値の名前: VHDCompactDisk

値の種類: DWORD

有効な値: 1 (デフォルト)

無効な値: 0

この設定を有効にすると、サインアウト操作中に VHD ディスクの圧縮が試行され、定義済みのしきい値に応じてユーザーのコンテナーの Size On Disk が自動的に減少するようになります。 詳細については、VHD ディスク圧縮に関するドキュメントを参照してください。

FSLogix 設定 (プロファイル、ODFC、クラウド キャッシュ、ログ記録)

プロファイル コンテナーの設定

プロファイル コンテナーには次の設定が適用され、次の場所に作成されます。

  • レジストリ ハイブ: HKEY_LOCAL_MACHINE
  • レジストリ パス: SOFTWARE\FSLogix\Profiles

AccessNetworkAsComputerObject

型: DWORD

既定値: 0

データの値と使用:

  • 0: 既定値 – ユーザーとしてアタッチします。
  • 1: コンピューターとしてアタッチします - フォルダーには、コンピューター オブジェクトに対するアクセス許可が必要です。

注意事項

ストレージ プロバイダーまたはアーキテクチャが VHD(x) コンテナーの場所に対するユーザー レベルのアクセス許可で機能しない限り、この構成設定を使用しないでください。 この設定により、仮想マシンはストレージ プロバイダー上のすべての VHD(x) ファイルにアクセスでき、潜在的なセキュリティ リスクが発生します。

AttachVHDSDDL

型: REG_SZ

既定値: 該当なし

データの値と使用:

VHD(x) をアタッチするときに使う ACL を表す SDDL 文字列。

CleanOutNotifications

型: DWORD

既定値: 1

データの値と使用:

  • 0: アクションなし。
  • 1: 古い通知エントリを消去します。

この設定では、Windows プッシュ通知プラットフォーム (WPN) と Windows Notification Facility (WFN) によって作成された前のエントリが消去され、一部の条件下ではサインインが遅くなります。

DeleteLocalProfileWhenVHDShouldApply

型: DWORD

既定値: 0

データの値と使用:

  • 0: アクションなし。
  • 1: ローカル プロファイルが存在し、プロファイル コンテナーと一致する場合は削除します。

重要

ユーザーに FSLogix プロファイル コンテナーが必要であると判断されたときに、ローカル プロファイルが既に存在する場合、FSLogix によってローカル プロファイルが完全に削除されます。

DiffDiskParentFolderPath

型: REG_SZ

既定値: %TEMP%

データの値と使用:

ProfileType が差分ディスクを使うように構成されている場合、差分ディスクを作成するパスを指定します。 このパスでは、サインイン プロセス中にユーザーが使用できる FSLogix カスタム変数または環境変数の使用がサポートされています。

Enabled

(必須の設定)

型: DWORD

既定値: 0

データの値と使用:

  • 0: プロファイル コンテナーは無効です。
  • 1: プロファイル コンテナーは有効です。

FlipFlopProfileDirectoryName

型: DWORD

既定値: 0

データの値と使用:

  • 0: SID フォルダーは %sid%_%username% のように作成されます。
  • 1: SID フォルダーは %username%_%sid% のように作成されます。

重要

競合する設定がどのように適用され、優先順位が付いているかを確実に理解しておく必要があります。

  • この設定は、SIDDirNameMatch と SIDDirNamePattern の両方をオーバーライドします
  • NoProfileContainingFolder が有効になっている場合、この設定は効果がありません
  • NoProfileContainingFolder>FlipFlopProfileDirectoryName> (SIDDirNameMatch and SIDDirNamePattern)

GroupPolicyState

型: DWORD

既定値: 1

データの値と使用:

  • 0: グループ ポリシーの状態をローミングしません。サインイン時に同期ポリシー処理を提供します。
  • 1: グループ ポリシーの状態をローミングします。サインイン時に非同期ポリシー処理を提供します。

Note

この設定は、グループ ポリシーを使用して設定することはできません。

IgnoreNonWVD

型: DWORD

既定値: 0

データの値と使用:

  • 0: FSLogix は任意のセッションに対して有効です。
  • 1: FSLogix は Azure Virtual Desktop (AVD) セッションでのみ有効です。

Note

Windows Virtual Desktop (WVD) は Azure Virtual Desktop (AVD) と呼ばれるようになりましたが、設定の名前にはレガシ名が使用されます。

InstallAppxPackages

型: DWORD

既定値: 1

データの値と使用:

(1) を有効にすると、ユーザーのプロファイルから AppxPackages.xml マニフェスト ファイルが読み取られ、アプリケーションの一覧がインストールまたは再登録されます。 AppxPackages.xml ファイルは %LocalAppData%\FSLogix\AppxPackages.xml にあります。 この設定は、すべての AppX アプリケーションの Windows でのグローバル動作を制御します。 これにより、FSLogix で使用する場合にのみ機能が向上します。

警告

AppxPackages.xml ファイルは、編集または変更されるものではありません。 このファイルを編集すると、予期しない結果が発生し、サインアウトするたびにファイルが上書きされる可能性があります。

IsDynamic

型: DWORD

既定値: 1

データの値と使用:

  • 0: VHD(x) は固定サイズであり、ディスク上のサイズは完全に割り当てられます。
  • 1: VHD(x) は動的であり、必要に応じてディスク上のサイズのみを増やします。

Note

  • この設定と SizeInMBs 設定を組み合わせて使うことで、プロファイル コンテナーのサイズを管理します。 IsDynamic を 1 に設定すると、割り当てられた SizeInMBs に関係なく、プロファイル コンテナーはディスク上の最小領域を使用します。 領域が使用されると、ディスク上のサイズは SizeInMBs で指定されたサイズまで大きくなります。 SizeIn MBs は、ユーザーがディスク上での使用を許可されている最大サイズです。 ユーザーのプロファイル コンテナーが SizeInMBs で指定されている値を超える場合は、ユーザーにエラーが発生します。
  • IsDynmaic を 1 に設定しても、プロファイル コンテナーを SizeInMBs で指定されているサイズより大きくすることはできません。

KeepLocalDir

型: DWORD

既定値: 0

データの値と使用:

  • 0: local_%username% がサインアウト中に削除されます。
  • 1: サインアウト後に、local_%username% フォルダーはシステムに残ります。同じユーザーが再びサインオンした場合、もう一度使われます。

LockedRetryCount

型: DWORD

既定値: 12

データの値と使用:

VHD(x) ファイルがロックされている (別のプロセスまたはコンピューターによって開かれている) ときに試みられる再試行の回数を指定します。

LockedRetryInterval

型: DWORD

既定値: 5

データの値と使用:

再試行の間の待機秒数を指定します (LockedRetryCount をご覧ください)。

NoProfileContainingFolder

型: DWORD

既定値: 0

データの値と使用:

  • 0: 無効
  • 1: プロファイル コンテナーでは、VHD(x) ファイル用のフォルダーを含む SID は使用または作成されません。

この設定は、既にユーザーごとに一意になっている場所がストレージによって提供される場合のためのものです。

重要

競合する設定がどのように適用され、優先順位が付いているかを確実に理解しておく必要があります。

  • この設定は、コンテナー フォルダーに関連するその他の設定をオーバーライドします。
    • SIDDIRNameMatch は、この設定と組み合わせて使用すると効果がありません。
    • SIDDIRNamePattern は、この設定と組み合わせて使用すると効果がありません。
    • FlipFlopProfileDirectoryName は、この設定と組み合わせて使用すると効果がありません。

OutlookCachedMode

型: DWORD

既定値: 1

データの値と使用:

  • 0: FSLogix がキャッシュ モードで何かを実行できないようにします。
  • 1: プロファイル コンテナーがアタッチされている場合にのみ、コンテナーがデタッチされるまで、キャッシュ モードを有効にする Outlook の設定が一時的に設定されます。 この設定により、コンテナーがアタッチされている場合にのみキャッシュ モードが使用されます。

重要

  • この機能が動作するには、Outlook がオンライン モード用に構成されている必要があります。 これにより、FSLogix が無効になった場合、大きな OST ファイルはダウンロードされません。
  • オンライン モード レジストリ エントリ: HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\office\16.0\Outlook\OST\NoOST:DWORD = 2。
  • FSLogix は、現在のユーザーのこの設定をオーバーライドします。

PreventLoginWithFailure

型: DWORD

既定値: 0

データの値と使用:

(1) が有効な場合、既存のプロファイル VHD(x) へのアタッチまたは使用に失敗すると、FSLogix は FRXShell を読み込みます。 サポートへの問い合わせを促す既定のプロンプトであり、ユーザーにはサインアウトするという選択肢しかありません。

PreventLoginWithTempProfile

型: DWORD

既定値: 0

データの値と使用:

(1) が有効な場合、一時プロファイルが作成されたと判断されると、FSLogix は FRXShell を読み込みます。 サポートへの問い合わせを促す既定のプロンプトであり、ユーザーにはサインアウトするという選択肢しかありません。

ProfileDirSDDL

型: REG_SZ

既定値: 該当なし

データの値と使用:

プロファイル ディレクトリの作成時に使う ACL を表す SDDL 文字列。

ProfileType

型: DWORD

既定値: 0

データの値と使用:

  • 0: 通常のプロファイル動作。
  • 1: コンピューターは、RW プロファイル インスタンスのみにする必要があります。
  • 2: コンピューターは、RO プロファイル インスタンスのみにする必要があります。
  • 3: コンピューターは、RW ロールの取得を試みる必要があり、できない場合は、RO ロールにフォールバックする必要があります。

重要

  • VHD の使用を同時に試みるすべてのセッションは、一致する ProfileType 設定である必要があります。 VHD に同時にアクセスしない場合は、ProfileType を 0 にする必要があります。
  • OneDrive は、どのような状況でも、同じプロファイルを用いた複数のコンカレント接続をサポートしていません。 詳細については、「Use the sync app on virtual desktops」をご覧ください。

ReAttachRetryCount

型: DWORD

既定値: 60

データの値と使用:

VHD(x) コンテナーが予期せず切断された場合に、システムがその再アタッチを試みる回数を指定します。

ReAttachIntervalSeconds

型: DWORD

既定値: 10

データの値と使用:

VHD(x) コンテナーが予期せず切断された場合に再アタッチを試行するときに、次の再試行まで待機する秒数を指定します。

RebootOnUserLogoff

型: DWORD

既定値: 0

データの値と使用:

  • 0: 無効
  • 1: ユーザーがサインアウトしたら再起動します。
  • 2: FSLogix プロファイル ユーザーがサインアウトしたときに再起動します。

RedirectType

型: DWORD

既定値: 2

データの値と使用:

  • 1: レガシ リダイレクトを使用します。
  • 2: FSLogix の高度なリダイレクトを使用します。

注意事項

Microsoft サポートの指示がない限り、この設定を使わないでください。

RedirXMLSourceFolder

型: REG_SZ

既定値: 該当なし

データの値と使用:

FSLogix が、ユーザーのプロファイルとの間でコピーする redirections.xml ファイルを検索するパス。 このパスでは、サインイン プロセス中にユーザーが使用できる FSLogix カスタム変数または環境変数の使用がサポートされています。 たとえば、C:\Windows\System32 や \\<server-name>\<share-name> のようにします。

Note

パスにファイル名を追加しないでください。 この設定はフォルダー パスのみです。

RemoveOrphanedOSTFilesOnLogoff

型: DWORD

既定値: 0

データの値と使用:

  • 0: 無効
  • 1: サインアウト中に重複する OST ファイルが削除されます。

Note

まれに、1 人のユーザーに対して重複する OST ファイルが作成されます。 この状況は非永続的プロファイルを使用しても使用しなくても発生すると、ドキュメントには記載されています。 プロファイルが標準ファイル システムに格納されている場合、管理者は孤立した OST ファイルまたは古い OST ファイルを削除することで除去できます。 FSLogix を使用する場合、OST ファイルはコンテナー内にあり、表示されません。 期間が長くなると、重複する OST ファイルによって消費される領域が増加する可能性があります。 (1) が有効な場合、FSLogix は、最新の変更日を持つ OST を除き、VHD(x) 内のすべての OST ファイルを削除します。 管理者は、この設定を有効にする前に、OST ファイルの使用と潜在的な影響について理解しておく必要があります。

RoamIdentity

型: DWORD

既定値: 0

データの値と使用:

  • 0: コンテナー内で資格情報とトークンをローミングしないでください。
  • 1: Web アカウント マネージャー (WAM) システムによって作成された資格情報とトークンのレガシ ローミングを有効にします。

一部の ID と認証のシナリオでは、ユーザーがサインインするたびに Microsoft 365 アプリケーションに対する認証が必要になる場合があります。 この設定を有効にすることは、この問題を解決する 1 つの方法です。 Windows サインインが資格情報を Microsoft 365 アプリケーションに渡すことを可能にする真のシングル サインオンに向けて取り組むことをお勧めします。

重要

  • デフォルト設定では、資格情報またはトークンをローミングしないことが推奨設定です。 これは、一部のお客様にとって理想的な構成ではない場合があります。FSLogix v2201 修正プログラム 2 (2.9.8228.50276) と同様に、この設定は、これらの項目をローミングする方法をお客様に提供するために作成されました。
  • Microsoft Intune を使ってデバイスを管理する場合、またはデバイスが Microsoft Entra に参加している場合は、この設定を有効にしないでください。

RoamSearch

型: DWORD

既定値: 0

データの値と使用:

  • 0: 無効
  • 1: シングルユーザー検索を有効にします。
  • 2: マルチユーザー検索を有効にします。

詳細については、「Configure Windows Search database roaming」をご覧ください。

重要

  • 新しいバージョンの Windows 1 では、FSLogix の検索ローミング機能が不要になりました
  • RoamSearch は GPO が適用される前に設定されます。起動時にゴールド イメージが適用される環境で、GPO を使用して RoamSearch を設定することはできません。

1 Windows Server 2019 バージョン 1809 以降、Windows 10 および 11 マルチセッション

SetTempToLocalPath

型: DWORD

既定値: 3

データの値と使用:

  • 0: 無効
  • 1: TEMP と TMP をローカル ドライブにリダイレクトします。
  • 2: INetCache をローカル ドライブにリダイレクトします。
  • 3: TEMP、TMP、INetCache をローカル ドライブにリダイレクトします。

ShutdownOnUserLogoff

型: DWORD

既定値: 0

データの値と使用:

  • 0: 無効
  • 1: ユーザーがサインアウトするとシャットダウンします。
  • 2: FSLogix ユーザーがサインアウトするとシャットダウンします。

SIDDirNameMatch

型: REG_SZ

既定値: %sid%_%username%

データの値と使用:

プロファイルまたは ODFC コンテナー フォルダーを照合するときに使う文字列パターンを指定します。 この設定を使用して、FSLogix がユーザー プロファイルまたは ODFC コンテナーの検索を試みる方法を定義します。 FSLogix では、検索する場所として VHDLocations または CCDLocations を使用し、この設定によって検索対象が定義されます。 このパスでは、サインイン プロセス中にユーザーが使用できる FSLogix カスタム変数または環境変数の使用がサポートされています。

重要

競合する設定がどのように適用され、優先順位が付いているかを確実に理解しておく必要があります。

  • この構成設定を使用する場合は、SIDDIRNamePattern 値がこの設定と一致することをご確認ください。
    • FlipFlopProfileDirectoryName が有効になっている場合、この設定は無効になります。
    • NoProfileContainingFolder が有効になっている場合、この設定は無効になります。
    • NoProfileContainingFolder > FlipFlopProfileDirectoryName > SIDDirNameMatch (この設定)

SIDDirNamePattern

型: REG_SZ

既定値: %sid%_%username%

データの値と使用:

プロファイルまたは ODFC コンテナー フォルダーを作成するときに使う文字列パターンを指定します。 この設定を使用して、FSLogix がユーザー プロファイルまたは ODFC コンテナー フォルダーの作成を試みる方法を定義します。 FSLogix では、作成する場所として VHDLocations または CCDLocations を使用し、この設定によって作成する内容が定義されます。 このパスでは、サインイン プロセス中にユーザーが使用できる FSLogix カスタム変数または環境変数の使用がサポートされています。

重要

競合する設定がどのように適用され、優先順位が付いているかを確実に理解しておく必要があります。

  • この構成設定を使用する場合は、SIDDIRNameMatch 値がこの設定と一致することをご確認ください。
    • FlipFlopProfileDirectoryName が有効になっている場合、この設定は無効になります。
    • NoProfileContainingFolder が有効になっている場合、この設定は無効になります。
    • NoProfileContainingFolder > FlipFlopProfileDirectoryName > SIDDirNamePattern (この設定)

SIDDirSDDL

型: REG_SZ

既定値: 該当なし

データの値と使用:

SID コンテナー フォルダーの作成時に使う ACL を表す SDDL 文字列。

SizeInMBs

型: DWORD

既定値: 30000

データの値と使用:

ユーザーのコンテナーの最大サイズをメガバイト単位で指定します。 新しく作成された VHD(x) コンテナーは、このサイズになります。 既存のコンテナーは、ユーザーのサインイン時にこのサイズに自動的に拡張されます。 この値はいつでも増やすことができますが、値を小さくすることはできません。 この値を小さくしても、既存の VHD(x) コンテナーは縮小されません。

VHDNameMatch

型: REG_SZ

既定値: Profile*

データの値と使用:

ユーザー プロファイル コンテナーを照合するときに使用する文字列パターンを指定します。 この設定を使用して、FSLogix がユーザー プロファイル コンテナー (VHD(x) ファイル) の検索を試みる方法を定義します。 FSLogix では、検索する場所として VHDLocations または CCDLocations を使用し、この設定によって検索対象が定義されます。 このパスでは、サインイン プロセス中にユーザーが使用できる FSLogix カスタム変数または環境変数の使用がサポートされています。

重要

この構成設定を使用する場合は、VHDNamePattern 値がこの設定と一致することをご確認ください。

VHDNamePattern

型: REG_SZ

既定値: Profile_%username%

データの値と使用:

ユーザー プロファイル コンテナーを作成するときに使う文字列パターンを指定します。 この設定を使用して、FSLogix がユーザー プロファイル コンテナー (VHD(x) ファイル) の作成を試みる方法を定義します。 FSLogix では、検索する場所として VHDLocations または CCDLocations を使用し、この設定によって作成する内容が定義されます。 このパスでは、サインイン プロセス中にユーザーが使用できる FSLogix カスタム変数または環境変数の使用がサポートされています。

重要

この構成設定を使用する場合は、VHDNameMatch の値がこの設定と一致していることをご確認ください。

VHDLocations

(必須の設定)

型: MULTI_SZ または REG_SZ

既定値: 該当なし

データの値と使用:

ユーザーのプロファイル VHD(x) ファイルを検索する SMB の場所の一覧。 見つからない場合は、最初にリストアップされた場所に作成されます。 VHD パスが存在しない場合は、パス内に VHD(x) が存在するかどうかを確認する前に作成されます。 このパスでは、サインイン プロセス中にユーザーが使用できる FSLogix カスタム変数または環境変数の使用がサポートされています。 REG_SZ 値として指定すると、複数の場所をセミコロン (;) で区切ることができます。

VHDXSectorSize

型: DWORD

既定値: 0

データの値と使用:

  • 0: システムの既定値を使用します。
  • 512: VHD(x) は、512 バイトの割り当てを使って書式設定されます。
  • 4096: VHD(x) は、4096 バイトの割り当てを使って書式設定されます。

Note

値は 16 進数ではなく 10 進数で一覧表示されます。

VolumeType

型: REG_SZ

既定値: vhd

データの値と使用:

vhd という値は、新しく作成されるファイルの種類が VHD であることを意味します。 vhdx という値は、新しく作成されるファイルの種類が VHDX であることを意味します。

VolumeWaitTimeMS

型: DWORD

既定値: 20000

データの値と使用:

VHD(x) がアタッチされた後で、ボリュームが到着するまでシステムが待機する必要があるミリ秒数を指定します。 既定値は 20000 = 20 秒です