Citrix Virtual Apps and Desktops

Microsoft Entra ハイブリッド参加済みマシンIDのIDプール

この記事では、以下のIDプールを作成する方法について説明します。

  • Microsoft Entra ハイブリッド参加済みカタログ
  • Microsoft Intuneに登録されているMicrosoft Entra ハイブリッド参加済みカタログ

要件、制限、および考慮事項については、「Microsoft Entra ハイブリッド参加済み」を参照してください。

Microsoft Entra ハイブリッド参加済みカタログを作成する

Web Studioを使用する

以下の情報は、「マシンカタログの作成」のガイダンスを補足するものです。

カタログ作成ウィザードのマシンIDページで、:

  • Microsoft Entra ハイブリッド参加済みを選択します。作成されたマシンは組織が所有し、その組織に属するActive Directoryアカウントでサインインされます。

  • 作成されたマシンをデバイス管理のためにMicrosoft Intune(Configuration Managerを含む)に登録するには、Configuration Managerを使用してMicrosoft Intuneにマシンを登録するを選択します。カタログ作成中のエラーを回避するために、マスターイメージが以下の要件を満たしていることを確認してください。

    • VDAバージョン2405以降がインストールされていること。
    • サイトコードが割り当てられていないConfiguration Managerクライアントがインストールされていること。詳細については、このMicrosoft記事を参照してください。

注:

IDの種類としてMicrosoft Entra ハイブリッド参加済みを選択した場合、カタログ内の各マシンには対応するADコンピューターアカウントが必要です。

  • Entra ID デバイスオブジェクトに一意のカスタムデータを直接保存するには、「拡張属性の追加」をクリックします。「拡張属性の追加」ページで、「拡張属性」と「」を追加します。

注:

  • 拡張属性は最大15個まで追加できます。
  • 名前と値は一意である必要があり、空にすることはできません。

拡張属性の追加または変更

既存のMCSマシンカタログに拡張属性を変更または追加する場合、またはサービスアカウントなしでMCSカタログに拡張属性を追加する場合は、「マシンカタログの編集」ウィザードを使用します。

  • 拡張属性を変更または追加するには、「Microsoft Entraデバイス拡張属性」ページに移動します。鉛筆アイコンをクリックし、拡張属性を追加または更新します。
  • Microsoft EntraサービスアカウントなしでMCSカタログに拡張属性を追加するには:

    1. サービスアカウント」ページに移動します。Microsoft Intra ID の Microsoft Entra サービスアカウントを選択します。
    2. Microsoft Entraデバイス拡張属性ページに移動し、「拡張属性の追加」をクリックします。

PowerShellの使用

Web Studioでの操作に相当するPowerShellの手順は次のとおりです。Remote PowerShell SDKを使用してカタログを作成する方法については、https://developer-docs.citrix.com/projects/citrix-virtual-apps-desktops-sdk/en/latest/creating-a-catalog/を参照してください。

オンプレミスAD参加カタログとMicrosoft Entraハイブリッド参加カタログの違いは、IDプールとマシンアカウントの作成にあります。

Microsoft Entraハイブリッド参加カタログのアカウントとともにIDプールを作成するには:

New-AcctIdentityPool -AllowUnicode -IdentityType "HybridAzureAD" -Domain "corp.local" -IdentityPoolName "HybridAADJoinedCatalog" -NamingScheme "HybridAAD-VM-##" -NamingSchemeType "Numeric" -OU "CN=AADComputers,DC=corp,DC=local" -Scope @() -ZoneUid "81291221-d2f2-49d2-ab12-bae5bbd0df05"
New-AcctIdentity -IdentityPoolName "HybridAADJoinedCatalog" -Count 10 -ADUserName "corp\admin1" -ADPassword $password
Set-AcctAdAccountUserCert -IdentityPoolName "HybridAADJoinedCatalog" -All -ADUserName "corp\admin1" -ADPassword $password
<!--NeedCopy-->

注:

$password は、書き込み権限を持つADユーザーアカウントの一致するパスワードです。

Microsoft Entra ハイブリッド参加済みカタログの作成に使用されるその他のすべてのコマンドは、従来のオンプレミスAD参加済みカタログの場合と同じです。

指定された拡張属性を持つ新しいIDプールを作成し、それをサービスアカウントに関連付けるには、以下を実行します。

New-AcctIdentityPool -IdentityPoolName HybridAzureAD -NamingScheme ACC#### -NamingSchemeType Numeric -Domain "abc.local" -IdentityType HybridAzureAD -ServiceAccountUid $serviceAccountUid -EntraIDExtensionAttributes @{"extensionAttribute1" = "val1"; "extensionAttribute2" = "val2"}
<!--NeedCopy-->

VMが初めて電源オンになり、Microsoft Entra IDに参加した後、VMはそのEntra ID deviceIdをMCSに報告します。

例: EntraIDDeviceID を確認するには、Get-AcctADAccount または Get-AcctIdentity を実行します。

Get-AcctADAccount -IdentityPoolName MyPool
<!--NeedCopy-->

再起動後、永続VMと非永続VMの場合、EntraIDDeviceID は同じままです。

注:

カタログからVMを削除してもAzureからは削除しない場合、MCSは関連付けられたデバイスIDと拡張属性を自動的に削除します。

既存のカタログの拡張属性を編集するには、以下を実行します。

注:

  • 既存のカタログVMをVDAバージョン2511以降にアップグレードした後、再起動が必要です。この再起動により、VMはEntra ID deviceIdをMCSに報告できるようになり、その後MCSがVMの拡張属性を構成できるようになります。
  • 既存のカタログには、”Device.ReadWrite.All” の権限を持つAzureADタイプのサービスアカウントが必要です。

新しい属性を追加するには:

Set-AcctIdentityPool -IdentityPoolName MyPool -EntraIDExtensionAttributes @{"extensionAttribute1" = "val1"; "extensionAttribute2" = "val2"}
<!--NeedCopy-->

既存の属性を削除するには

Set-AcctIdentityPool -IdentityPoolName MyPool -EntraIDExtensionAttributes @{}
<!--NeedCopy-->

または

Set-AcctIdentityPool -IdentityPoolName MyPool -EntraIDExtensionAttributes @{extensionAttribute1 = ""; extensionAttribute2 = ""}
<!--NeedCopy-->

Set-AcctIdentityPool は、すでにEntra IDに参加しており、ID内にEntraIDDeviceID値を持つVMのEntra IDデバイスの拡張属性も更新します。

Microsoft Entra ハイブリッド参加プロセスのステータスを表示する

Web Studioでは、デリバリーグループ内のMicrosoft Entra ハイブリッド参加済みマシンが電源オン状態の場合に、Microsoft Entra ハイブリッド参加プロセスのステータスが表示されます。ステータスを表示するには、Searchを使用してそれらのマシンを特定し、各マシンの下部ペインにあるDetailsタブでMachine Identityを確認します。Machine Identityには次の情報が表示されます。

  • Microsoft Entra ハイブリッド参加済み
  • まだMicrosoft Entra IDに参加していません

注記:

  • マシンが最初に電源オンになったときに、Microsoft Entra ハイブリッド参加に遅延が発生する場合があります。これは、デフォルトのマシンID同期間隔(Microsoft Entra Connectの30分)が原因です。マシンは、マシンIDがMicrosoft Entra Connectを介してMicrosoft Entra IDに同期された後にのみ、Microsoft Entra ハイブリッド参加状態になります。
  • マシンがMicrosoft Entra ハイブリッド参加状態にならなかった場合、それらはDelivery Controllerに登録されません。登録ステータスはInitializationと表示されます。

また、Web Studioを使用して、マシンが利用できない理由を知ることができます。そのためには、Searchノードでマシンをクリックし、下部ペインのDetailsタブでRegistrationを確認し、ツールチップを読んで追加情報を確認します。

トラブルシューティング

マシンがMicrosoft Entra ハイブリッド参加に失敗した場合は、次の手順を実行します。

  • マシンアカウントがMicrosoft Microsoft Entra IDポータルを通じてMicrosoft Entra IDに同期されているか確認します。同期されている場合、Not yet joined to Microsoft Entra IDと表示され、登録が保留中であることを示します。

    マシンアカウントをMicrosoft Entra IDに同期するには、以下を確認してください。

    • マシンアカウントが、Microsoft Entra IDと同期するように構成されたOU内にあること。userCertificate属性を持たないマシンアカウントは、同期するように構成されたOU内にあってもMicrosoft Entra IDに同期されません。
    • userCertificate属性がマシンアカウントに設定されていること。属性を表示するには、Active Directory Explorerを使用します。
    • マシンアカウントが作成された後、Microsoft Entra Connect が少なくとも一度同期されている必要があります。同期されていない場合は、Microsoft Entra Connect マシンの PowerShell コンソールで Start-ADSyncSyncCycle -PolicyType Delta コマンドを手動で実行して、即時同期をトリガーします。
  • HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Citrix の下の DeviceKeyPairRestored の値をクエリして、Microsoft Entra ハイブリッド参加用の Citrix 管理デバイスキーペアがマシンに正しくプッシュされているか確認します。

    値が 1 であることを確認します。そうでない場合、考えられる理由は次のとおりです。

    • プロビジョニングスキームに関連付けられている ID プールの IdentityTypeHybridAzureAD に設定されていません。これは Get-AcctIdentityPool を実行して確認できます。
    • マシンがマシンカタログと同じプロビジョニングスキームを使用してプロビジョニングされていません。
    • マシンがローカルドメインに参加していません。ローカルドメインへの参加は、Microsoft Entra ハイブリッド参加の前提条件です。
  • MCS でプロビジョニングされたマシンで dsregcmd /status /debug コマンドを実行して、診断メッセージを確認します。

    • Microsoft Entra ハイブリッド参加が成功した場合、コマンドラインの出力で AzureAdJoinedDomainJoinedYES になります。

    • そうでない場合は、Microsoft のドキュメントを参照して問題をトラブルシューティングしてください: https://docs.microsoft.com/ja-jp/azure/active-directory/devices/troubleshoot-hybrid-join-windows-current

    • Server Message: The user certificate is not found on the device with id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx というエラーメッセージが表示された場合は、次の PowerShell コマンドを実行してユーザー証明書を修復します。

       Repair-AcctIdentity -IdentityAccountName TEST\VM1 -Target UserCertificate
       <!--NeedCopy-->
      

      ユーザー証明書の問題の詳細については、CTX566696 を参照してください。

Microsoft Intune に登録されている Microsoft Entra ハイブリッド参加カタログを作成する

Microsoft Intune に登録されている Microsoft Entra ハイブリッド参加カタログ向けに、永続的なシングルセッションおよびマルチセッション VM 用の共同管理対応カタログを作成できます。共同管理対応カタログは、Studio と PowerShell の両方を使用して作成できます。

Web Studio を使用する

以下の情報は、マシンカタログの作成 のガイダンスを補足するものです。

マシンカタログのセットアップ」ウィザードで:

  • マシンID」ページで、「Microsoft Entra ハイブリッド参加済み」を選択し、次に「Configuration Manager を使用して Microsoft Intune にマシンを登録する」を選択します。このアクションを使用すると、Configuration Manager と Microsoft Intune (つまり、共同管理) が VM を管理します。

PowerShell を使用する

以下は、Studio の手順に相当する PowerShell の手順です。

Remote PowerShell SDK を使用して Configuration Manager で Microsoft Intune にマシンを登録するには、New-AcctIdentityPoolDeviceManagementType パラメーターを使用します。この機能には、カタログが Microsoft Entra ハイブリッド参加済みであり、Microsoft Entra ID が適切な Microsoft Intune ライセンスを所有している必要があります。

Microsoft Entra ハイブリッド参加済みカタログと共同管理が有効なカタログの違いは、ID プールの作成にあります。例:

New-AcctIdentityPool -AllowUnicode -DeviceManagementType "IntuneWithSCCM" IdentityType="HybridAzureAD" -IdentityPoolName "CoManagedCatalog" -NamingScheme "CoManaged-VM-##" -NamingSchemeType "Numeric" -Scope @() -ZoneUid "81291221-d2f2-49d2-ab12-bae5bbd0df05"
<!--NeedCopy-->

トラブルシューティング

マシンが Microsoft Intune への登録に失敗したり、共同管理状態に到達できなかったりした場合は、次の操作を行います。

  • Intune ライセンスを確認する

    Microsoft Entra テナントに適切な Intune ライセンスが割り当てられているか確認します。Microsoft Intune のライセンス要件については、Microsoft Intune のライセンス を参照してください。

  • Microsoft Entra ハイブリッド参加の状態を確認する

    MCS でプロビジョニングされたマシンが Microsoft Entra ハイブリッド参加済みであるか確認します。Microsoft Entra ハイブリッド参加済みでない場合、マシンは共同管理の対象になりません。Microsoft Entra ハイブリッド参加の問題をトラブルシューティングするには、トラブルシューティング を参照してください。

  • 共同管理の適格性を確認する

    • MCS でプロビジョニングされたマシンが、予期される Configuration Manager サイトに正しく割り当てられているか確認します。割り当てられたサイトを取得するには、影響を受けるマシンで次の PowerShell コマンドを実行します。

       (New-Object -ComObject "Microsoft.SMS.Client").GetAssignedSite()
       <!--NeedCopy-->
      
    • VM にサイトが割り当てられていない場合は、次のコマンドを使用して、Configuration Manager サイトが自動的に検出できるか確認します。

       (New-Object -ComObject "Microsoft.SMS.Client").AutoDiscoverSite()
       <!--NeedCopy-->
      
    • サイトコードが検出されない場合は、Configuration Manager環境で境界と境界グループが適切に構成されていることを確認してください。詳細については、考慮事項を参照してください。

    • Configuration Managerクライアントのサイト割り当てに関する問題がないか、C:\Windows\CCM\Logs\ClientLocation.logを確認してください。

    • マシンの共同管理の状態を確認します。影響を受けるマシンでConfiguration Managerコントロールパネルを開き、全般タブに移動します。共同管理プロパティの値は有効である必要があります。そうでない場合は、C:\Windows\CCM\Logs\CoManagementHandler.logの下のログを確認してください。

  • Intune登録を確認する

    すべての前提条件が満たされていても、マシンがMicrosoft Intuneに登録できない場合があります。Intune登録の問題については、アプリケーションとサービスログ > Microsoft > Windows > DeviceManagement-Enterprise-Diagnostics-Providerの下にあるWindowsイベントログを確認してください。

Microsoft Entra ハイブリッド参加済みマシンIDのIDプール