Produktdokumentation
Citrix Virtual Apps and Desktops
Current Release Service 2511 2507 LTSR 2503 2411 2407 2402 LTSR 2311 2203 LTSR

Verbindung mit Azure Local

June 5, 2026
Beitrag von: 
C

(/de-de/citrix-virtual-apps-desktops/2511/install-configure/connections.html) beschreibt die Assistenten, die eine Verbindung erstellen. Die folgenden Informationen behandeln Details, die spezifisch für Azure Local-Umgebungen sind.

Hostverbindung erstellen

Sie können eine Hostverbindung erstellen mit:

Web Studio verwenden

  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.
    3. Wählen Sie eine Azure-Umgebung.
    4. Wählen Sie eine Zone. Die Optionen sind alle von Ihnen konfigurierten Ressourcenstandorte.

    5. Wählen Sie Andere Tools zum Erstellen virtueller Maschinen.

      Hinweis:

      Das Auswählen von Andere Tools erstellt nur die Hosting-Verbindung ohne eine Hosting-Einheit.

    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 des Mitwirkenden 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.

PowerShell verwenden

Header des Skripts

Stellen Sie sicher, dass Sie die korrekten Parameterwerte angeben, die im Header 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-->

Eine Hosting-Verbindung erstellen 

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

Eine Hosting-Einheit erstellen

Sie können eine Hosting-Einheit erstellen mit:

Eine Hosting-Einheit erstellen: Web Studio verwenden

  1. Öffnen Sie in Web Studio Hosting > Verbindung und Ressourcen hinzufügen.

  2. Auf der Seite Verbindung:

    • Um eine neue Hosting-Verbindung zusammen mit einer Hosting-Einheit 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.
      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.
      6. Klicken Sie auf Weiter.

    • Um Hosting-Einheiten 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 des Mitwirkenden für das Abonnement zugewiesen wurde.
  4. Auf der Seite Clusterauswahl durchsuchen Sie Ressourcengruppen und wählen 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 Hosting-Einheit mit PowerShell

Header des Skripts

Stellen Sie sicher, dass Sie die korrekten Parameterwerte angeben, die im Header 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-->

Hostingeinheit erstellen 

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 zukünftige Kompatibilität, 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
June 5, 2026
Beitrag von: 
C
June 5, 2026
Beitrag von: 
C

In diesem Artikel

Feedback zur Site | Your privacy choices footer linkIhre Datenschutzauswahl | Datenschutz und rechtliche Bestimmungen | Cookie-Einstellungen | Einstellungen für die Zustimmung | docs.cloud.com
© 1999- Cloud Software Group, Inc. All rights reserved.