Citrix Virtual Apps and Desktops

Azure Localへの接続

接続とリソースの作成および管理では、接続を作成するウィザードについて説明しています。以下の情報は、Azure Local環境に固有の詳細をカバーしています。

  • ホスティング接続の作成

ホスト接続は、以下を使用して作成できます。

Web Studioの使用

  1. Web Studioで、ホスティング > 接続とリソースの追加を開きます。
  2. 接続ページで、以下の手順に従って接続を構成します。

    1. 新しい接続の作成を選択します。
    2. 接続の種類としてMicrosoft® Azure™ Arcを選択します。
    3. Azure環境を選択します。
    4. ゾーンを選択します。オプションは、構成したすべてのリソースの場所です。
    5. 仮想マシンを作成するためのその他のツールを選択します。

      注:

      その他のツールを選択すると、ホスティングユニットなしでホスティング接続のみが作成されます。

    6. 次へをクリックします。
  3. 接続の詳細ページで、ウィザードのガイダンスに従って接続の詳細を入力します。既存のSPNを使用する場合は、SPNにサブスクリプションの共同作成者ロールが付与されていることを確認してください。詳細については、「必要なAzure Localのアクセス許可」を参照してください。

  4. スコープページで、この接続のスコープを1つ以上選択します。
  5. 概要ページで、構成を確認し、完了をクリックします。

PowerShellの使用

スクリプトのヘッダー

スクリプトのヘッダーで定義されている正しいパラメーター値を指定していることを確認してください。

$azureSubscription = "" # Azure Subscription ID 

$azureTenantId = "" # Microsoft Entra Tenant ID 

$appClientId = "" # Client ID of an Microsoft Entra application which is grant with sufficient permissions 

-  $appClientSecret = "" # Client secret of above client ID 

$appClientSecretExpirationDateTimestamp = "" # Client secret expiration date in epoch timestamp format 

$region = "" # Azure region of your Azure Local cluster 

$resourceGroupName = "" # Azure resource group of your Azure Local cluster 

$zoneUid = "" # Zone UID of your resource location 

$hostingConnectionName = "" # Name of the created hosting connection 
<!--NeedCopy-->

ホスティング接続の作成

asnp citrix* 

[SecureString]$appClientSecretSecureString = $appClientSecret | ConvertTo-SecureString -AsPlainText -Force 

$conn = New-Item -ConnectionType "Custom" -CustomProperties "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"SubscriptionId`" Value=`"$azureSubscription`" /><Property xsi:type=`"StringProperty`" Name=`"ManagementEndpoint`" Value=`"https://management.azure.com/`" /><Property xsi:type=`"StringProperty`" Name=`"AuthenticationAuthority`" Value=`"https://login.microsoftonline.com/`" /><Property xsi:type=`"StringProperty`" Name=`"TenantId`" Value=`"$azureTenantId`" /></CustomProperties>" -HypervisorAddress @("https://management.azure.com/") -Path @("XDHyp:\Connections\$hostingConnectionName") -Persist -PluginId "AzureArcFactory" -Scope @() -SecurePassword $appClientSecretSecureString -UserName $appClientId -ZoneUid $zoneUid 

New-BrokerHypervisorConnection -HypHypervisorConnectionUid $conn.HypervisorConnectionUid 

Set-HypHypervisorConnectionMetadata -HypervisorConnectionUid $conn.HypervisorConnectionUid -Name Citrix_Orchestration_Hypervisor_Secret_Allow_Edit -Value true 

Set-HypHypervisorConnectionMetadata -HypervisorConnectionUid $conn.HypervisorConnectionUid -Name Citrix_Orchestration_Hypervisor_Secret_Expiration_Date -Value $appClientSecretExpirationDateTimestamp
<!--NeedCopy-->

ホスティングユニットの作成

ホスティングユニットは、以下を使用して作成できます。

-  [Web Studio](#create-a-hosting-unit-use-web-studio)
-  [PowerShell](#create-a-hosting-unit-using-powershell)

Web Studioを使用したホスティングユニットの作成

  1. Web Studioで、ホスティング > 接続とリソースの追加を開きます。
  2. 接続ページで:

    • ホスティングユニットとともに新しいホスティング接続を作成するには、新しい接続の作成を選択し、次の操作を行います。

      1. 新しい接続の作成を選択します。
      2. 接続の種類としてMicrosoft® Azure™ Arcを選択します。
      3. Azure環境を選択します。
      4. ゾーンを選択します。オプションは、構成したすべてのリソースの場所です。
      5. 仮想マシンを作成するためのCitrixプロビジョニングツール (Machine Creation Services™またはCitrix Provisioning)を選択します。
      6. 次へをクリックします。
    • 既存のホスト接続からホスティングユニットを作成するには、既存の接続を使用を選択し、関連する接続を選択します。

  3. 接続の詳細ページで、ウィザードのガイダンスに従って接続の詳細を入力します。既存のSPNを使用する場合は、SPNにサブスクリプションの共同作成者ロールが付与されていることを確認してください。
  4. クラスターの選択ページで、リソースグループを参照し、ターゲットのAzure Localクラスターを選択します。
  5. ストレージの選択ページで、ウィザードの次のページに進む前に、サポートされているデータ型ごとに少なくとも1つのストレージデバイスを選択します。ストレージの選択の詳細については、「ホストストレージ」を参照してください。
  6. ネットワークページで、リソースの名前を入力します。この名前は、接続に関連付けられたストレージとネットワークの組み合わせを識別するためにStudioに表示されます。VMが使用するネットワークを1つ以上選択します。
  7. 概要ページで、詳細を確認し、完了をクリックします。

PowerShellを使用したホスティングユニットの作成

スクリプトのヘッダー

スクリプトのヘッダーで定義されている正しいパラメーター値を指定していることを確認してください。

$resourceGroupName = "" # Azure resource group of your Azure Local cluster 

$clusterName = "" # Name of your Azure Local cluster 

$storagePathName = "" # Storage path in your Azure Local cluster that wants to be used in this hosting unit 

$logicalNetworkName = "" # Logical network in your Azure Local cluster that wants to be used in this hosting unit 

$zoneUid = "" # Zone UID of your resource location 

$hostingConnectionName = "" # Name of the created hosting connection 

$hostingUnitName = "" # Name of the created hosting unit 
<!--NeedCopy-->

ホスティングユニットの作成

asnp citrix* 

$guid = (New-Guid).Guid 

New-HypStorage -StoragePath @("XDHyp:\Connections\$hostingConnectionName\$region.region\$resourceGroupName.resourcegroup\cluster.folder\$clusterName.cluster\storage.folder\$storagePathName.storage") -StorageType "TemporaryStorage" -JobGroup $guid 

New-Item -Path XDHyp:\HostingUnits -Name $hostingUnitName -HypervisorConnectionName $hostingConnectionName -RootPath "XDHyp:\Connections\$hostingConnectionName\$region.region\$resourceGroupName.resourcegroup\cluster.folder\$clusterName.cluster" -NetworkPath "XDHyp:\Connections\$hostingConnectionName\$region.region\$resourceGroupName.resourcegroup\cluster.folder\$clusterName.cluster\network.folder\$logicalNetworkName.network" -StoragePath "XDHyp:\Connections\$hostingConnectionName\$region.region\$resourceGroupName.resourcegroup\cluster.folder\$clusterName.cluster\storage.folder\$storagePathName.storage" -JobGroup $guid 
<!--NeedCopy-->

必要なAzure Localのアクセス許可

共同作成者ロールは、すべてのリソースを管理するためのフルアクセス権を持ち、現在の機能セットで必要とされる以上のアクセス許可が含まれているものの、今後も最高の互換性を提供します。このセクションでは、Azure Localに必要な最小限のアクセス許可について詳しく説明します。

最小限のアクセス許可

VMの電源管理

"Microsoft.Resources/tenants/read", 

"Microsoft.Resources/subscriptions/read", 

"Microsoft.Resources/subscriptions/locations/read", 

"Microsoft.Resources/subscriptions/resourceGroups/read", 

"Microsoft.AzureStackHCI/VirtualMachines/Read", 

"Microsoft.AzureStackHCI/virtualMachineInstances/Read", 

-  "Microsoft.AzureStackHCI/LogicalNetworks/Read", 

"Microsoft.AzureStackHCI/StorageContainers/Read", 

"Microsoft.AzureStackHCI/Clusters/Read", 

"Microsoft.AzureStackHCI/VirtualMachineInstances/start/action", 

"Microsoft.AzureStackHCI/VirtualMachineInstances/stop/action", 

"Microsoft.AzureStackHCI/VirtualMachineInstances/restart/action" 

"Microsoft.ExtendedLocation/CustomLocations/Read", 

"Microsoft.KubernetesConfiguration/extensions/read", 

"Microsoft.HybridCompute/machines/read" 
<!--NeedCopy-->

VMの作成、更新、または削除

"Microsoft.Resources/tenants/read", 

"Microsoft.Resources/subscriptions/read", 

"Microsoft.Resources/subscriptions/locations/read", 

"Microsoft.Resources/subscriptions/resourceGroups/read", 

"Microsoft.Resources/subscriptions/resourceGroups/write", 

"Microsoft.Resources/subscriptions/resourceGroups/delete", 

"Microsoft.HybridCompute/machines/read", 

"Microsoft.HybridCompute/machines/write", 

"Microsoft.HybridCompute/machines/delete", 

"Microsoft.AzureStackHCI/Clusters/Read", 

"Microsoft.AzureStackHCI/VirtualMachines/Read", 

"Microsoft.AzureStackHCI/VirtualMachines/Write", 

"Microsoft.AzureStackHCI/VirtualMachines/Delete", 

"Microsoft.AzureStackHCI/virtualMachineInstances/Read", 

"Microsoft.AzureStackHCI/virtualMachineInstances/Write", 

"Microsoft.AzureStackHCI/virtualMachineInstances/Delete", 

"Microsoft.AzureStackHCI/VirtualMachineInstances/start/action", 

"Microsoft.AzureStackHCI/VirtualMachineInstances/stop/action", 

"Microsoft.AzureStackHCI/VirtualMachineInstances/restart/action", 

"Microsoft.AzureStackHCI/LogicalNetworks/Read", 

"Microsoft.AzureStackHCI/LogicalNetworks/join/action", 

"Microsoft.AzureStackHCI/StorageContainers/Read", 

"Microsoft.AzureStackHCI/StorageContainers/deploy/action", 

"Microsoft.AzureStackHCI/GalleryImages/Read", 

"Microsoft.AzureStackHCI/GalleryImages/Write", 

"Microsoft.AzureStackHCI/GalleryImages/Delete", 

"Microsoft.AzureStackHCI/GalleryImages/deploy/action", 

"Microsoft.AzureStackHCI/NetworkInterfaces/Read", 

"Microsoft.AzureStackHCI/NetworkInterfaces/Write", 

"Microsoft.AzureStackHCI/NetworkInterfaces/Delete", 

"Microsoft.AzureStackHCI/VirtualHardDisks/Read", 

"Microsoft.AzureStackHCI/VirtualHardDisks/Write", 

"Microsoft.AzureStackHCI/VirtualHardDisks/Delete", 

"Microsoft.AzureStackHCI/VirtualHardDisks/upload/action", 

"Microsoft.AzureStackHCI/marketplaceGalleryImages/deploy/action", 

"Microsoft.ExtendedLocation/CustomLocations/Read", 

"Microsoft.ExtendedLocation/customLocations/deploy/action", 

"Microsoft.KubernetesConfiguration/extensions/read", 

"Microsoft.Compute/disks/read", 

"Microsoft.Compute/disks/write", 

"Microsoft.Compute/disks/delete", 

"Microsoft.Compute/disks/beginGetAccess/action", 

"Microsoft.Compute/disks/endGetAccess/action", 

"Microsoft.Compute/snapshots/read", 

"Microsoft.Compute/snapshots/write", 

"Microsoft.Compute/snapshots/delete", 

"Microsoft.Compute/snapshots/beginGetAccess/action", 

"Microsoft.Compute/snapshots/endGetAccess/action"
<!--NeedCopy-->

次のステップ

詳細情報

Azure Localへの接続