Produktdokumentation
Citrix Virtual Apps and Desktops
Service Current Release 2402 LTSR 2311 2308 2305 2303 2212 2209 2206 2203 LTSR 1912 LTSR
PDF anzeigen

Katalog für Azure Local erstellen

April 7, 2026
Beitrag von: 
C C

Maschinenkataloge erstellen beschreibt die Assistenten, mit denen ein Maschinenkatalog erstellt wird. Die folgenden Informationen behandeln Details, die spezifisch für Azure Local-Umgebungen sind.

Hinweis:

  • Bevor Sie einen Azure Local-Maschinenkatalog erstellen, müssen Sie die Erstellung einer Verbindung zu Azure Local abgeschlossen haben. Siehe Verbindung zu Azure Local.

Anforderungen

  • VDA-Version: 2507 und höher
  • Windows 10/11 Multi-Session-Workload wird nicht unterstützt

Masterimage erstellen

Zum Erstellen eines Maschinenkatalogs ist ein Masterimage erforderlich.

MCS verwendet ein Azure Local-VM-Image als Masterimage. Bevor Sie MCS zum Bereitstellen von Workloads in einem Azure Local-Cluster verwenden, müssen Sie ein Azure Local-VM-Image mit installiertem VDA vorbereiten.

  1. Erstellen Sie eine Azure Local-VM über das Azure-Portal.
  2. Stellen Sie eine Verbindung mit der erstellten Azure Local-VM her, um den VDA und die erforderliche Software zu installieren.

  3. Erstellen Sie eine geplante Aufgabe mit dem Windows Aufgabenplaner, um das folgende Skript beim VM-Start im Systemkontext auszuführen.

    ``` $tagFileName = ‘E6DA6616-8EC4-48E0-BE93-58CE6ACE3CFB.tag’

    $foundDrive = $null

    foreach ($drive in Get-PSDrive -PSProvider FileSystem) {

    $tagPath = Join-Path $drive.Root $tagFileName

    if (Test-Path $tagPath) {

    $foundDrive = $drive.Root 

break

    }

    }

    if ([string]::IsNullOrEmpty($foundDrive)) { exit 0 }

    $installScript = Join-Path $foundDrive ‘install.ps1’

    if (Test-Path $installScript) {

  • powershell.exe -NoProfile -ExecutionPolicy Bypass -File $installScript

    } else { exit 1 }

    sc.exe stop mocguestagent 2>$null

    sc.exe delete mocguestagent 2>$null

    Remove-Item ‘HKLM:\SYSTEM\CurrentControlSet\Services\EventLog\Application\mocguestagent’ -Recurse -Force -ErrorAction SilentlyContinue

    $setupComplete = ‘C:\Windows\Setup\Scripts\SetupComplete.cmd’

    if (Test-Path $setupComplete) { & $setupComplete }

    ```

  1. Beenden Sie die Azure Local-VM.
  2. Informationen zum Erstellen eines Azure Local-VM-Images aus der vorbereiteten Azure Local-VM finden Sie unter VM-Image aus einer vorhandenen Azure Local-VM erstellen.

Hinweis:

Wenn Sie ein Masterimage mit einer Azure Local-VM vorbereiten, auf der der Azure Connected Machine-Agent Version 1.61 oder höher installiert und integriert ist, schlägt die Katalogerstellung in MCS während des Image-Vorbereitungsprozesses aufgrund einer Zugriffsverweigerung beim Löschen der Agent-Konfigurationsdatei fehl. Als Problemumgehung gehen Sie beim Erstellen eines Masterimages wie folgt vor: Navigieren Sie zu C:\ProgramData\AzureConnectedMachineAgent\Config\agentconfig.json, klicken Sie mit der rechten Maustaste auf die Datei, wählen Sie Eigenschaften aus und deaktivieren Sie das Kontrollkästchen Schreibgeschützt.

Katalog erstellen

Sie können Azure Local-Kataloge erstellen, um Maschinen in Ihrer Azure Local-Umgebung zu erstellen, bereitzustellen und den Energieverbrauch zu verwalten.

Hinweis:

-  > -  Die Länge des Katalognamens darf 49 Zeichen nicht überschreiten.
-  > -  Vermeiden Sie die Verwendung von für Microsoft Azure reservierten Wörtern im Katalognamen oder im Maschinennamensschema. Weitere Informationen finden Sie im [Microsoft-Dokument](https://learn.microsoft.com/de-de/azure/azure-resource-manager/troubleshooting/error-reserved-resource-name).

Sie können den Katalog mit den folgenden Methoden erstellen:

Katalog mit Web Studio erstellen

Sie können einen MCS-Maschinenkatalog in der Azure Local-Umgebung erstellen.

Im Assistenten zum Einrichten des Maschinenkatalogs:

  1. Wählen Sie auf der Seite Betriebssystem die Option Multi-Session-Betriebssystem oder Single-Session-Betriebssystem aus.
  2. Auf der Seite Maschinenverwaltung:
    1. Wählen Sie Energieverwaltete Maschinen (z. B. virtuelle Maschinen oder Blade-PCs) aus.
    2. Wählen Sie die Bereitstellung von Maschinen mit Citrix Provisioning-Technologie aus.
    3. Wählen Sie die Azure Local-Hostingeinheit unter Citrix Machine Creation Services (MCS) aus.
  3. Wählen Sie auf der Seite Desktop-Erfahrung die Option entsprechend dem Maschinentyp aus, den Sie auf der Seite “Maschinentyp” ausgewählt haben.
  4. Auf der Seite Image:
    1. Wählen Sie ein Masterimage aus. Derzeit unterstützt Azure Local keine vorbereiteten Images.
    2. Sie können dem ausgewählten Image eine Notiz hinzufügen.

    Hinweis:

    -  Der Betriebssystemtyp wird nach Auswahl des Masterimages automatisch ausgefüllt.
-  Maschinenprofile werden nicht unterstützt.
  5. Wählen Sie auf der Seite NICs eine oder mehrere NICs aus und ordnen Sie jeder Karte ein virtuelles Netzwerk zu.

  6. Auf der Seite Virtuelle Maschinen:

    1. Geben Sie an, wie viele virtuelle Maschinen erstellt werden sollen. Geben Sie 0 ein, wenn Sie keine erstellen möchten. Später können Sie VMs für einen leeren Katalog erstellen, indem Sie Maschinen hinzufügen.
    2. Wählen Sie die Speichermenge (in MB) und die Anzahl der virtuellen CPUs für jede VM aus.
    3. Konfigurieren Sie den Write-Back-Cache für Maschinen, um die E/A-Leistung zu verbessern.
  7. Befolgen Sie die Anweisungen auf dem Bildschirm, um die restlichen Schritte abzuschließen, die keine Azure Local-spezifischen Informationen enthalten.

Sie können Web Studio auch verwenden, um Azure Local-Kataloge zu erstellen, um die Leistung vorhandener Maschinen in Ihrem Azure Local-Cluster bereitzustellen und zu verwalten.

Im Assistenten zum Einrichten des Maschinenkatalogs:

  1. Wählen Sie auf der Seite Betriebssystem die Option Multi-Session-Betriebssystem oder Single-Session-Betriebssystem aus.
  2. Wählen Sie auf der Seite Maschinenverwaltung die Option Energieverwaltete Maschinen und dann Anderer Dienst oder andere Technologie als Methode zur Bereitstellung von Maschinen aus.

  3. Fügen Sie auf der Seite Virtuelle Maschinen Maschinen und deren Active Directory-Maschinenkonten hinzu. Sie können:

    • Maschinen manuell hinzufügen: Klicken Sie auf Maschinen hinzufügen, um Maschinen manuell hinzuzufügen. Das Fenster VMs auswählen wird angezeigt. Erweitern Sie die zuvor erstellte Azure Local-Verbindung und wählen Sie die VMs aus, die Sie hinzufügen möchten. Fügen Sie dann die zugehörigen Maschinenkontonamen hinzu.
    • Maschinen über eine CSV-Datei hinzufügen: Klicken Sie auf Aus CSV-Datei importieren, um Maschinen in großen Mengen hinzuzufügen. Informationen zur Verwendung von CSV-Dateien zum Hinzufügen von Maschinen finden Sie unter Verwenden von CSV-Dateien zum Massenhinzufügen von Maschinen zu einem Katalog.
    1. Befolgen Sie die Anweisungen auf dem Bildschirm, um die restlichen Schritte abzuschließen, die keine Azure Local-spezifischen Informationen enthalten.

  • Katalog mit PowerShell erstellen

  • Sie können einen MCS-Maschinenkatalog in der Azure Local-Umgebung mithilfe von PowerShell-Befehlen erstellen.

Skriptkopf

Stellen Sie sicher, dass Sie die korrekten Parameterwerte angeben, die im Skriptkopf definiert sind.

$catalogName = "" # Name of the catalog you want to create 

$masterImageResourceGroupName = "" # Name of resource group that the master Azure Local VM image resides in  

$catalogResourceGroup = "" # Name of resource group that the created VMs reside in 

$masterImage = "" # Name of the master Azure Local VM image you want to use 

$vNet = "" # Name of the logical network that the created VMs should be attached to 

$masterImagePath = "XDHyp:\HostingUnits\$hostingUnitName\image.folder\$masterImageResourceGroupName.resourcegroup\$masterImage" 

$networkMapping = @{"0"="XDHyp:\HostingUnits\$hostingUnitName\\network.folder\$vNet.network"} 

$customPropertiesXml = "<CustomProperties xmlns=`"http://schemas.citrix.com/2014/xd/machinecreation`" xmlns:xsi=`"http://www.w3.org/2001/XMLSchema-instance`"><Property xsi:type=`"StringProperty`" Name=`"ResourceGroups`" Value=`"$catalogResourceGroup`" /><Property xsi:type=`"StringProperty`" Name=`"OsType`" Value=`"Windows`" /></CustomProperties>" 
<!--NeedCopy-->

MCS-Katalog mit 1 VM erstellen

asnp citrix*

Maschinenkatalog erstellen 
New-BrokerCatalog -AllocationType "Random" -IsRemotePC $false -MinimumFunctionalLevel "L7_34" -Name $catalogName -PersistUserChanges "Discard" -ProvisioningType "MCS" -SessionSupport "SingleSession"
<!--NeedCopy-->
Identitätspool erstellen 
New-AcctIdentityPool -AllowUnicode $true -Domain "test.local" -IdentityPoolName $catalogName -IdentityType "ActiveDirectory" -NamingScheme "demoVM#" -NamingSchemeType "Numeric" -OU "CN=Computers,DC=test,DC=local" 
<!--NeedCopy-->
Bereitstellungsschema erstellen 
New-ProvScheme -CleanOnBoot $true -CustomProperties $customPropertiesXml -HostingUnitName $hostingUnitName -IdentityPoolName $catalogName -MasterImageVM $masterImagePath -NetworkMapping $networkMapping -ProvisioningSchemeName $catalogName -ProvisioningSchemeType "MCS" -VMCpuCount 4 -VMMemoryMB 8192 
<!--NeedCopy-->
Katalog mit Bereitstellungsschema verknüpfen 
$schemeUid =(Get-ProvScheme -ProvisioningSchemeName $catalogName).ProvisioningSchemeUid.Guid 

Set-BrokerCatalog -Name $catalogName -ProvisioningSchemeId $schemeUid 
<!--NeedCopy-->
AD-Konto erstellen 
New-AcctADAccount -Count 1 -IdentityPoolName $catalogName 
<!--NeedCopy-->
VM bereitstellen 
New-ProvVM -ADAccountName "domain\demoVM1" -ProvisioningSchemeName $catalogName 
<!--NeedCopy-->
Maschine zum Broker-Katalog hinzufügen 
New-BrokerMachine -CatalogName $catalogName -MachineName 'domain\demoVM1'
<!--NeedCopy-->

Nächste Schritte

Weitere Informationen

Katalog für Azure Local erstellen
April 7, 2026
Beitrag von: 
C C
April 7, 2026
Beitrag von: 
C 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.