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

Einen Azure Local-Katalog erstellen

June 5, 2026
Beitrag von: 
C

Maschinenkataloge erstellen beschreibt die Assistenten, die einen Maschinenkatalog erstellen. 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

Ein Masterimage erstellen

Ein Masterimage ist erforderlich, um einen Maschinenkatalog zu erstellen.

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 zur erstellten Azure Local-VM her, um 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. Diese Aufgabe, eine Aufgabe im Masterimage zu planen, ist nur für VDA-Version 2511 oder früher erforderlich.

    $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 }
<!--NeedCopy-->
  4. Beenden Sie die Azure Local-VM.
  5. Siehe VM-Image aus vorhandener Azure Local-VM erstellen, um ein Azure Local VM-Image aus der vorbereiteten Azure Local-VM zu 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 Imagevorbereitungsprozesses 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 und deaktivieren Sie das Kontrollkästchen für das Attribut 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 Microsoft Azure-reservierten Wörtern im Katalognamen oder im Maschinennamensschema. Weitere Informationen finden Sie im Microsoft-Dokument.

Sie können den Katalog erstellen mit:

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-OS oder Single-Session-OS.
  2. Auf der Seite Maschinenverwaltung:
    1. Wählen Sie Maschinen, die energieverwaltet sind (z. B. virtuelle Maschinen oder Blade-PCs).
    2. Wählen Sie die Bereitstellung von Maschinen mithilfe der Citrix-Bereitstellungstechnologie.
    3. Wählen Sie die Azure Local-Hosting-Einheit 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 Master-Image 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 der Auswahl des Master-Images 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, die jede VM hat.
    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 verbleibenden 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 zur Einrichtung des Maschinenkatalogs:

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

  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 zum Hinzufügen von Maschinen mithilfe von CSV-Dateien finden Sie unter Verwenden von CSV-Dateien zum Massenhinzufügen von Maschinen zu einem Katalog.
  4. Befolgen Sie die Anweisungen auf dem Bildschirm, um die verbleibenden Schritte abzuschließen, die keine Azure Local-spezifischen Informationen enthalten.

Erstellen eines Katalogs mit PowerShell

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

Header des Skripts

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

Erstellen eines MCS-Katalogs mit 1 VM

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

Einen Azure Local-Katalog erstellen
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.