Citrix Virtual Apps and Desktops

Verbindung mit Azure Local

Erstellen und Verwalten von Verbindungen und Ressourcen beschreibt die Assistenten, die eine Verbindung erstellen. Die folgenden Informationen behandeln Details, die spezifisch für Azure Local-Umgebungen sind.

  • Erstellen einer Hostverbindung

Sie können eine Hostverbindung erstellen mit:

Verwenden von Web Studio

  1. Öffnen Sie in Web Studio Hosting > Verbindung und Ressourcen hinzufügen.
  2. Führen Sie auf der Seite Verbindung die folgenden Schritte aus, um die Verbindung zu konfigurieren:

    1. Wählen Sie Neue Verbindung erstellen.
    2. Wählen Sie Microsoft® Azure™ Arc als Verbindungstyp aus.
    3. Wählen Sie eine Azure-Umgebung aus.
    4. Wählen Sie eine Zone aus. Die Optionen sind alle von Ihnen konfigurierten Ressourcenstandorte.
    5. Wählen Sie Andere Tools zum Erstellen virtueller Maschinen aus.

      Hinweis:

      Die Auswahl von Andere Tools erstellt nur die Hostverbindung ohne eine Hostingeinheit.

    6. Klicken Sie auf Weiter.
  3. Geben Sie auf der Seite Verbindungsdetails die Verbindungsdetails gemäß den Anweisungen im Assistenten ein. Wenn Sie einen vorhandenen SPN verwenden, stellen Sie sicher, dass dem SPN die Rolle “Mitwirkender” für das Abonnement zugewiesen wurde. Weitere Informationen finden Sie unter Erforderliche Azure Local-Berechtigungen.

  4. Wählen Sie auf der Seite Bereiche einen oder mehrere Bereiche für diese Verbindung aus.
  5. Überprüfen Sie auf der Seite Zusammenfassung die Konfiguration und klicken Sie auf Fertig stellen.

Verwenden von PowerShell

Kopfzeile des Skripts

Stellen Sie sicher, dass Sie die korrekten Parameterwerte angeben, die in der Kopfzeile des Skripts definiert sind.

$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-->

Erstellen einer Hostverbindung

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-->

Erstellen einer Hostingeinheit

Sie können eine Hostingeinheit erstellen mit:

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

Erstellen einer Hostingeinheit mit Web Studio

  1. Öffnen Sie in Web Studio Hosting > Verbindung und Ressourcen hinzufügen.
  2. Auf der Seite Verbindung:

    • Um eine neue Hostverbindung zusammen mit einer Hostingeinheit zu erstellen, wählen Sie Neue Verbindung erstellen und gehen Sie dann wie folgt vor:

      1. Wählen Sie Neue Verbindung erstellen.
      2. Wählen Sie Microsoft® Azure™ Arc als Verbindungstyp aus.
      3. Wählen Sie eine Azure-Umgebung aus.
      4. Wählen Sie eine Zone aus. Die Optionen sind alle von Ihnen konfigurierten Ressourcenstandorte.
      5. Wählen Sie Citrix-Bereitstellungstools (Machine Creation Services™ oder Citrix Provisioning) zum Erstellen virtueller Maschinen aus.
      6. Klicken Sie auf Weiter.
    • Um Hostingeinheiten aus einer vorhandenen Hostverbindung zu erstellen, wählen Sie Vorhandene Verbindung verwenden und dann die entsprechende Verbindung aus.

  3. Geben Sie auf der Seite Verbindungsdetails die Verbindungsdetails gemäß den Anweisungen im Assistenten ein. Wenn Sie einen vorhandenen SPN verwenden, stellen Sie sicher, dass dem SPN die Rolle “Mitwirkender” für das Abonnement zugewiesen wurde.
  4. Navigieren Sie auf der Seite Clusterauswahl durch die Ressourcengruppen und wählen Sie den Ziel-Azure Local-Cluster aus.
  5. Wählen Sie auf der Seite Speicherauswahl mindestens ein Speichergerät für jeden unterstützten Datentyp aus, bevor Sie mit der nächsten Seite im Assistenten fortfahren können. Weitere Informationen zur Speicherauswahl finden Sie unter Hostspeicher.
  6. Geben Sie auf der Seite Netzwerk einen Namen für die Ressourcen ein. Dieser Name wird in Studio angezeigt, um die mit der Verbindung verknüpfte Speicher- und Netzwerkkombination zu identifizieren. Wählen Sie ein oder mehrere Netzwerke aus, die die VMs verwenden.
  7. Überprüfen Sie auf der Seite Zusammenfassung die Details und klicken Sie auf Fertig stellen.

Erstellen einer Hostingeinheit mit PowerShell

Kopfzeile des Skripts

Stellen Sie sicher, dass Sie die korrekten Parameterwerte angeben, die in der Kopfzeile des Skripts definiert sind.

$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-->

Erstellen einer Hostingeinheit

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-->

Erforderliche Azure Local-Berechtigungen

Die Rolle “Mitwirkender” hat vollen Zugriff auf die Verwaltung aller Ressourcen und bietet die beste Kompatibilität für die Zukunft, obwohl sie mehr Berechtigungen umfasst, als mit dem aktuellen Funktionsumfang erforderlich sind. Dieser Abschnitt beschreibt die Mindestberechtigungen, die für Azure Local erforderlich sind.

Mindestberechtigungen

Energieverwaltung von VMs

"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-->

Erstellen, Aktualisieren oder Löschen von VMs

"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-->

Nächste Schritte

Weitere Informationen

Verbindung mit Azure Local