Virtuelle Anzeigen auf einer VM aktivieren


In diesem Dokument wird beschrieben, wie Sie virtuelle Bildschirme auf einer VM-Instanz aktivieren oder deaktivieren.

Wenn für eine Anwendung, die auf Ihrer VM ausgeführt wird, ein Anzeigegerät erforderlich ist, Sie aber nicht die Leistung einer GPU benötigen, konfigurieren Sie Ihre VM so, dass sie virtuelle Anzeigegeräte verwendet. Wenn Sie virtuelle Displays auf einer VM aktivieren, können Sie virtuelle Anzeigegeräte auf der VM ausführen, z. B. Remote-Systemverwaltungstools, Remote-Desktop-Software und Bildschirmaufzeichnungen.

Hinweise

  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud-Dienste und APIs überprüft. Zur Ausführung von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich bei Compute Engine authentifizieren. Wählen Sie dazu eine der folgenden Optionen aus:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command:

      gcloud init
    2. Set a default region and zone.
    3. Terraform

      Wenn Sie die Terraform-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung verwenden möchten, installieren und initialisieren Sie die gcloud CLI und richten dann die Standardanmeldedaten für Anwendungen mit Ihren Nutzeranmeldedaten ein.

      1. Install the Google Cloud CLI.
      2. To initialize the gcloud CLI, run the following command:

        gcloud init
      3. If you're using a local shell, then create local authentication credentials for your user account:

        gcloud auth application-default login

        You don't need to do this if you're using Cloud Shell.

      Weitere Informationen unter Set up authentication for a local development environment.

      REST

      Verwenden Sie die von der gcloud CLI bereitgestellten Anmeldedaten, um die REST API-Beispiele auf dieser Seite in einer lokalen Entwicklungsumgebung zu verwenden.

        Install the Google Cloud CLI, then initialize it by running the following command:

        gcloud init

      Weitere Informationen finden Sie unter Für die Verwendung von REST authentifizieren in der Dokumentation zur Google Cloud-Authentifizierung.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Compute-Instanzadministrator (Version 1) (roles/compute.instanceAdmin.v1) für das Projekt zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Aktivieren oder Deaktivieren virtueller Bildschirme auf einer VM benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierte Rolle enthält die Berechtigungen, die zum Aktivieren oder Deaktivieren virtueller Bildschirme auf einer VM erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um virtuelle Bildschirme auf einer VM zu aktivieren oder zu deaktivieren:

  • So aktivieren oder deaktivieren Sie virtuelle Displays auf einer vorhandenen VM: compute.instances.updateDisplayDevice auf der VM
  • So erstellen Sie eine VM mit aktivierten virtuellen Bildschirmen:
    • compute.instances.create für das Projekt
    • Zur Erstellung der VM mit einem benutzerdefinierten Image: compute.images.useReadOnly für das Image
    • Zur Erstellung der VM mithilfe eines Snapshots: compute.snapshots.useReadOnly für den Snapshot
    • Zur Erstellung der VM mithilfe einer Instanzvorlage: compute.instanceTemplates.useReadOnly für die Instanzvorlage
    • Um der VM ein Legacy-Netzwerk zuzuweisen: compute.networks.use für das Projekt
    • Zum Festlegen einer statische IP-Adresse für die VM: compute.addresses.use für das Projekt
    • Zur Zuweisung einer externen IP-Adresse zur VM bei Verwendung eines Legacy-Netzwerks: compute.networks.useExternalIp für das Projekt
    • Um ein Subnetz für die VM anzugeben: compute.subnetworks.use für das Projekt oder für das ausgewählte Subnetz
    • Um der VM eine externe IP-Adresse zuzuweisen, wenn Sie ein VPC-Netzwerk verwenden: compute.subnetworks.useExternalIp für das Projekt oder für das ausgewählte Subnetz
    • Um die Metadaten der VM-Instanz für die VM festzulegen: compute.instances.setMetadata für das Projekt
    • Um Tags für die VM festzulegen: compute.instances.setTags für die VM
    • Um Labels für die VM festzulegen: compute.instances.setLabels für die VM
    • Um ein Dienstkonto festzulegen, das die VM verwenden soll: compute.instances.setServiceAccount für die VM
    • Um ein neues Laufwerk für die VM zu erstellen: compute.disks.create für das Projekt
    • Um ein vorhandenes Laufwerk im Lese- oder Lese‑/Schreibmodus anzuhängen: compute.disks.use für das Laufwerk
    • Um ein vorhandenes Laufwerk im Lesemodus anzuhängen: compute.disks.useReadOnly für das Laufwerk

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Preise

Für die Aktivierung oder Deaktivierung virtueller Bildschirme auf einer VM fallen keine Kosten an.

Beschränkungen

Für VMs mit aktivierten virtuellen Displays gelten die folgenden Einschränkungen:

  • Wenn auf Ihrer VM ein x64-basiertes Windows-Betriebssystem-Image mit einer älteren Version als v20190312 ausgeführt wird, müssen Sie nach der Aktivierung virtueller Displays auf Ihrer VM den Treiber für virtuelle Displays installieren, wie in diesem Dokument beschrieben. Wenn auf Ihrer VM eine neuere Version des Betriebssystem-Images ausgeführt wird, ist der Treiber bereits auf dem Betriebssystem-Image installiert.

  • Sie können ein virtuelles Anzeigegerät auf der VM erst verwenden, nachdem das Gastbetriebssystem gestartet und den virtuellen Anzeigetreiber initialisiert hat.

  • Virtuelle Anzeigegeräte können nicht auf VMs verwendet werden, auf denen die Sandy Bridge-CPU-Plattform ausgeführt wird.

  • Sie können virtuelle Anzeigegeräte nicht auf T2A-Arm-VMs verwenden.

Virtuelle Anzeigen auf einer VM aktivieren

Wählen Sie eine der folgenden Methoden aus, die in diesem Dokument beschrieben werden, um virtuelle Displays auf einer VM zu aktivieren:

Wenn auf Ihrer VM ein x64-basiertes Windows-Betriebssystem-Image mit einer älteren Version als v20190312 ausgeführt wird, müssen Sie nach dem Aktivieren virtueller Displays auf der VM den Treiber für virtuelle Displays wie in diesem Dokument beschrieben installieren.

VM mit aktivierten virtuellen Displays erstellen

Wählen Sie eine der folgenden Optionen aus, um eine VM mit aktivierten virtuellen Displays zu erstellen:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Instanz erstellen auf.

    Zur Seite „Instanz erstellen“

  2. Geben Sie die Attribute für die VM an, einschließlich Name, Zone und Maschinentyp.

  3. Klicken Sie im Bereich Anzeigegerät das Kästchen Anzeigegerät aktivieren an.

  4. Klicken Sie auf Erstellen, um die VM zu erstellen.

gcloud

Verwenden Sie den Befehl gcloud compute instances create mit dem Flag --enable-display-device, um eine VM mit aktivierten virtuellen Bildschirmen zu erstellen.

gcloud compute instances create VM_NAME \
    --enable-display-device \
    --machine-type=MACHINE_TYPE \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • VM_NAME: der Name der VM.

  • MACHINE_TYPE ist der für die VM zu verwendende Maschinentyp.

  • ZONE: die Zone, in der die VM-Instanz erstellt werden soll.

Terraform

Verwenden Sie die Terraform-Ressource, um eine VM mit aktivierten virtuellen Displays zu erstellen. Legen Sie dabei das Argument enable_display auf true fest.

Wenn Sie beispielsweise eine VM in Zone us-central1-c mit aktivierten virtuellen Bildschirmen erstellen und f1-micro als Maschinentyp angeben möchten, verwenden Sie die folgende Ressource:


resource "google_compute_instance" "instance_virtual_display" {
  name         = "instance-virtual-display"
  machine_type = "f1-micro"
  zone         = "us-central1-c"

  # Set the below to true to enable virtual display
  enable_display = true

  boot_disk {
    initialize_params {
      image = "debian-cloud/debian-11"
    }
  }
  network_interface {
    # A default network is created for all GCP projects
    network = "default"
    access_config {
    }
  }
}

REST

Wenn Sie eine VM mit aktivierten virtuellen Bildschirmen erstellen möchten, senden Sie eine POST-Anfrage an die Methode instances.insert. Geben Sie im Anfragetext das Feld enableDisplay an, das auf true gesetzt ist.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

{
  "name": "VM_NAME",
  "machineType": "zones/ZONE/machineTypes/MACHINE_TYPE",
  "disks": [
    {
      "boot": true,
      "initializeParams": {
        "sourceImage": "project/IMAGE_PROJECT/global/images/IMAGE"
      }
    }
  ],
  "displayDevice": {
    "enableDisplay": true
  },
  "networkInterfaces": [
    {
      "network": "global/networks/default"
    }
  ]
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: ID des Projekts, in dem die VM erstellt werden soll.

  • ZONE: die Zone, in der die VM-Instanz erstellt werden soll.

  • VM_NAME: der Name der VM.

  • MACHINE_TYPE ist der für die VM zu verwendende Maschinentyp.

  • IMAGE_PROJECT: das Image-Projekt, das das Betriebssystem-Image enthält, z. B. debian-cloud. Weitere Informationen zu den unterstützten Image-Projekten finden Sie unter Öffentliche Images.

  • IMAGE: Wählen Sie eine der folgenden Optionen aus:

    • Eine bestimmte Version des Betriebssystem-Images; Beispiel: debian-12-bookworm-v20240617.

    • Eine Image-Familie, die als family/IMAGE_FAMILY formatiert sein muss. Damit wird das neueste nicht verworfene Betriebssystem-Image angegeben. Beispiel: Wenn Sie family/debian-12 angeben, wird die aktuelle Version in der Debian 12-Image-Familie verwendet. Weitere Informationen zur Verwendung von Image-Familien finden Sie unter Best Practices für Image-Familien.

Weitere Informationen zum Erstellen einer VM finden Sie unter Compute Engine-Instanz erstellen und starten.

Virtuelle Anzeigen auf einer vorhandenen VM aktivieren

Bevor Sie virtuelle Displays auf einer VM aktivieren, müssen Sie die VM beenden.

Wählen Sie eine der folgenden Optionen aus, um virtuelle Displays auf einer vorhandenen VM zu aktivieren:

Console

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zur Seite „VM-Instanzen"

  2. Klicken Sie in der Spalte Name auf den Namen der VM.

    Die Detailseite der VM wird geöffnet.

  3. Klicken Sie auf  Bearbeiten.

    Die Seite zum Bearbeiten der VM-Eigenschaften wird geöffnet.

  4. Klicken Sie im Bereich Anzeigegerät das Kästchen Anzeigegerät aktivieren an.

  5. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud compute instances update mit dem Flag --enable-display-device, um virtuelle Displays auf einer vorhandenen VM zu aktivieren.

gcloud compute instances update VM_NAME \
    --enable-display-device \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • VM_NAME: der Name der VM.

  • ZONE ist die Zone, in der sich die VM befindet.

REST

Wenn Sie virtuelle Displays auf einer vorhandenen VM aktivieren möchten, senden Sie eine POST-Anfrage an die Methode instances.updateDisplayDevice. Fügen Sie im Anfragetext das Feld enableDisplay ein und setzen Sie es auf true.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/updateDisplayDevice

{
  "enableDisplay": true
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Projekts, in dem sich die VM befindet.

  • ZONE ist die Zone, in der sich die VM befindet.

  • VM_NAME: der Name der VM.

Virtuelle Displays auf einer vorhandenen VM deaktivieren

Bevor Sie virtuelle Displays auf einer VM deaktivieren, müssen Sie die VM beenden.

Wählen Sie eine der folgenden Optionen aus, um virtuelle Displays auf einer vorhandenen VM zu deaktivieren:

Console

  1. Rufen Sie in der Google Cloud Console die Seite VM-Instanzen auf.

    Zur Seite „VM-Instanzen"

  2. Klicken Sie in der Spalte Name auf den Namen der VM.

    Die Detailseite der VM wird geöffnet.

  3. Klicken Sie auf  Bearbeiten.

    Die Seite zum Bearbeiten der VM-Eigenschaften wird geöffnet.

  4. Entfernen Sie im Bereich Anzeigegerät das Häkchen bei Anzeigegerät aktivieren.

  5. Klicken Sie auf Speichern.

gcloud

Verwenden Sie den Befehl gcloud compute instances update mit dem Flag --no-enable-display-device, um virtuelle Displays auf einer vorhandenen VM zu deaktivieren.

gcloud compute instances update VM_NAME \
    --no-enable-display-device \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • VM_NAME: der Name der VM.

  • ZONE ist die Zone, in der sich die VM befindet.

REST

Wenn Sie virtuelle Displays auf einer vorhandenen VM deaktivieren möchten, senden Sie eine POST-Anfrage an die Methode instances.updateDisplayDevice. Fügen Sie im Anfragetext das Feld enableDisplay ein und legen Sie es auf false fest.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/updateDisplayDevice

{
  "enableDisplay": false
}

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Projekts, in dem sich die VM befindet.

  • ZONE ist die Zone, in der sich die VM befindet.

  • VM_NAME: der Name der VM.

Treiber für die virtuelle Anzeige installieren

Wenn Sie virtuelle Displays auf einer Windows-VM aktiviert haben, auf der ein Windows-Betriebssystem-Image früher als Version v20190312 ausgeführt wird, müssen Sie den von Google Cloud bereitgestellten virtuellen Anzeigetreiber installieren, um ein virtuelles Anzeigegerät auf der VM zu verwenden. Wenn auf der VM eine neuere Betriebssystem-Imageversion ausgeführt wird, ist der Treiber bereits installiert und Sie können diesen Abschnitt überspringen.

So installieren Sie den Treiber für virtuelle Anzeigen auf einer VM, auf der virtuelle Anzeigen aktiviert sind:

  1. Stellen Sie eine Verbindung zur Windows-VM her.

  2. Öffnen Sie ein PowerShell-Terminal als Administrator.

  3. Installieren Sie die Komponente google-compute-engine-driver-gga:

    googet install google-compute-engine-driver-gga
    
  4. Starten Sie die VM neu.

Nachdem Sie die VM neu gestartet haben, können Sie wie im nächsten Abschnitt beschrieben prüfen, ob der Treiber ordnungsgemäß installiert wurde.

Installation des Treibers für virtuelle Anzeigen prüfen

Wenn Sie den Treiber für virtuelle Anzeigen wie im vorherigen Abschnitt beschrieben manuell auf einer Windows-VM installieren mussten, können Sie so prüfen, ob die Installation erfolgreich war:

  1. Stellen Sie eine Verbindung zur Windows-VM her, falls Sie dies noch nicht getan haben.

  2. Öffnen Sie den Gerätemanager.

  3. Prüfen Sie im Gerätemanager in der Liste Displayadapter, ob der Treiber „Google Graphics Array“ (GGA) aufgeführt ist.

    Wenn der Treiber nicht aufgeführt ist, installieren Sie den virtuellen Anzeigetreiber neu, wie in diesem Dokument beschrieben.

Nächste Schritte