Wie kann ich Probleme mit einem AppStream 2.0-Image Builder beheben, der im Status Pending hängen bleibt?

Lesedauer: 8 Minute

Wenn ich versuche, einen Amazon AppStream 2.0-Image Builder zu starten, verbleibt der Status in Pending und ändert sich nicht zu Running.

Lösung

Es kann bis zu 25 Minuten dauern, bis Image Builder und Flotten-Instances verfügbar sind und in den Status Running wechseln. Wenn sich Ihr Image Builder nach 25 Minuten immer noch im Status Pending befindet, lesen Sie die folgenden häufigen Ursachen und Schritte zur Fehlerbehebung.

Hinweis: Wenn Sie beim Ausführen von Befehlen der AWS Command Line Interface (AWS CLI) Fehler erhalten, stellen Sie sicher, dass Sie die neueste Version der AWS CLI verwenden.

Die Elastic-Netzwerkschnittstelle wurde gelöscht oder getrennt

Eine fehlende Netzwerkschnittstelle kann den Image Builder daran hindern, die Start-Workflows abzuschließen, sodass der Status im Status Pending hängen bleibt.

Um den Status Ihrer Netzwerkschnittstelle zu überprüfen, öffnen Sie die Amazon Elastic Compute Cloud (Amazon EC2)-Konsole und wählen Sie dann Netzwerkschnittstellen aus. Geben Sie alternativ, um die AWS-CLI zu verwenden, den folgenden Befehl ein:

aws ec2 describe-network-interfaces --filters 'Name=description,Values="AppStream 2.0 - image-builder:*"'

Wenn die Netzwerkschnittstelle fehlt oder getrennt ist, starten Sie einen neuen Image Builder vom letzten funktionierenden Image aus. Verwenden Sie alternativ ein von AWS bereitgestelltes Basis-Image.

Hinweis: Sie können in Ihren AWS CloudTrail-Protokollen nach Ereignisdetails im Zusammenhang mit dem Löschen oder Trennen der Netzwerkschnittstelle suchen, einschließlich eventTime und userIdentity.

PowerShell-Richtlinieneinschränkungen

Eine weitere Ursache dafür, dass ein Image Builder im Status Pending hängen bleibt, ist eine zu restriktive PowerShell-Ausführungsrichtlinie. Wenn Sie die Richtlinie vor der Image-Erstellung auf Eingeschränkt setzen, verbleibt der Image Builder im Status Pending. Zusätzlich treten beim nächsten Start Fehler anderer AS2-Ressourcen auf. Dies liegt an der eingeschränkten Richtlinie, die verhindert, dass Skripts wie SSM, Sysprep oder die Reg-Key-Einstellung ausgeführt werden. Sie können stattdessen entweder AllSigned- oder RemoteSigned-Richtlinien verwenden, um dieses Problem zu vermeiden.

Anwendungen, die AppX-Pakete verwenden

Anwendungen, die AppX-Pakete wie Adobe Creative Cloud verwenden, können dazu führen, dass Sysprep fehlschlägt und der Image Builder im Status Pending hängen bleiben.

Führen Sie die folgenden Befehle in PowerShell als Administrator aus, bevor Sie den letzten Schritt der Image-Erstellung abschließen.

Geben Sie den folgenden Befehl ein, um eine Liste der AppX-Pakete auf dem Computer abzurufen:

Get-AppxPackage | select Name, PackageFullName

Um ein bestimmtes AppX-Paket zu entfernen, geben Sie den folgenden Befehl ein. Ersetzen Sie AppXpackageName durch das Paket, das Sie entfernen möchten, wie in der Ausgabe des vorherigen Befehls aufgeführt:

Get-AppxPackage -AllUsers -Name AppXpackageName | Remove-AppxPackage -AllUsers

Hinweis: Der Image Builder muss Server 2019 ausführen. Der Parameter -AllUsers wurde in Build 1709 hinzugefügt. Server 2016 läuft im Image Builder auf Build 1607 und gibt einen Fehler mit dem Parameter -AllUsers zurück.

Weitere Informationen finden Sie unter Get-AppxPackage auf der Microsoft-Website.

Es bestehen Konflikte der Gerätetreiber oder diese sind falsch

Der Image Builder ist mit allen erforderlichen Treibern vorinstalliert. Der Image Builder verbleibt möglicherweise im Status Pending, wenn ein Benutzer im Konflikt stehende oder falsche Treiber installiert.

Da der Image Builder nicht erreichbar ist, ist es nicht möglich, die im Konflikt stehenden oder falschen Treiber zu deinstallieren. Um dieses Problem zu beheben, starten Sie einen neuen Image Builder von einem aktuellen benutzerdefinierten Image aus oder verwenden Sie eines der von Amazon bereitgestellten Basis-Images.

Grenzwerte für Netzwerkschnittstellen

Ihr AWS-Konto hat möglicherweise die Netzwerkschnittstellen-Grenzwerte für die Region erreicht. Weitere Informationen zu Grenzwerten und wie Sie eine Erhöhung beantragen können, finden Sie unter Amazon VPC-Kontingente.

Probleme bei der Anpassung der Sysprep-Antwortdatei

Es hat sich bewährt, die Sysprep Unattend-Antwortdatei nicht anzupassen. Eine falsche Anpassung kann den Windows-Startvorgang beeinträchtigen, da der Image Builder daran gehindert wird, korrekt zu starten und auf dem Willkommensbildschirm hängen bleibt.

Um dieses Problem zu beheben, starten Sie einen neuen Image Builder von einem aktuellen benutzerdefinierten Image aus oder verwenden Sie eines der von Amazon bereitgestellten Basis-Images.

IPv6 ist deaktiviert

Wenn Sie ein Image mit deaktiviertem IPv6 erstellen, verbleibt der Image Builder im Status Pending. Um dieses Problem zu beheben, starten Sie einen neuen Image Builder von einem aktuellen benutzerdefinierten Image aus oder verwenden Sie eines der von Amazon bereitgestellten Basis-Images.

Port-Verfügbarkeit

Stellen Sie sicher, dass keine installierten Anwendungen die folgenden Ports verwenden:

Eingehendes TCP auf Port 8300, um die Streaming-Verbindung herzustellen.
Eingehendes TCP an den Ports 8000 und 8443 für die Verwaltung der Streaming-Instance durch AppStream 2.0.

Weitere Informationen finden Sie unter IP-Adressbereich und Ports der Management-Netzwerkschnittstelle.

Um den Zugriff auf den Amazon EC2-Metadatenservice zu ermöglichen, muss Port 80 (HTTP) für alle Streaming-Instances für die IP-Adresse 169.254.169.254 geöffnet sein. Wenn ein Proxy konfiguriert ist, muss der Proxy 169.254.169.254 ausschließen. Weitere Informationen finden Sie unter Netzwerkschnittstellenports für Kunden.

Ausnahmen für Antivirensoftware

Antivirensoftware kann die Dateien und Ports blockieren, die der Image Builder benötigt. Ziehen Sie in Betracht, Ausnahmen zu den folgenden Ordnerpfaden hinzuzufügen:

%PROGRAMFILES%\Amazon\*
%PROGRAMFILES%\NICE\*
%PROGRAMFILES%\nodejs\*
%PROGRAMFILES%\Internet Explorer\*
C:\Windows\*

Diese Ordnerpfade entsprechen den folgenden Diensten:

AWSLiteAgent
AmazonSSMAgent
Ec2Config
PhotonAgent
PhotonAgentWebServer (überwacht Port 8443)
DcvServer (überwacht Port 8300)
QWAVE

AWS-CLI-Anmeldeinformation als Systemumgebungsvariablen

Das Festlegen von AWS-CLI-Anmeldeinformationen als Systemumgebungsvariablen kann AppStream 2.0 daran hindern, das Image zu erstellen. Anweisungen zum Ändern von Systemumgebungsvariablen in Ihren Flotten-Instances finden Sie unter Ändern von Systemumgebungsvariablen.

Die Standardsprache wurde zu einer nicht unterstützten Sprache geändert

Sie können die regionalen Standardeinstellungen für Ihre AppStream 2.0-Streaming-Sitzungen konfigurieren, einschließlich der Anzeigesprache. Ein Image Builder bleibt in Pending hängen, wenn Sie die Standardsprache in eine Sprache ändern, die nicht unterstützt wird. Informationen zu den Sprachen, die AppStream 2.0 derzeit unterstützt, finden Sie unter Festlegen einer Standardanzeigesprache.

Lokales Administratorkonto gelöscht oder umbenannt

AppStream 2.0 unterstützt das Umbenennen oder Löschen des lokalen Administratorkontos nicht. Wenn Sie dieses Konto umbenennen oder löschen, schlägt die Imageerstellung fehl.

Wenn bei Image Buildern, die einer Domain angehören, das lokale Administratorkonto durch die Gruppenrichtlinie deaktiviert, gelöscht oder umbenannt wird, können Sie das Gruppenrichtlinienobjekt (GPO) aktualisieren.

Wenn das lokale Administratorkonto nicht vom GPO aktualisiert wird, starten Sie einen neuen Image Builder aus einem aktuellen benutzerdefinierten Image. Verwenden Sie alternativ eines der von Amazon bereitgestellten Basis-Images.

Benachrichtigungscodes (mit einer Domain verbundene Image Builder)

Um Benachrichtigungen zu sehen, öffnen Sie die AppStream 2.0-Konsole und wählen Sie dann im Navigationsbereich Images aus. Wählen Sie auf der Registerkarte Image Builder Ihren Image Builder und dann Reiter ** Benachrichtigungen** aus. Weitere Informationen finden Sie unter Problembehandlung bei Benachrichtigungscodes.

DOMAIN_JOIN_ERROR_NO_SUCH_DOMAIN Die Image Builder-Instance kann die Active Directory-Domain nicht kontaktieren. Hierdurch wird verhindert, dass der Image Builder die Start-Workflows abschließt. Um die Netzwerkkonnektivität sicherzustellen, überprüfen Sie Ihre VPC-, Subnetz- und Sicherheitsgruppeneinstellungen. Stellen Sie sicher, dass die VPC-DNS-Server im Abschnitt DHCP-Optionssatz Ihrer VPC korrekt konfiguriert sind. Domainnamenserver sind in der Regel auf die IP-Adressen der Domaincontroller oder DNS-Server eingestellt, die für Ihre Domain verantwortlich sind. Weitere Informationen finden Sie unter DHCP-Optionssätze.
DOMAIN_JOIN_ERROR_FILE_NOT_FOUND Der definierte Name der Organisationseinheit (OU) ist ungültig. AppStream 2.0-Computerobjekte müssen in einer Organisationseinheit platziert werden, und der definierte Name muss mit OU= beginnen. Weitere Informationen finden Sie unter Ermitteln des eindeutigen Namens der Organisationseinheit.

Firewall- und Netzwerkkonfiguration (mit einer Domain verbundene Image Builder)

Bevor Sie mithilfe der AppStream 2.0-Konsole ein Directory Config-Objekt zu Ihrem Image Builder hinzufügen, stellen Sie sicher, dass die Firewall und die Netzwerkkonfiguration korrekt sind. Gehen Sie wie folgt vor.

1.Öffnen Sie in Ihrem Image Builder ein PowerShell-Fenster und führen Sie dann die folgenden Befehle aus:

Test-NetConnection -ComputerName yourdomain.exampleco.com -Port 389 -InformationLevel "Detailed"
Test-NetConnection -ComputerName yourdomain.exampleco.com -Port 88 -InformationLevel "Detailed"
Test-NetConnection -ComputerName yourdomain.exampleco.com -Port 53 -InformationLevel "Detailed"

2.Stellen Sie für die Ausgabe jedes Befehls sicher, dass TcpTestSucceeded den Wert True hat. Dies bedeutet, dass Sie die erforderlichen Ports erreichen können, um der Domain beizutreten. Weitere Informationen finden Sie unter Test-NetConnection auf der Microsoft-Website.

3.Führen Sie im selben PowerShell-Fenster den Befehl Resolve-DnsName aus, um zu bestätigen, dass Sie nach dem Domainnamen suchen können:

Resolve-DnsName -Name yourdomain.exampleco.com

Laden Sie alternativ das PortQryUI-Tool von Microsoft herunter und führen Sie es aus, um alle erforderlichen Ports zu überprüfen.

Neues Computerobjekt wurde nicht erstellt (mit einer Domain verbundene Image Builder)

Überprüfen Sie in Active Directory, ob ein neues Computerobjekt in den richtigen Organisationseinheiten (OUs) erstellt wurde.

Wenn ein neues Objekt vorliegt, wird die Image Builder-Instance in Kürze verfügbar sein.

Wenn das Computerobjekt nicht erstellt wird, verbleibt der Image Builder im Status Pending. Um dieses Problem zu beheben, überprüfen Sie zunächst, ob alle erforderlichen Dienstkontoberechtigungen erteilt wurden. Stellen Sie anschließend sicher, dass die folgenden Verzeichniskonfigurationsdetails in Ihrem AppStream 2.0 Directory Config-Objekt korrekt sind: