Befehlszeilenoberfläche

Mit der xe CLI können Sie Systemadministrationsaufgaben skripten und automatisieren. Verwenden Sie die CLI, um Citrix Hypervisor in eine vorhandene IT-Infrastruktur zu integrieren.

Erste Schritte mit der Xe-CLI

Die xe-Befehlszeilenschnittstelle ist standardmäßig auf allen Citrix Hypervisor-Servern installiert. Eine Remote-Windows-Version ist in XenCenter enthalten. Eine eigenständige Remote-CLI ist auch für Linux verfügbar.

Auf Ihrem Citrix Hypervisor-Server

Die xe-Befehlszeilenschnittstelle ist standardmäßig auf Ihrem Server installiert. Sie können Xe-CLI-Befehle in der dom0-Konsole ausführen. Greifen Sie auf eine der folgenden Arten auf die dom0-Konsole zu:

• Gehen Sie in XenCenter zur Registerkarte Konsole für den Server, auf dem Sie den Befehl ausführen möchten.
• SSH zu dem Server, auf dem Sie den Befehl ausführen möchten.

Unter Windows

Unter Windows wird der Befehl xe.exe zusammen mit XenCenter installiert.

Um den Befehl xe.exe zu verwenden, öffnen Sie eine Windows-Eingabeaufforderung und wechseln Sie in das Verzeichnis, in dem die Datei xe.exe ist (normalerweise C:\Program Files (x86)\Citrix\XenCenter). Wenn Sie das Installationsverzeichnis von xe.exe zu Ihrem Systempfad hinzufügen, können Sie den Befehl verwenden, ohne in das Verzeichnis wechseln zu müssen.

Unter Linux

Auf RPM-basierten Distributionen (wie Red Hat) können Sie den eigenständigen xe-Befehl aus RPM client_install/xapi-xe-BUILD.x86_64.rpm installieren, das auf dem Citrix Hypervisor-Hauptinstallations-ISO-Image angegeben ist.

Verwenden Sie den folgenden Befehl, um vom RPM aus zu installieren:

rpm -ivh xapi-xe-BUILD.x86_64.rpm
<!--NeedCopy-->

Sie können Parameter in der Befehlszeile verwenden, um den Citrix Hypervisor-Server, den Benutzernamen und das Kennwort zu definieren, die beim Ausführen von xe-Befehlen verwendet werden sollen. Sie haben jedoch auch die Möglichkeit, diese Informationen als Umgebungsvariable festzulegen. Beispiel:

export XE_EXTRA_ARGS="server=<host name>,username=<user name>,password=<password>"
<!--NeedCopy-->

Hinweis:

Die Remote-XE-CLI unter Linux hängt möglicherweise beim Versuch, Befehle über eine sichere Verbindung auszuführen, und diese Befehle beinhalten die Dateiübertragung. In diesem Fall können Sie den Parameter --no-ssl verwenden, um den Befehl über eine unsichere Verbindung zum Citrix Hypervisor-Server auszuführen.

Hilfe mit xe-Befehlen erhalten

Grundlegende Hilfe für CLI-Befehle auf dem Host ist verfügbar, indem Sie Folgendes eingeben:

xe help command
<!--NeedCopy-->

Eine Liste der am häufigsten verwendeten xe-Befehle wird angezeigt, wenn Sie Folgendes eingeben:

xe help
<!--NeedCopy-->

Oder es wird eine Liste aller xe-Befehle angezeigt, wenn Sie Folgendes eingeben:

xe help --all
<!--NeedCopy-->

Grundlegende xe-Syntax

Die grundlegende Syntax aller Citrix Hypervisor xe CLI-Befehle lautet:

xe command-name argument=value argument=value
<!--NeedCopy-->

Jeder spezifische Befehl enthält seine eigenen Argumente, die das Format argument=value haben. Für einige Befehle sind Argumente erforderlich, und die meisten haben einige optionale Argumente. In der Regel geht ein Befehl von Standardwerten für einige der optionalen Argumente aus, wenn er ohne sie aufgerufen wird.

Wenn der xe-Befehl remote ausgeführt wird, werden zusätzliche Argumente für die Verbindung und Authentifizierung verwendet. Diese Argumente haben auch das Format argument=argument_value.

Das Argument server wird verwendet, um den Hostnamen oder die IP-Adresse anzugeben. Die Argumente username und password werden verwendet, um Anmeldeinformationen anzugeben.

Anstelle des Kennworts kann direkt ein Argument password-file angegeben werden. In diesem Fall versucht der xe-Befehl, das Kennwort aus der angegebenen Datei zu lesen, und verwendet dieses Kennwort, um eine Verbindung herzustellen. (Alle nachfolgenden CRs und LFs am Ende der Datei werden entfernt.) Diese Methode ist sicherer als die Angabe des Kennworts direkt in der Befehlszeile.

Das optionale port-Argument kann verwendet werden, um den Agentport auf dem Citrix Hypervisor-Remoteserver anzugeben (standardmäßig 443).

Beispiel: Auf dem lokalen Citrix Hypervisor-Server:

xe vm-list
<!--NeedCopy-->

Beispiel: Auf einem Citrix Hypervisor-Remoteserver:

xe vm-list username=username password=password server=hostname
<!--NeedCopy-->

Die Kurzschriftsyntax ist auch für Argumente für Remoteverbindungen verfügbar:

• -u user name
• -pw password
• -pwf password file
• -p Port
• -s server

Beispiel: Auf einem Citrix Hypervisor-Remoteserver:

xe vm-list -u myuser -pw mypassword -s hostname
<!--NeedCopy-->

Argumente werden auch aus der Umgebungsvariablen XE_EXTRA_ARGS in Form von kommagetrennten Schlüssel/Wert-Paaren übernommen. Um beispielsweise Befehle einzugeben, die auf einem Citrix Hypervisor-Remoteserver ausgeführt werden, führen Sie zuerst den folgenden Befehl aus:

export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"
<!--NeedCopy-->

Nachdem Sie diesen Befehl ausgeführt haben, müssen Sie die Citrix Hypervisor-Remoteserverparameter nicht mehr in jedem XE-Befehl angeben, den Sie ausführen.

Die Verwendung der Umgebungsvariablen XE_EXTRA_ARGS ermöglicht auch die Tab-Vervollständigung von xe-Befehlen, wenn sie für einen Citrix Hypervisor-Remoteserver ausgegeben werden, der standardmäßig deaktiviert ist.

Sonderzeichen und Syntax

Um Argument-/Wertepaare in der xe-Befehlszeile anzugeben, schreiben Sie: argument=value

Verwenden Sie keine Anführungszeichen, sofern der Wert keine Leerzeichen enthält. Fügen Sie keine Leerzeichen zwischen dem Argumentnamen, dem Gleichheitszeichen (=) und dem Wert ein. Jedes Argument, das diesem Format nicht entspricht, wird ignoriert.

Für Werte, die Leerzeichen enthalten, schreiben Sie: argument="value with spaces"

Wenn Sie die CLI auf Ihrem Citrix Hypervisor-Server verwenden, verfügen Befehle über eine Funktion zur Tab-Vervollständigung, die der Funktion in der Standard-Linux-Bash-Shell ähnelt. Wenn Sie beispielsweise xe vm-l eingeben und dann die TAB-Taste drücken, wird der Rest des Befehls angezeigt. Wenn mehrere Befehle mit vm-l beginnen, werden durch erneutes Drücken der Tabulatortaste die Möglichkeiten aufgelistet. Diese Funktion ist nützlich, wenn Objekt-UUIDs in Befehlen angegeben werden

Hinweis:

Die Tab-Vervollständigung funktioniert normalerweise nicht, wenn Befehle auf einem Citrix Hypervisor-Remoteserver ausgeführt werden. Wenn Sie jedoch die Variable XE_EXTRA_ARGS auf dem Computer festlegen, auf dem Sie die Befehle eingeben, ist die Tab-Vervollständigung aktiviert. Weitere Informationen finden Sie unter Grundlegende XE-Syntax.

Befehlstypen

Die CLI-Befehle können in zwei Hälften aufgeteilt werden. Befehle auf niedriger Ebene befassen sich mit dem Auflisten und der Parametermanipulation von API-Objekten. Befehle auf höherer Ebene werden verwendet, um mit VMs oder Hosts auf einer abstrakteren Ebene zu interagieren.

Die Befehle auf niedriger Ebene sind:

• class-list

• class-param-get

• class-param-set

• class-param-list

• class-param-add

• class-param-remove

• class-param-clear

Dabei ist class eine dieser Optionen:

• bond

• console

• host

• host-crashdump

• host-cpu

• network

• patch

• pbd

• pif

• pool

• sm

• sr

• task

• template

• vbd

• vdi

• vif

• vlan

• vm

Nicht jeder Wert von class hat den vollständigen Satz von Befehlen für class-param-action. Einige Werte von class haben einen kleineren Befehlssatz.

Typen von Parametern

Die Objekte, die mit den xe-Befehlen angesprochen werden, haben Parametersätze, die sie identifizieren und ihre Zustände definieren.

Die meisten Parameter nehmen einen einzigen Wert an. Beispielsweise enthält der Parameter name-label einer VM einen einzelnen Zeichenfolgenwert. In der Ausgabe von Befehlen der Parameterliste gibt ein Wert in Klammern - z. B. xe vm-param-list - an, ob es sich bei den Parametern um Lese-/Schreibzugriff (RW) oder schreibgeschützt (RO) handelt. Die Ausgabe von xe vm-param-list auf einer angegebenen VM kann die folgenden Zeilen haben:

user-version ( RW): 1
 is-control-domain ( RO): false

Der erste Parameter ist beschreibbar und hat den Wert 1. user-version Die zweite, is-control-domain, ist schreibgeschützt und hat den Wert false.

Die beiden anderen Arten von Parametern sind mehrwertig. Ein eingestellter Parameter enthält eine Liste von Werten. Ein Map-Parameter ist ein Satz von Schlüssel/Wert-Paaren. Sehen Sie sich als Beispiel die folgende Beispielausgabe von xe vm-param-list auf einer bestimmten VM an:

platform (MRW): acpi: true; apic: true; pae: true; nx: false
allowed-operations (SRO): pause; clean_shutdown; clean_reboot; \
hard_shutdown; hard_reboot; suspend

Der Parameter platform enthält eine Liste von Elementen, die Schlüssel/Wert-Paare darstellen. Auf die Schlüsselnamen folgt ein Doppelpunkt (:). Jedes Schlüssel/Wert-Paar ist durch ein Semikolon (;) vom nächsten getrennt. Das M vor dem RW zeigt an, dass dieser Parameter ein Map-Parameter ist und lesbar und beschreibbar ist. Der Parameter allowed-operations hat eine Liste, die aus einer Reihe von Elementen besteht. Das S vor dem RO zeigt an, dass dies ein festgelegter Parameter ist und lesbar, aber nicht beschreibbar ist.

Um nach einem Map-Parameter zu filtern oder einen Map-Parameter festzulegen, verwenden Sie einen Doppelpunkt (:), um den Map-Parameternamen und das Schlüssel/Wert-Paar zu trennen. Um beispielsweise den Wert des Schlüssels foo des Parameters other-config einer VM auf baa festzulegen, lautet der Befehl

xe vm-param-set uuid=VM uuid other-config:foo=baa
<!--NeedCopy-->

Parameter-Befehle auf niedriger Ebene

Es gibt mehrere Befehle für die Bedienung von Parametern von Objekten: class-param-get, class-param-set, class-param-add, class-param-remove, class-param-clear, and class-param-list. Jeder dieser Befehle benötigt einen Parameter uuid, um das bestimmte Objekt anzugeben. Da diese Befehle als Befehle auf niedriger Ebene betrachtet werden, müssen sie die UUID und nicht die VM-Namensbezeichnung verwenden.

• xe class-param-list uuid=uuid

  Listet alle Parameter und die zugehörigen Werte auf. Im Gegensatz zum Befehl class-list listet dieser Befehl die Werte von “teuren” Feldern auf.

• xe class-param-get uuid=uuid param-name=parameter param-key=key

  Gibt den Wert eines bestimmten Parameters zurück. Bei einem Map-Parameter wird durch Angabe des Parameter-Schlüssels der Wert abgerufen, der diesem Schlüssel in der Map zugeordnet ist. Wenn param-key nicht angegeben ist oder wenn der Parameter eine Menge ist, gibt der Befehl eine Zeichenfolgendarstellung des Satzes oder der Zuordnung zurück.

• xe class-param-set uuid=uuid param=value

  Setzt den Wert eines oder mehrerer Parameter.

• xe class-param-add uuid=uuid param-name=parameter key=value param-key=key

  Fügt entweder zu einer Map oder einem festgelegten Parameter hinzu. Fügen Sie für einen Map-Parameter Schlüssel/Wert-Paare hinzu, indem Sie die Schlüssel=Wert-Syntax verwenden. Wenn der Parameter ein Satz ist, fügen Sie Schlüssel mit der param-key=key-Syntax hinzu.

• xe class-param-remove uuid=uuid param-name=parameter param-key=key

  Entfernt entweder ein Schlüssel/Wert-Paar aus einer Map oder einen Schlüssel aus einer Menge.

• xe class-param-clear uuid=uuid param-name=parameter

  Löscht einen Satz oder eine Map vollständig.

Listenbefehle auf niedriger Ebene

Der Befehl class-list listet die Objekte vom Typ classauf. Standardmäßig listet dieser Befehlstyp alle Objekte auf und druckt eine Teilmenge der Parameter. Dieses Verhalten kann auf folgende Weise geändert werden:

• Es kann die Objekte so filtern, dass es nur eine Teilmenge ausgibt
• Die gedruckten Parameter können geändert werden.

Um die gedruckten Parameter zu ändern, geben Sie das Argument params als kommagetrennte Liste der erforderlichen Parameter an. Beispiel:

xe vm-list params=name-label,other-config
<!--NeedCopy-->

Um alle Parameter aufzulisten, verwenden Sie alternativ die Syntax:

xe vm-list params=all
<!--NeedCopy-->

Der Befehl list zeigt einige Parameter nicht an, deren Berechnung teuer ist. Diese Parameter werden beispielsweise wie folgt dargestellt:

allowed-VBD-devices (SRO): <expensive field>
<!--NeedCopy-->

Um diese Felder zu erhalten, verwenden Sie entweder die Befehlsklasse-param-list oder die Klasse-param-get

Um die Liste zu filtern, gleicht die CLI Parameterwerte mit den in der Befehlszeile angegebenen Werten ab und druckt nur Objekte, die allen angegebenen Einschränkungen entsprechen. Beispiel:

xe vm-list HVM-boot-policy="BIOS order" power-state=halted
<!--NeedCopy-->

Dieser Befehl listet nur die VMs auf, für die sowohl das Feld power-state den Wert halted hat als auch das Feld HVM-boot-policy den Wert BIOS order.

Sie können die Liste auch nach dem Wert von Schlüsseln in Maps oder nach dem Vorhandensein von Werten in einer Menge filtern. Die Syntax für das Filtern basierend auf Schlüsseln in Maps ist map-name:key=value. Die Syntax für das Filtern basierend auf Werten, die in einer Menge vorhanden sind, lautet set-name:contains=value.

Beim Scripting ist es eine nützliche Technik, --minimal an die Befehlszeile zu übergeben, wodurch xe nur das erste Feld in einer kommagetrennten Liste druckt. Beispielsweise gibt der Befehl xe vm-list --minimal auf einem Host mit drei installierten VMs die drei UUIDs der VMs an:

    a85d6717-7264-d00e-069b-3b1d19d56ad9,aaa3eec5-9499-bcf3-4c03-af10baea96b7, \
    42c044de-df69-4b30-89d9-2c199564581d
<!--NeedCopy-->

Secrets

Citrix Hypervisor bietet einen geheimen Mechanismus, um zu verhindern, dass Kennwörter im Befehlszeilenverlauf oder auf API-Objekten im Klartext gespeichert werden. XenCenter verwendet diese Funktion automatisch und kann auch über die xe CLI für jeden Befehl verwendet werden, der ein Kennwort erfordert.

Hinweis:

Kennwortgeheimnisse können nicht verwendet werden, um sich mit einem Citrix Hypervisor Host von einer Remote-Instanz der xe CLI aus zu authentifizieren.

Um ein geheimes Objekt zu erstellen, führen Sie den folgenden Befehl auf Ihrem Citrix Hypervisor-Host aus.

xe secret-create value=my-password
<!--NeedCopy-->

Ein Secret wird erstellt und auf dem Citrix Hypervisor Host gespeichert. Der Befehl gibt die UUID des geheimen Objekts aus. Beispiel: 99945d96-5890-de2a-3899-8c04ef2521db. Fügen Sie _secret an den Namen des Kennwortarguments an, um diese UUID an einen Befehl zu übergeben, der ein Kennwort erfordert.

Beispiel: Auf dem Citrix Hypervisor Host, auf dem Sie das Secret erstellt haben, können Sie den folgenden Befehl ausführen:

    xe sr-create device-config:location=sr_address device-config:type=cifs device-config:username=cifs_username  \
    device-config:cifspassword_secret=secret_uuid name-label="CIFS ISO SR" type="iso" content-type="iso" shared="true"
<!--NeedCopy-->

Befehlsverlauf

Einige XE-Befehle, zum Beispiel xe vm-migrate oder xe pool-enable-external-auth, nehmen Secrets wie Kennwörter als Parameter. Diese können im Shell-Verlauf enden und sind während der Ausführung des Befehls in der Prozesstabelle sichtbar. Es ist daher wichtig, diese Befehle nur in vertrauenswürdigen Umgebungen auszuführen.

Für die Bash-Shell können Sie die Variable HISTCONTROL verwenden, um zu steuern, welche Befehle im Shell-Verlauf gespeichert werden.

xe-Befehlsreferenz

In diesem Abschnitt werden die Befehle nach den Objekten gruppiert, die der Befehl adressiert. Diese Objekte sind alphabetisch aufgelistet.

Appliance-Befehle

Befehle zum Erstellen und Ändern von VM-Appliances (auch bekannt als vApps). Weitere Informationen finden Sie unter vApps.

Geräte-Parameter

Appliance-Befehle haben die folgenden Parameter:

appliance-assert-can-be-recovered

xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Testet, ob Speicher zur Wiederherstellung dieser VM Appliance/vApp verfügbar ist.

appliance-create

xe appliance-create name-label=name-label [name-description=name-description]
<!--NeedCopy-->

Erstellt eine Appliance/vApp. Beispiel:

xe appliance-create name-label=my_appliance
<!--NeedCopy-->

Hinzufügen von virtuellen Rechnern zur Appliance:

xe vm-param-set uuid=VM-UUID appliance=appliance-uuid
<!--NeedCopy-->

appliance-destroy

xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->

Zerstört ein Gerät/eine vApp. Beispiel:

xe appliance-destroy uuid=appliance-uuid
<!--NeedCopy-->

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]
<!--NeedCopy-->

Stellen Sie eine VM Appliance/vApp aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.

appliance-shutdown

xe appliance-shutdown uuid=appliance-uuid [force=true|false]
<!--NeedCopy-->

Schließt alle virtuellen Maschinen in einer Appliance/vApp herunter. Beispiel:

xe appliance-shutdown uuid=appliance-uuid
<!--NeedCopy-->

appliance-start

xe appliance-start uuid=appliance-uuid [paused=true|false]
<!--NeedCopy-->

Startet eine Appliance/vApp. Beispiel:

xe appliance-start uuid=appliance-uuid
<!--NeedCopy-->

Befehle für die Prüfung

Mit Überwachungsbefehlen werden alle verfügbaren Datensätze der RBAC-Überwachungsdatei im Pool heruntergeladen. Wenn der optionale Parameter since vorhanden ist, werden nur die Datensätze von diesem bestimmten Zeitpunkt heruntergeladen.

audit-log-get-Parameter

audit-log-get hat die folgenden Parameter

audit-log-get

xe audit-log-get [since=timestamp] filename=filename
<!--NeedCopy-->

Um beispielsweise Überwachungsaufzeichnungen des Pools seit einem genauen Millisekunden-Zeitstempel abzurufen, führen Sie den folgenden Befehl aus:

Führen Sie den folgenden Befehl aus:

xe audit-log-get since=2009-09-24T17:56:20.530Z filename=/tmp/auditlog-pool-actions.out
<!--NeedCopy-->

Bonding-Befehle

Befehle für die Arbeit mit Netzwerkbindungen, für Ausfallsicherheit bei Failover für physische Schnittstellen. Weitere Informationen finden Sie unter Netzwerk.

Das Bond-Objekt ist ein Referenzobjekt, das Master- und Member-PIFs miteinander verbindet. Der Master-PIF ist das Bonding-Interface, das als Gesamt-PIF verwendet werden muss, um sich auf die Bindung zu beziehen. Die Mitglied-PIFs sind ein Satz von zwei oder mehr physikalischen Schnittstellen, die zu der gebundenen High-Level-Schnittstelle kombiniert wurden.

Bond-Parameter

Bonds haben die folgenden Parameter:

bond-create

xe bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...
<!--NeedCopy-->

Erstellen Sie eine gebundene Netzwerkschnittstelle in dem Netzwerk, das aus einer Liste vorhandener PIF-Objekte angegeben ist. Der Befehl schlägt in einem der folgenden Fälle fehl:

• Wenn PIFs bereits in einer anderen Bindung sind
• Wenn bei einem Mitglied ein VLAN-Tag festgelegt ist
• Wenn sich die referenzierten PIFs nicht auf demselben Citrix Hypervisor-Server befinden
• Wenn weniger als 2 PIFs geliefert werden

bond-destroy

xe bond-destroy uuid=bond_uuid
<!--NeedCopy-->

Löscht eine gebundene Schnittstelle, die durch ihre UUID angegeben ist, von einem Host.

bond-set-mode

xe bond-set-mode uuid=bond_uuid mode=bond_mode
<!--NeedCopy-->

Ändern Sie den Bond-Modus.

CD-Befehle

Befehle zum Arbeiten mit physischen CD/DVD-Laufwerken auf Citrix Hypervisor-Servern.

CD-Parameter

CDs haben folgende Parameter:

cd-list

xe cd-list [params=param1,param2,...] [parameter=parameter_value]
<!--NeedCopy-->

Listen Sie die CDs und ISOs (CD-Image-Dateien) auf dem Citrix Hypervisor-Server oder -Pool auf und filtern Sie nach dem optionalen Argument params.

Wenn das optionale Argument params verwendet wird, ist der Wert von params eine Zeichenfolge, die eine Liste von Parametern dieses Objekts enthält, die Sie anzeigen möchten. Alternativ können Sie das Schlüsselwort verwenden all, um alle Parameter anzuzeigen. Wenn params nicht verwendet wird, zeigt die zurückgegebene Liste eine Standard-Teilmenge aller verfügbaren Parameter an.

Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten CD-Parameter sein.

Cluster-Befehle

Befehle zum Arbeiten mit Clusterpools.

Clusterpools sind Ressourcenpools, für die die Clustering-Funktion aktiviert ist. Verwenden Sie diese Pools mit GFS2-SRs. Weitere Informationen finden Sie unter Clustered-Pools.

Die Cluster- und Clusterhost-Objekte können mit den Befehlen zur Standardobjektauflistung (xe cluster-list und xe cluster-host-list) und den mit den Standardparameterbefehlen manipulierten Parametern aufgeführt werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene. Befehle zum Arbeiten mit Clusterpools.

Cluster-Parameter

Cluster haben die folgenden Parameter:

cluster-host-destroy

xe cluster-host-destroy uuid=host_uuid
<!--NeedCopy-->

Zerstören Sie einen Clusterhost und verlassen Sie effektiv den Cluster.

cluster-host-disable

xe cluster-host-disable uuid=cluster_uuid
<!--NeedCopy-->

Deaktivieren der Clustermitgliedschaft für einen aktivierten Clusterhost.

cluster-host-enable

xe cluster-host-enable uuid=cluster_uuid
<!--NeedCopy-->

Aktivieren der Clustermitgliedschaft für einen deaktivierten Clusterhost

cluster-host-force-destroy

xe cluster-host-force-destroy uuid=cluster_host
<!--NeedCopy-->

Zerstören Sie ein Clusterhostobjekt mit Nachdruck und verlassen Sie effektiv den Cluster

cluster-pool-create

xe cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]
<!--NeedCopy-->

Erstellen Sie einen poolweiten Cluster.

cluster-pool-destroy

xe cluster-pool-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->

Zerstört den poolweiten Cluster. Der Pool ist weiterhin vorhanden, aber er ist nicht mehr geclustert und kann keine GFS2-SRs mehr verwenden.

cluster-pool-force-destroy

xe cluster-pool-force-destroy cluster-uuid=cluster_uuid
<!--NeedCopy-->

Erzwingen der Zerstörung des poolweiten Clusters.

cluster-pool-resync

xe cluster-pool-resync cluster-uuid=cluster_uuid
<!--NeedCopy-->

Synchronisieren Sie einen Cluster in einem Pool neu.

Befehle für die Konsole

Befehle zum Arbeiten mit Konsolen.

Die Konsolenobjekte können mit dem Standardbefehl für die Objektauflistung (xe console-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene.

Konsolen-Parameter

Konsolen haben die folgenden Parameter:

console

xe console
<!--NeedCopy-->

An einer bestimmten Konsole befestigen.

Diagnostische Befehle

Befehle zum Sammeln von Diagnoseinformationen von Citrix Hypervisor.

diagnostic-compact

xe diagnostic-compact
<!--NeedCopy-->

Führen Sie eine größere GC-Sammlung und Heap-Verdichtung durch.

VERALTET: diagnostic-db-log

xe diagnostic-db-log
<!--NeedCopy-->

Protokollieren Sie die Datenbankoperationen. Warnung: Einmal gestartet, kann dies nicht gestoppt werden.

diagnostic-db-stats

xe diagnostic-db-stats
<!--NeedCopy-->

Druckt Datenbankstatistiken.

diagnostic-gc-stats

xe diagnostic-gc-stats
<!--NeedCopy-->

GC-Statistiken drucken.

diagnostic-license-status

xe diagnostic-license-status
<!--NeedCopy-->

Hilft bei der Diagnose von poolweiten Lizenzproblemen.

diagnostic-net-stats

xe diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]
<!--NeedCopy-->

Netzwerkstatistiken drucken.

diagnostic-timing-stats

xe diagnostic-timing-stats
<!--NeedCopy-->

Timing-Statistiken drucken.

diagnostic-vdi-status

xe diagnostic-vdi-status uuid=vdi_uuid
<!--NeedCopy-->

Fragen Sie den Sperr- und Freigabestatus eines VDI ab.

diagnostic-vm-status

xe diagnostic-vm-status uuid=vm_uuid
<!--NeedCopy-->

Fragen Sie die Hosts ab, auf denen die VM booten kann, und überprüfen Sie den Freigabe-/Sperrstatus aller VBDs.

Befehle zur Notfallwiederherstellung

Befehle zum Wiederherstellen von virtuellen Rechnern nach einer Katastrophe

drtask-create

xe drtask-create type=type sr-whitelist=sr-white-list device-config=device-config
<!--NeedCopy-->

Erstellt eine Disaster Recovery-Aufgabe. Um beispielsweise eine Verbindung zu einem iSCSI-SR in Vorbereitung auf die Notfallwiederherstellung herzustellen:

xe drtask-create type=lvmoiscsi device-config:target=target-ip-address \
    device-config:targetIQN=targetIQN device-config:SCSIid=SCSIid \
    sr-whitelist=sr-uuid-list
<!--NeedCopy-->

Hinweis:

Der Befehl sr-whitelist listet erlaubte SR-UUIDs auf. Der Befehl drtask-create führt nur ein SR ein und stellt eine Verbindung dazu her, das eine der zulässigen UUIDs hat

drtask-destroy

xe drtask-destroy uuid=dr-task-uuid
<!--NeedCopy-->

Zerstört eine Disaster Recovery-Aufgabe und vergisst das eingeführte SR.

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Testet, ob Speicher für die Wiederherstellung dieser VM verfügbar ist.

appliance-assert-can-be-recovered

xe appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Überprüft, ob der Speicher (der die Appliance-/vApp-Disk enthält) sichtbar ist.

appliance-recover

xe appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->

Stellen Sie eine Appliance/vApp aus der Datenbank wieder her, die im mitgelieferten VDI enthalten ist.

vm-recover

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]
<!--NeedCopy-->

Stellt eine VM aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->

Ermöglicht die XAPI-Datenbankreplikation auf das angegebene (gemeinsame) SR.

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->

Deaktiviert die XAPI-Datenbankreplikation auf das angegebene SR.

Beispiel Verwendung

Das folgende Beispiel zeigt die DR CLI-Befehle im Kontext:

Aktivieren Sie am primären Standort die Datenbankreplikation:

xe sr-database-replication uuid=sr=uuid
<!--NeedCopy-->

Stellen Sie nach einer Katastrophe am sekundären Standort eine Verbindung zum SR her. Der Befehl device-config hat dieselben Felder wie sr-probe.

xe drtask-create type=lvmoiscsi \
    device-config:target=target ip address \
    device-config:targetIQN=target-iqn \
    device-config:SCSIid=scsi-id \
    sr-whitelist=sr-uuid
<!--NeedCopy-->

Suchen Sie in dem SR nach Datenbank-VDIs:

xe vdi-list sr-uuid=sr-uuid type=Metadata
<!--NeedCopy-->

Abfrage eines Datenbank-VDI für vorhandene virtuelle Rechner:

xe vm-list database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Wiederherstellen einer VM:

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid
<!--NeedCopy-->

Zerstöre die DR-Aufgabe. Alle SRs, die durch die DR-Task eingeführt wurden und nicht von virtuellen Rechnern benötigt werden, werden vernichtet:

xe drtask-destroy uuid=drtask-uuid
<!--NeedCopy-->

Event-Befehle

Befehle zum Arbeiten mit Ereignissen.

Event-Kurse

Ereignisklassen sind in der folgenden Tabelle aufgeführt:

event-wait

xe event-wait class=class_name [param-name=param_value] [param-name=/=param_value]
<!--NeedCopy-->

Blockiert die Ausführung anderer Befehle, bis ein Objekt existiert, das die in der Befehlszeile angegebenen Bedingungen erfüllt. Das Argument x=y bedeutet “warte, bis Feld x den Wert y annimmt” und x=/=y bedeutet “warte, bis Feld x einen anderen Wert als y annimmt”.

Beispiel: Warten Sie, bis eine bestimmte VM ausgeführt wird.

xe event-wait class=vm name-label=myvm power-state=running
<!--NeedCopy-->

Blockiert andere Befehle, bis eine aufgerufene VM mit dem Namen myvm den power-state-Status “running” hat.

Beispiel: Warten Sie, bis eine bestimmte VM neu gestartet wurde:

xe event-wait class=vm uuid=$VM start-time=/=$(xe vm-list uuid=$VM params=start-time --minimal)
<!--NeedCopy-->

Sperrt andere Befehle, bis eine VM mit UUID $VM neu gestartet wird. Der Befehl verwendet den Wert von start-time, um zu entscheiden, wann die VM neu gestartet wird.

Der Klassenname kann eine der am Anfang dieses Abschnitts aufgeführten Ereignisklassen sein. Bei den Parametern kann es sich um einen der Parameter handeln, die in der CLI-Befehlsklasse-param-list aufgeführt sind.

GPU Befehle

Befehle zum Arbeiten mit physischen GPUs, GPU-Gruppen und virtuellen GPUs.

Die GPU-Objekte können mit den Standardbefehlen für die Objektauflistung aufgelistet werden: xe pgpu-listxe gpu-group-list, und xe vgpu-list. Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene.

Physikalische GPU-Parameter

Physikalische GPUS (pGPUs) haben die folgenden Parameter:

pgpu-disable-dom0-access

xe pgpu-disable-dom0-access uuid=uuid
<!--NeedCopy-->

Deaktivieren Sie den pGPU Zugriff auf dom0.

pgpu-enable-dom0-access

xe pgpu-enable-dom0-access uuid=uuid
<!--NeedCopy-->

Ermöglichen Sie den pGPU Zugriff auf dom0.

GPU-Gruppenparameter

GPU-Gruppen haben die folgenden Parameter:

GPU-Gruppenbetrieb

Befehle zum Arbeiten mit GPU-Gruppen

gpu-group-create

xe gpu-group-create name-label=name_for_group [name-description=description]
<!--NeedCopy-->

Erstellt eine neue (leere) GPU-Gruppe, in die pGPUs verschoben werden können.

gpu-group-destroy

xe gpu-group-destroy uuid=uuid_of_group
<!--NeedCopy-->

Zerstört die GPU-Gruppe; nur für leere Gruppen zulässig.

gpu-group-get-remaining-capacity

xe gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type
<!--NeedCopy-->

Gibt zurück, wie viele virtuelle GPUs des angegebenen Typs in dieser GPU-Gruppe instanziiert werden können.

gpu-group-param-set

xe gpu-group-param-set uuid=uuid_of_group allocation-algorithm=breadth-first|depth-first
<!--NeedCopy-->

Ändert den Algorithmus, den die GPU-Gruppe verwendet, um virtuelle GPUs zu pGPUs zuzuweisen.

gpu-group-param-get-uuid

xe gpu-group-param-get-uuid uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types
<!--NeedCopy-->

Gibt die unterstützten oder aktivierten Typen für diese GPU-Gruppe zurück.

Virtuelle GPU-Parameter

Virtuelle GPUs haben die folgenden Parameter:

Typenparameter für virtuelle GPU

Hinweis:

GPU-Passthrough und virtuelle GPUs sind nicht mit Live-Migration, Storage-Live-Migration oder VM Suspend kompatibel, sofern nicht unterstützte Software und Grafikkarten von GPU-Anbietern vorhanden sind. Virtuelle Rechner ohne diese Unterstützung können nicht migriert werden, um Ausfallzeiten zu vermeiden. Informationen zur Kompatibilität von NVIDIA vGPU mit Livemigration, Speicher-Livemigration und VM Suspend finden Sie unter Grafik.

Virtuelle GPU-Typen haben die folgenden Parameter:

Virtueller GPU-Betrieb

vgpu-create

xe vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]
<!--NeedCopy-->

Erstellt eine virtuelle GPU. Dieser Befehl hängt die VM an die angegebene GPU-Gruppe an und gibt optional den virtuellen GPU-Typ an. Wenn kein virtueller GPU-Typ angegeben ist, wird der “Passthrough” -Typ angenommen.

vgpu-destroy

xe vgpu-destroy uuid=uuid_of_vgpu
<!--NeedCopy-->

Zerstört die angegebene virtuelle GPU.

Deaktivieren von VNC für VMs mit virtueller GPU

xe vm-param-add uuid=uuid_of_vmparam-name=platform vgpu_vnc_enabled=true|false
<!--NeedCopy-->

Mit false wird die VNC-Konsole für eine VM deaktiviert, während disablevnc=1 zum Anzeigeemulator weitergeleitet wird. Standardmäßig ist VNC aktiviert.

Host-Befehle

Befehle für die Interaktion mit dem Citrix Hypervisor-Server.

Citrix Hypervisor-Server sind die physischen Server, auf denen Citrix Hypervisor-Software ausgeführt wird. Auf ihnen laufen VMs unter der Kontrolle einer speziellen privilegierten virtuellen Maschine, die als Steuerdomäne oder Domäne 0 bekannt ist.

Die Citrix Hypervisor-Serverobjekte können mit den Befehlen der Standardobjektauflistung aufgeführt werden: xe host-listxe host-cpu-list, und xe host-crashdump-list). Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene.

Host-Selektoren

Einige der hier aufgeführten Befehle haben einen gemeinsamen Mechanismus zum Auswählen eines oder mehrerer Citrix Hypervisor-Server, auf denen der Vorgang ausgeführt werden soll. Am einfachsten ist es, das Argument zu liefern host=uuid_or_name_label. Sie können Citrix Hypervisor auch angeben, indem Sie die vollständige Liste der Hosts nach den Werten von Feldern filtern. Wenn Sie beispielsweise enabled=true angeben, werden alle Citrix Hypervisor-Server ausgewählt, deren enabled-Feld gleich true ist. Wenn mehrere Citrix Hypervisor-Server übereinstimmen und der Vorgang auf mehreren Citrix Hypervisor-Servern ausgeführt werden kann, müssen Sie --multiple angeben, damit der Vorgang ausgeführt wird. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben. Sie können diese Befehlsliste abrufen, indem Sie den Befehl ausführen xe host-list params=all. Wenn keine Parameter zur Auswahl von Citrix Hypervisor-Servern angegeben sind, wird der Vorgang auf allen Citrix Hypervisor-Servern ausgeführt.

Host-Parameter

Citrix Hypervisor-Server haben die folgenden Parameter:

Citrix Hypervisor-Server enthalten einige andere Objekte, die ebenfalls über Parameterlisten verfügen.

CPUs auf Citrix Hypervisor-Servern haben die folgenden Parameter:

Absturzabbilder auf Citrix Hypervisor-Servern haben die folgenden Parameter:

host-all-editions

xe host-all-editions
<!--NeedCopy-->

Holen Sie sich eine Liste aller verfügbaren Editionen

host-apply-edition

xe host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]
<!--NeedCopy-->

Weist die Citrix Hypervisor-Lizenz einem Hostserver zu. Wenn Sie eine Lizenz zuweisen, kontaktiert Citrix Hypervisor den Lizenzserver und fordert den angegebenen Lizenztyp an. Wenn eine Lizenz verfügbar ist, wird sie dann vom Lizenzserver ausgecheckt.

Verwenden Sie für Citrix Hypervisor für Citrix Virtual Desktops und DaaS-Editionen "xendesktop".

Informationen zur Erstkonfiguration der Lizenzierung finden Sie auch unter license-server-address und license-server-port.

host-backup

xe host-backup file-name=backup_filename host=host_name
<!--NeedCopy-->

Laden Sie eine Backup der Steuerdomäne des angegebenen Citrix Hypervisor-Servers auf den Computer herunter, von dem aus der Befehl aufgerufen wird. Speichern Sie es dort als Datei mit dem Namen file-name.

Wichtig:

Der Befehl xe host-backup funktioniert zwar, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines bestimmten Hostnamens), aber verwenden Sie ihn nicht auf diese Weise. Dadurch würde die Steuerdomänenpartition mit der Backupdatei aufgefüllt. Verwenden Sie den Befehl nur von einer remoten Maschine, die nicht auf dem Host ist, und auf der Sie Platz für die Backupdatei haben.

host-bugreport-upload

xe host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]
<!--NeedCopy-->

Generieren Sie einen neuen Fehlerbericht (mit xen-bugtool, alle optionalen Dateien eingeschlossen) und laden Sie ihn auf die FTP-Site des Supports oder an einen anderen Ort hoch.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

Optionale Parameter sind http-proxy: angegebenen HTTP-Proxy verwenden und url: auf diese Ziel-URL hochladen. Wenn optionale Parameter nicht verwendet werden, wird kein Proxyserver identifiziert und das Ziel ist die standardmäßige FTP-Support-Site.

host-call-plugin

xe host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]
<!--NeedCopy-->

Ruft die Funktion innerhalb des Plug-Ins auf dem angegebenen Host mit optionalen Argumenten auf.

host-compute-free-memory

xe host-compute-free-memory
<!--NeedCopy-->

Berechnet die Menge an freiem Speicher auf dem Host.

host-compute-memory-overhead

xe host-compute-memory-overhead
<!--NeedCopy-->

Berechnet den Virtualisierungsspeicher-Overhead eines Hosts.

host-cpu-info

xe host-cpu-info [uuid=uuid]
<!--NeedCopy-->

Listet Informationen über die physischen CPUs des Hosts auf.

host-crashdump-destroy

xe host-crashdump-destroy uuid=crashdump_uuid
<!--NeedCopy-->

Löschen Sie einen Host-Crashdump, der durch seine UUID angegeben ist, vom Citrix Hypervisor-Server.

host-crashdump-upload

xe host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]
<!--NeedCopy-->

Laden Sie einen Crashdump auf die FTP-Site des Supports oder an einem anderen Wenn optionale Parameter nicht verwendet werden, wird kein Proxyserver identifiziert und das Ziel ist die standardmäßige FTP-Support-Site. Optionale Parameter sind http-proxy: angegebenen HTTP-Proxy verwenden und url: auf diese Ziel-URL hochladen.

host-declare-dead

xe host-declare-dead uuid=host_uuid
<!--NeedCopy-->

Erklären Sie, dass der Host tot ist, ohne ihn explizit zu kontaktieren.

Warnung:

Dieser Aufruf ist gefährlich und kann zu Datenverlust führen, wenn der Host nicht wirklich tot ist.

host-disable

xe host-disable [host-selector=host_selector_value...]
<!--NeedCopy-->

Deaktiviert die angegebenen Citrix Hypervisor-Server, wodurch verhindert wird, dass neue VMs auf ihnen gestartet werden. Diese Aktion bereitet die Citrix Hypervisor-Server auf das Herunterfahren oder Neustarten vor. Wenn nach dem Neustart des Hosts alle Bedingungen für die Aktivierung erfüllt sind (z. B. ist Speicher verfügbar), wird der Host automatisch wieder aktiviert.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-disable-display

xe host-disable-display uuid=host_uuid
<!--NeedCopy-->

Deaktiviert die Anzeige für den Host.

host-disable-local-storage-caching

xe host-disable-local-storage-caching
<!--NeedCopy-->

Deaktivieren Sie das lokale Speichercaching auf dem angegebenen Host.

host-dmesg

xe host-dmesg [host-selector=host_selector_value...]
<!--NeedCopy-->

Rufen Sie Xen dmesg (die Ausgabe des Kernelringpuffers) von angegebenen Citrix Hypervisor-Servern ab.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-emergency-ha-disable

xe host-emergency-ha-disable  [--force]
<!--NeedCopy-->

Deaktivieren Sie HA auf dem lokalen Host. Nur zur Wiederherstellung eines Pools mit einem defekten HA-Setup verwendet werden.

host-emergency-management-reconfigure

xe host-emergency-management-reconfigure interface=uuid_of_management_interface_pif
<!--NeedCopy-->

Konfigurieren Sie die Verwaltungsschnittstelle dieses Citrix Hypervisor-Servers neu. Verwenden Sie diesen Befehl nur, wenn sich der Citrix Hypervisor-Server im Notfallmodus befindet. Notfallmodus bedeutet, dass der Host Mitglied in einem Ressourcenpool ist, dessen Master aus dem Netzwerk verschwunden ist und nach mehreren Wiederholungsversuchen nicht kontaktiert werden kann.

host-emergency-reset-server-certificate

xe host-emergency-reset-server-certificate
<!--NeedCopy-->

Installiert ein selbstsigniertes Zertifikat auf dem Citrix Hypervisor-Server, auf dem der Befehl ausgeführt wird.

host-enable

xe host-enable [host-selector=host_selector_value...]
<!--NeedCopy-->

Aktiviert die angegebenen Citrix Hypervisor-Server, sodass neue VMs auf ihnen gestartet werden können.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-enable-display

xe host-enable-display uuid=host_uuid
<!--NeedCopy-->

Aktiviert die Anzeige für den Host.

host-enable-local-storage-caching

xe host-enable-local-storage-caching  sr-uuid=sr_uuid
<!--NeedCopy-->

Aktiviert das lokale Speichercaching auf dem angegebenen Host.

host-evacuate

xe host-evacuate [host-selector=host_selector_value...]
<!--NeedCopy-->

Live migriert alle laufenden VMs auf andere geeignete Hosts in einem Pool. Deaktivieren Sie zunächst den Host mit dem Befehl host-disable.

Wenn der evakuierte Host der Poolmaster ist, muss ein anderer Host als Poolmaster ausgewählt werden. Um den Poolmaster mit deaktivierter HA zu ändern, verwenden Sie den Befehl pool-designate-new-master. Weitere Informationen finden Sie unter Pool-designiert-neuer-Master.

Wenn HA aktiviert ist, besteht Ihre einzige Option darin, den Server herunterzufahren, wodurch HA nach dem Zufallsprinzip einen neuen Master auswählt. Weitere Informationen finden Sie unter Host-shutdown.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-forget

xe host-forget uuid=host_uuid
<!--NeedCopy-->

Der XAPI-Agent vergisst den angegebenen Citrix Hypervisor-Server, ohne ihn explizit zu kontaktieren.

Verwenden Sie den Parameter --force, um zu vermeiden, dass Sie aufgefordert werden, zu bestätigen, dass Sie diesen Vorgang wirklich ausführen möchten.

Warnung:

Verwenden Sie diesen Befehl nicht, wenn HA für den Pool aktiviert ist. Deaktivieren Sie zuerst HA und aktivieren Sie sie dann erneut, nachdem Sie den Host vergessen haben.

Dieser Befehl ist nützlich, wenn der Citrix Hypervisor-Server zum “Vergessen” tot ist. Wenn der Citrix Hypervisor-Server jedoch live und Teil des Pools ist, verwenden Sie stattdessen xe pool-eject.

host-get-server-certificate

xe host-get-server-certificate
<!--NeedCopy-->

Holen Sie sich das TLS-Zertifikat des installierten Servers.

host-get-sm-diagnostics

xe host-get-sm-diagnostics uuid=uuid
<!--NeedCopy-->

SM-Diagnoseinformationen pro Host anzeigen.

host-get-system-status

xe host-get-system-status filename=name_for_status_file [entries=comma_separated_list] [output=tar.bz2|zip] [host-selector=host_selector_value...]
<!--NeedCopy-->

Laden Sie Systemstatusinformationen in die angegebene Datei herunter. Der optionale Parameter entries ist eine kommagetrennte Liste von Systemstatuseinträgen, die dem vom Befehl host-get-system-status-capabilities zurückgegebenen XML-Fragment der Fähigkeiten entnommen wurden. Weitere Informationen finden Sie unter Host-Get-Systemstatus-Funktionen. Wenn nicht angegeben, werden alle Systemstatusinformationen in der Datei gespeichert. Der Parameter output kann tar.bz2 (die Standardeinstellung) oder zipsein. Wenn dieser Parameter nicht angegeben ist, wird die Datei im tar.bz2-Format gespeichert.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben).

host-get-system-status-capabilities

xe host-get-system-status-capabilities [host-selector=host_selector_value...]
<!--NeedCopy-->

Ruft Systemstatus-Funktionen für die angegebenen Hosts ab. Die Funktionen werden als XML-Fragment zurückgegeben, das dem folgenden Beispiel ähnelt:

<?xml version="1.0" ?>
<system-status-capabilities>
    <capability content-type="text/plain" default-checked="yes" key="xenserver-logs"  \
        max-size="150425200" max-time="-1" min-size="150425200" min-time="-1" \
        pii="maybe"/>
    <capability content-type="text/plain" default-checked="yes" \
        key="xenserver-install" max-size="51200" max-time="-1" min-size="10240" \
        min-time="-1" pii="maybe"/>
    ...
</system-status-capabilities>
<!--NeedCopy-->

Jede Capability-Entität kann die folgenden Attribute haben.

• key Eine eindeutige Kennung für die Funktion.
• content-type Kann entweder Text/Normaltext oder Anwendung/Daten sein. Zeigt an, ob eine UI die Einträge für den menschlichen Verzehr rendern kann.
• default-checked Kann entweder Ja oder Nein sein. Gibt an, ob eine Benutzeroberfläche diesen Eintrag standardmäßig auswählt.
• min-size, max-size Gibt einen ungefähren Bereich für die Größe dieses Eintrags in Byte an. -1 bedeutet, dass die Größe unwichtig ist.
• min-time, max-time Gibt einen ungefähren Bereich für die Zeit in Sekunden an, die zum Erfassen dieses Eintrags benötigt wird. -1 zeigt an, dass die Zeit unwichtig ist.

• pii Personenbezogene Daten. Zeigt an, ob der Eintrag Informationen enthält, die den Systembesitzer oder Details seiner Netzwerktopologie identifizieren können. Das Attribut kann einen der folgenden Werte annehmen:

  • no: In diesen Einträgen sind keine PII enthalten
  • yes: PII ist wahrscheinlich oder sicher in diesen Einträgen
  • maybe: Vielleicht möchten Sie diese Einträge auf PII überprüfen
  • if_customized wenn die Dateien unverändert sind, enthalten sie keine PII. Da wir jedoch die Bearbeitung dieser Dateien fördern, wurde PII möglicherweise durch eine solche Anpassung eingeführt. Dieser Wert wird insbesondere für die Netzwerkskripte in der Steuerdomäne verwendet.

  Kennwörter dürfen niemals in einen Fehlerbericht aufgenommen werden, unabhängig von einer PII-Deklaration.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben).

host-get-thread-diagnostics

xe host-get-thread-diagnostics uuid=uuid
<!--NeedCopy-->

Zeigt Diagnoseinformationen für Threads pro Host an.

host-get-vms-which-prevent-evacuation

xe host-get-vms-which-prevent-evacuation uuid=uuid
<!--NeedCopy-->

Gibt eine Liste von virtuellen Rechnern zurück, die die Evakuierung eines bestimmten Hosts verhindern, und zeigt die Gründe für jeden einzelnen an.

host-is-in-emergency-mode

xe host-is-in-emergency-mode
<!--NeedCopy-->

Gibt true zurück, wenn der Host, mit dem die CLI kommuniziert, im Notfallmodus ist, andernfalls false. Dieser CLI-Befehl funktioniert direkt auf Poolmitgliedsservern, auch wenn kein Masterserver vorhanden ist.

host-license-add

xe host-license-add [license-file=path/license_filename] [host-uuid=host_uuid]
<!--NeedCopy-->

Verwenden Sie für Citrix Hypervisor (kostenlose Version), um eine lokale Lizenzdatei zu analysieren und sie dem angegebenen Citrix Hypervisor-Server hinzuzufügen.

host-license-remove

xe host-license-remove [host-uuid=host_uuid]
<!--NeedCopy-->

Entfernen Sie alle auf einen Host angewendeten Lizenzen.

host-license-view

xe host-license-view [host-uuid=host_uuid]
<!--NeedCopy-->

Zeigt den Inhalt der Citrix Hypervisor-Serverlizenz an.

host-logs-download

xe host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]
<!--NeedCopy-->

Laden Sie eine Kopie der Protokolle der angegebenen Citrix Hypervisor-Server herunter. Die Kopie wird standardmäßig in einer Datei mit Zeitstempel namens gespeichert hostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz. Mit dem optionalen Parameter file-name können Sie einen anderen Dateinamen angeben.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

Wichtig:

Der Befehl xe host-logs-download funktioniert zwar, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines bestimmten Hostnamens), aber verwenden Sie ihn nicht auf diese Weise. Dadurch wird die Steuerdomänenpartition mit der Kopie der Protokolle überladen. Verwenden Sie den Befehl nur von einem Remote-Off-Host-Computer aus, auf dem Sie Speicherplatz für die Kopie der Protokolle haben.

host-management-disable

xe host-management-disable
<!--NeedCopy-->

Deaktiviert den Host-Agent, der auf einer externen Verwaltungsnetzwerkschnittstelle lauscht, und trennt alle verbundenen API-Clients (z. B. XenCenter). Dieser Befehl wird direkt auf dem Citrix Hypervisor-Server ausgeführt, mit dem die CLI verbunden ist. Der Befehl wird nicht an den Poolmaster weitergeleitet, wenn er auf einen Citrix Hypervisor-Mitgliedsserver angewendet wird.

Warnung:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden. Nachdem dieser Befehl ausgeführt wurde, können Sie sich nicht remote über das Netzwerk mit der Steuerdomäne verbinden, um den Host-Agent erneut zu aktivieren.

host-management-reconfigure

xe host-management-reconfigure [interface=device] [pif-uuid=uuid]
<!--NeedCopy-->

Konfiguriert den Citrix Hypervisor-Server neu, um die angegebene Netzwerkschnittstelle als Verwaltungsschnittstelle zu verwenden. Dies ist die Schnittstelle, die für die Verbindung mit dem XenCenter verwendet wird. Der Befehl schreibt den Schlüssel MANAGEMENT_INTERFACE um /etc/xensource-inventory.

Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, bindet der Citrix Hypervisor-Server sofort neu. Dieser Befehl funktioniert sowohl im Normal- als auch im Notfallmodus.

Wenn die UUID eines PIF-Objekts angegeben ist, bestimmt der Citrix Hypervisor-Server, welche IP-Adresse an sich selbst neu gebunden werden soll. Es darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.

Warnung:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass die neue Schnittstelle über Netzwerkkonnektivität verfügt. Verwenden Sie xe pif-reconfigure zum Einrichten. Andernfalls können nachfolgende CLI-Befehle den Citrix Hypervisor-Server nicht erreichen.

host-power-on

xe host-power-on [host=host_uuid]
<!--NeedCopy-->

Schaltet Citrix Hypervisor-Server mit aktivierter Host-Einschaltfunktion ein. Bevor Sie diesen Befehl verwenden, aktivieren Sie host-set-power-on auf dem Host.

host-reboot

xe host-reboot [host-selector=host_selector_value...]
<!--NeedCopy-->

Starten Sie die angegebenen Citrix Hypervisor-Server neu. Die angegebenen Hosts müssen zuerst mit dem Befehl xe host-disable deaktiviert werden, andernfalls wird eine Fehlermeldung HOST_IN_USEangezeigt.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

Wenn die angegebenen Citrix Hypervisor-Server Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren behandelt und der Pool wird wiederhergestellt, wenn die Citrix Hypervisor-Server zurückkehren. Die anderen Mitglieder und der Master funktionieren weiterhin.

Wenn Sie den Master herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen eintritt:

• Du machst eines der Mitglieder zum Master

• Der ursprüngliche Master wird neu gestartet und ist wieder online.

  Wenn der Master wieder online ist, verbinden sich die Mitglieder erneut und synchronisieren sich mit dem Master.

host-restore

xe host-restore [file-name=backup_filename] [host-selector=host_selector_value...]
<!--NeedCopy-->

Stellen Sie eine Backup mit dem Namen file-name der Citrix Hypervisor-Serversteuerungssoftware wieder her. Die Verwendung des Wortes “Wiederherstellen” bedeutet hier keine vollständige Wiederherstellung im üblichen Sinne, sondern bedeutet lediglich, dass die komprimierte Backupdatei dekomprimiert und auf die sekundäre Partition entpackt wurde. Nachdem Sie xe host-restore abgeschlossen haben, müssen Sie die Installations-CD starten und die Option Wiederherstellen von Backup verwenden.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-send-debug-keys

xe host-send-debug-keys  host-uuid=host_uuid keys=keys
<!--NeedCopy-->

Sendet angegebene Hypervisor-Debug-Schlüssel an den angegebenen Host.

host-server-certificate-install

xe host-server-certificate-install certificate=path_to_certificate_file private-key=path_to_private_key [certificate-chain=path_to_chain_file] [host=host_name | uuid=host_uuid]
<!--NeedCopy-->

Installieren Sie ein TLS-Zertifikat auf einem Citrix Hypervisor-Server.

host-set-hostname-live

xe host-set-hostname-live host-uuid=uuid_of_host host-name=new_hostname
<!--NeedCopy-->

Ändern Sie den Hostnamen des mit host-uuid angegebenen Citrix Hypervisor-Servers. Dieser Befehl legt sowohl den Hostnamen in der Kontrolldomänendatenbank als auch den tatsächlichen Linux-Hostnamen des Citrix Hypervisor-Servers dauerhaft fest. Der Wert von host-name ist nicht mit dem Wert des Feldes name_label identisch.

host-set-power-on-mode

xe host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "DRAC" | "custom"} \
    [ power-on-config:power_on_ip=ip-address power-on-config:power_on_user=user power-on-config:power_on_password_secret=secret-uuid ]
<!--NeedCopy-->

Verwenden Sie diese Option, um die Host-Einschaltfunktion auf Citrix Hypervisor-Hosts zu aktivieren, die mit Remote-Energielösungen kompatibel sind. Wenn Sie den Befehl host-set-power-on verwenden, müssen Sie den Typ der Energieverwaltungslösung auf dem Host angeben (d. h. den Einschaltmodus). Geben Sie dann die Konfigurationsoptionen mit dem Argument power-on-config und den zugehörigen Schlüssel-Wert-Paaren an.

Geben Sie den Schlüssel "power_on_password_secret" an, um die Funktion “Geheimnisse” zum Speichern Ihres Kennworts zu verwenden. Weitere Informationen finden Sie unter Secrets.

host-shutdown

xe host-shutdown [host-selector=host_selector_value...]
<!--NeedCopy-->

Fahren Sie die angegebenen Citrix Hypervisor-Server herunter. Die angegebenen Citrix Hypervisor-Server müssen zuerst mit dem Befehl xe host-disable deaktiviert werden, andernfalls wird eine Fehlermeldung HOST_IN_USE angezeigt.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

Wenn die angegebenen Citrix Hypervisor-Server Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren behandelt und der Pool wird wiederhergestellt, wenn die Citrix Hypervisor-Server zurückkehren. Die anderen Mitglieder und der Master funktionieren weiterhin.

Wenn Sie den Master herunterfahren, ist der Pool außer Betrieb, bis eine der folgenden Aktionen eintritt:

• Du machst eines der Mitglieder zum Master

• Der ursprüngliche Master wird neu gestartet und ist wieder online.

  Wenn der Master wieder online ist, verbinden sich die Mitglieder erneut und synchronisieren sich mit dem Master.

Wenn HA für den Pool aktiviert ist, wird eines der Mitglieder automatisch zum Master gemacht. Wenn HA deaktiviert ist, müssen Sie den gewünschten Server mit dem Befehlpool-designate-new-master manuell als Master festlegen. Weitere Informationen finden Sie unter Pool-designiert-neuer-Master.

host-sm-dp-destroy

xe host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]
<!--NeedCopy-->

Versuch, einen Speicherdatenpfad auf einem Host zu zerstören und zu bereinigen. Wenn allow-leak=true angegeben wird, löscht es alle Datensätze des Datenpfads, auch wenn er nicht sauber heruntergefahren wurde.

host-sync-data

xe host-sync-data
<!--NeedCopy-->

Synchronisieren Sie die auf dem Poolmaster gespeicherten Daten mit dem benannten Host. Dies beinhaltet nicht die Datenbankdaten).

host-syslog-reconfigure

xe host-syslog-reconfigure [host-selector=host_selector_value...]
<!--NeedCopy-->

Konfigurieren Sie den syslog-Daemon auf den angegebenen Citrix Hypervisor-Servern neu. Mit diesem Befehl werden die Konfigurationsinformationen angewendet, die im logging-Hostparameter definiert sind.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-data-source-list

xe host-data-source-list [host-selectors=host selector value...]
<!--NeedCopy-->

Listen Sie die Datenquellen auf, die für einen Host aufgezeichnet werden können.

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.

Datenquellen haben zwei Parameter — standard und enabled. Dieser Befehl gibt die Werte der Parameter aus:

• Wenn in einer Datenquelle enabled auf true festgelegt wurde, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet.
• Wenn in einer Datenquelle standard auf true eingestellt ist, werden die Metriken standardmäßigin der Performance-Datenbank aufgezeichnet. Der Wert von enabled ist auch für diese Datenquelle auf true festgelegt.
• Wenn für eine Datenquelle standard auf false eingestellt ist, werden die Metriken nicht standardmäßig in der Performance-Datenbank aufgezeichnet. Der Wert von enabled ist auch für diese Datenquelle auf false festgelegt.

Führen Sie den Befehl host-data-source-record aus, um die Aufzeichnung von Datenquellenmetriken in der Performance-Datenbank zu starten. Mit diesem Befehl wird enabled auf true festgelegt. Um aufzuhören, führe das aus host-data-source-forget. Mit diesem Befehl wird enabled auf false festgelegt.

host-data-source-record

xe host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

Notieren Sie die angegebene Datenquelle für einen Host.

Bei diesem Vorgang werden die Informationen aus der Datenquelle in die Datenbank der persistenten Leistungsmetriken der angegebenen Hosts geschrieben. Aus Leistungsgründen unterscheidet sich diese Datenbank von der normalen Agentdatenbank.

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.

host-data-source-forget

xe host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

Beenden Sie die Aufzeichnung der angegebenen Datenquelle für einen Host und vergessen Sie alle aufgezeichneten Daten.

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.

host-data-source-query

xe host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value...]
<!--NeedCopy-->

Zeigt die angegebene Datenquelle für einen Host an.

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten Host-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen Hosts ausgeführt.

VERALTET: Protokollbefehle

Befehle zum Arbeiten mit Protokollen.

VERALTET: log-get

xe log-get
<!--NeedCopy-->

Gibt das aktuell im String-Logger gespeicherte Protokoll zurück.

VERALTET: log-get-keys

xe log-get-keys
<!--NeedCopy-->

Listen Sie die vom Logger bekannten Schlüssel auf.

VERALTET: log-reopen

xe log-reopen
<!--NeedCopy-->

Öffnen Sie alle Logger erneut (verwenden Sie dies zum Drehen von Dateien).

VERALTET: log-set-output

xe log-set-output output=output [key=key] [level=level]
<!--NeedCopy-->

Setzt alle Logger auf die angegebene Ausgabe (nil, stderr, string, file:Dateiname, syslog:etwas).

Message-Befehle

Befehle zum Arbeiten mit Nachrichten. Nachrichten werden erstellt, um Benutzer über wichtige Ereignisse zu informieren, und werden in XenCenter als Warnungen angezeigt.

Die Meldungsobjekte können mit dem Standard-Objektauflistungsbefehl (xe message-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Message-Parameter

message-create

xe message-create name=message_name body=message_text [[host-uuid=uuid_of_host] | [sr-uuid=uuid_of_sr] | [vm-uuid=uuid_of_vm] | [pool-uuid=uuid_of_pool]]
<!--NeedCopy-->

Erstellt eine Nachricht.

message-destroy

xe message-destroy [uuid=message_uuid]
<!--NeedCopy-->

Zerstört eine vorhandene Nachricht. Sie können ein Skript erstellen, um alle Nachrichten zu vernichten. Beispiel:

# Dismiss all alerts   \
    IFS=","; for m in $(xe message-list params=uuid --minimal); do  \
    xe message-destroy uuid=$m  \
    done
<!--NeedCopy-->

Netzwerkbefehle

Befehle zum Arbeiten mit Netzwerken.

Die Netzwerkobjekte können mit dem Standardbefehl für die Objektauflistung (xe network-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Netzwerkparameter

Netzwerke haben folgende Parameter:

network-create

xe network-create name-label=name_for_network [name-description=descriptive_text]
<!--NeedCopy-->

Erstellt ein Netzwerk.

network-destroy

xe network-destroy uuid=network_uuid
<!--NeedCopy-->

Zerstört ein vorhandenes Netzwerk.

SR-IOV-Befehle

Befehle für die Arbeit mit SR-IOV.

Die network-sriov-Objekte können mit dem Standardbefehl zur Objektauflistung (xe network-sriov-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

SR-IOV-Parameter

SR-IOV hat die folgenden Parameter:

network-sriov-create

xe network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid
<!--NeedCopy-->

Erstellt ein SR-IOV-Netzwerkobjekt für ein bestimmtes physisches PIF und aktiviert SR-IOV auf dem physischen PIF.

network-sriov-destroy

xe network-sriov-destroy uuid=network_sriov_uuid
<!--NeedCopy-->

Entfernt ein Netzwerk-SR-IOV-Objekt und deaktiviert SR-IOV auf seinem physischen PIF.

Weisen Sie einen SR-IOV-VF zu

xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid
<!--NeedCopy-->

Weist einer VM einen VF aus einem SR-IOV-Netzwerk zu.

SDN-Controller-Befehle

Befehle zum Arbeiten mit dem SDN-Controller.

sdn-controller-forget

xe sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]
<!--NeedCopy-->

Stellen Sie einen SDN-Controller vor.

sdn-controller-introduce

xe sdn-controller-forget uuid=uuid
<!--NeedCopy-->

Entfernen Sie einen SDN-Controller.

Tunnel-Befehle

Befehle zum Arbeiten mit Tunneln.

tunnel-create

xe tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid
<!--NeedCopy-->

Erstellen Sie einen neuen Tunnel auf einem Host.

tunnel-destroy

xe tunnel-destroy uuid=uuid
<!--NeedCopy-->

Zerstöre einen Tunnel.

Patch-Befehle

Befehle zum Arbeiten mit Patches.

patch-apply

xe patch-apply uuid=patch_uuid host-uuid=host_uuid
<!--NeedCopy-->

Wendet den zuvor hochgeladenen Patch auf den angegebenen Host an.

patch-clean

xe patch-clean uuid=uuid
<!--NeedCopy-->

Löscht eine zuvor hochgeladene Patch-Datei.

patch-destroy

xe patch-destroy uuid=uuid
<!--NeedCopy-->

Entfernt einen nicht angewendeten Patch-Datensatz und Dateien vom Server.

patch-pool-apply

xe patch-pool-apply uuid=uuid
<!--NeedCopy-->

Wenden Sie den zuvor hochgeladenen Patch auf alle Hosts im Pool an.

patch-pool-clean

xe patch-pool-clean uuid=uuid
<!--NeedCopy-->

Löschen Sie eine zuvor hochgeladene Patch-Datei auf allen Hosts im Pool.

patch-precheck

xe patch-precheck uuid=uuid host-uuid=host_uuid
<!--NeedCopy-->

Führen Sie die Vorprüfungen aus, die in dem zuvor auf den angegebenen Host hochgeladenen Patch enthalten sind

patch-upload

xe patch-upload file-name=file_name
<!--NeedCopy-->

Laden Sie eine Patch-Datei auf den Server hoch.

PBD-Befehle

Befehle zum Arbeiten mit PBDs (Physical Block Devices). PBDs sind die Softwareobjekte, über die der Citrix Hypervisor-Server auf Speicherrepositories (SRs) zugreift.

Die PBD-Objekte können mit dem Standard-Objektauflistungsbefehl (xe pbd-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

PBD-Parameter

PBDs haben die folgenden Parameter:

pbd-create

xe pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]
<!--NeedCopy-->

Erstellen Sie eine PBD auf Ihrem Citrix Hypervisor-Server. Der schreibgeschützte Parameter device-config kann nur bei der Erstellung festgelegt werden.

Um eine Zuordnung von ‘path’ zu ‘/tmp’ hinzuzufügen, stellen Sie sicher, dass die Befehlszeile das Argument enthält device-config:path=/tmp

Eine vollständige Liste der unterstützten Schlüssel/Wert-Paare für Geräte-Konfiguration für jeden SR-Typ finden Sie unter Speicher.

pbd-destroy

xe pbd-destroy uuid=uuid_of_pbd
<!--NeedCopy-->

Zerstört die angegebene PBD.

pbd-plug

xe pbd-plug uuid=uuid_of_pbd
<!--NeedCopy-->

Versucht, die PBD an den Citrix Hypervisor-Server anzuschließen. Wenn dieser Befehl erfolgreich ist, wird die referenzierte SR (und die darin enthaltenen VDIs) für den Citrix Hypervisor-Server sichtbar.

pbd-unplug

xe pbd-unplug uuid=uuid_of_pbd
<!--NeedCopy-->

Versuchen Sie, die PBD vom Citrix Hypervisor-Server zu trennen.

PIF-Befehle

Befehle zum Arbeiten mit PIFs (Objekte, die die physikalischen Netzwerkschnittstellen darstellen).

Die PIF-Objekte können mit dem Standard-Objektauflistungsbefehl (xe pif-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

PIF-Parameter

PIFs haben folgende Parameter:

Hinweis:

Änderungen an den other-config-Feldern eines PIF werden erst nach einem Neustart wirksam. Verwenden Sie alternativ die Befehle xe pif-unplug und xe pif-plug, um die PIF-Konfiguration neu zu schreiben.

pif-forget

xe pif-forget uuid=uuid_of_pif
<!--NeedCopy-->

Zerstört das angegebene PIF-Objekt auf einem bestimmten Host.

pif-introduce

xe pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name
<!--NeedCopy-->

Erstellen Sie ein PIF-Objekt, das eine physische Schnittstelle auf dem angegebenen Citrix Hypervisor-Server darstellt.

pif-plug

xe pif-plug uuid=uuid_of_pif
<!--NeedCopy-->

Versuch, die angegebene physikalische Schnittstelle hochzufahren.

pif-reconfigure-ip

xe pif-reconfigure-ip uuid=uuid_of_pif [mode=dhcp|mode=static] gateway=network_gateway_address IP=static_ip_for_this_pif netmask=netmask_for_this_pif [DNS=dns_address]
<!--NeedCopy-->

Ändern Sie die IP-Adresse des PIF. Bei einer statischen IP-Konfiguration legen Sie den Parameter mode auf static, und die Parameter gateway, IP und netmask auf die entsprechenden Werte fest. Um DHCP zu verwenden, setzen Sie den Parameter mode auf DHCP und lassen Sie die statischen Parameter undefiniert.

Hinweis:

Die Verwendung statischer IP-Adressen auf physischen Netzwerkschnittstellen, die über das Spanning Tree Protocol mit ausgeschaltetem (oder nicht unterstütztem) STP Fast Link an einen Port eines Switches angeschlossen sind, führt zu einem Zeitraum, in dem kein Datenverkehr stattfindet.

pif-reconfigure-ipv6

xe pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]
<!--NeedCopy-->

Konfigurieren Sie die IPv6-Adresseinstellungen auf einem PIF neu.

pif-scan

xe pif-scan host-uuid=host_uuid
<!--NeedCopy-->

Suchen Sie auf Ihrem Citrix Hypervisor-Server nach neuen physischen Schnittstellen.

pif-set-primary-address-type

xe pif-set-primary-address-type  uuid=uuid primary_address_type=address_type
<!--NeedCopy-->

Ändern Sie den von diesem PIF verwendeten primären Adresstyp.

pif-unplug

xe pif-unplug uuid=uuid_of_pif
<!--NeedCopy-->

Versuch, die angegebene physikalische Schnittstelle herunterzufahren.

Pool-Befehle

Befehle zum Arbeiten mit Pools. Ein Pool ist ein Aggregat aus einem oder mehreren Citrix Hypervisor-Servern. Ein Pool verwendet ein oder mehrere gemeinsam genutzte Speicherrepositories, sodass die VMs, die auf einem Host im Pool ausgeführt werden, nahezu in Echtzeit zu einem anderen Host im Pool migriert werden können. Diese Migration findet statt, während die VM noch läuft, ohne dass sie heruntergefahren und wieder hochgefahren werden muss. Jeder Citrix Hypervisor-Server ist wirklich ein Pool, der standardmäßig aus einem einzelnen Mitglied besteht. Wenn Ihr Citrix Hypervisor-Server mit einem Pool verbunden ist, wird er als Mitglied festgelegt, und der Pool, dem er beigetreten ist, wird zum Master für den Pool.

Das Singleton-Pool-Objekt kann mit dem Standard-Objektauflistungsbefehl (xe pool-list) aufgelistet werden. Seine Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Pool-Parameter

Pools haben die folgenden Parameter:

pool-apply-edition

xe pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]
<!--NeedCopy-->

Wenden Sie eine Ausgabe im gesamten Pool an.

pool-certificate-install

xe pool-certificate-install filename=file_name
<!--NeedCopy-->

Installieren Sie ein TLS-Zertifikat, poolweit.

pool-certificate-list

xe pool-certificate-list
<!--NeedCopy-->

Listet alle installierten TLS-Zertifikate in einem Pool auf.

pool-certificate-sync

xe pool-certificate-sync
<!--NeedCopy-->

Synchronisieren Sie TLS-Zertifikate und Zertifikatssperrlisten vom Poolmaster mit den anderen Poolmitgliedern.

pool-certificate-uninstall

xe pool-certificate-uninstall name=name
<!--NeedCopy-->

Deinstalliert ein TLS-Zertifikat.

pool-crl-install

xe pool-crl-install filename=file_name
<!--NeedCopy-->

Installieren Sie eine TLS-Zertifikatssperrliste, poolweit.

pool-crl-list

xe pool-crl-list
<!--NeedCopy-->

Listet alle installierten TLS-Zertifikatssperrlisten auf.

pool-crl-uninstall

xe pool-crl-uninstall name=name
<!--NeedCopy-->

Deinstalliert eine TLS-Zertifikatssperrliste.

pool-deconfigure-wlb

xe pool-deconfigure-wlb
<!--NeedCopy-->

Entfernen Sie die Konfiguration für den Workloadausgleich dauerhaft.

pool-designate-new-master

xe pool-designate-new-master host-uuid=uuid_of_new_master
<!--NeedCopy-->

Weisen Sie den angegebenen Citrix Hypervisor-Server an, Master eines vorhandenen Pools zu werden. Dieser Befehl führt eine geordnete Übergabe der Rolle des Masterhosts an einen anderen Host im Ressourcenpool durch. Dieser Befehl funktioniert nur, wenn der aktuelle Master online ist. Es ist kein Ersatz für die unten aufgeführten Befehle im Notfallmodus.

pool-disable-external-auth

xe pool-disable-external-auth [uuid=uuid] [config=config]
<!--NeedCopy-->

Deaktiviert die externe Authentifizierung bei allen Hosts in einem Pool.

pool-disable-local-storage-caching

xe pool-disable-local-storage-caching uuid=uuid
<!--NeedCopy-->

Deaktivieren Sie das lokale Speicher-Caching im gesamten Pool.

pool-disable-redo-log

xe pool-disable-redo-log
<!--NeedCopy-->

Deaktivieren Sie das Redo-Protokoll, falls es verwendet wird, sofern HA nicht aktiviert ist.

pool-dump-database

xe pool-dump-database file-name=filename_to_dump_database_into_(on_client)
<!--NeedCopy-->

Laden Sie eine Kopie der gesamten Pooldatenbank herunter und speichern Sie sie in einer Datei auf dem Client.

pool-enable-external-auth

xe pool-enable-external-auth  auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config]
<!--NeedCopy-->

Ermöglicht die externe Authentifizierung bei allen Hosts in einem Pool. Beachten Sie, dass für einige Werte von auth-type bestimmte config:-Werte erforderlich sind.

pool-enable-local-storage-caching

xe pool-enable-local-storage-caching uuid=uuid
<!--NeedCopy-->

Aktivieren Sie das lokale Speicher-Caching im gesamten Pool.

pool-enable-redo-log

xe pool-enable-redo-log sr-uuid=sr_uuid
<!--NeedCopy-->

Aktiviert das Redo-Protokoll auf dem angegebenen SR, falls es verwendet wird, sofern HA nicht aktiviert ist.

pool-eject

xe pool-eject host-uuid=uuid_of_host_to_eject
<!--NeedCopy-->

Weisen Sie den angegebenen Citrix Hypervisor-Server an, einen vorhandenen Pool zu verlassen.

pool-emergency-reset-master

xe pool-emergency-reset-master master-address=address_of_pool_master
<!--NeedCopy-->

Weisen Sie einen Poolmitgliedsserver an, seine Master-Server-Adresse auf den neuen Wert zurückzusetzen, und versuchen Sie, eine Verbindung zu ihm herzustellen. Führen Sie diesen Befehl nicht auf Masterservern aus.

pool-emergency-transition-to-master

xe pool-emergency-transition-to-master
<!--NeedCopy-->

Weisen Sie einen Citrix Hypervisor-Mitgliedsserver an, Poolmaster zu werden. Der Citrix Hypervisor-Server akzeptiert diesen Befehl erst, nachdem der Host in den Notfallmodus übergegangen ist. Notfallmodus bedeutet, dass er Mitglied eines Pools ist, dessen Master aus dem Netzwerk verschwunden ist und nach einigen Wiederholungsversuchen nicht mehr kontaktiert werden kann.

Wenn das Host-Kennwort geändert wurde, seit der Host dem Pool beigetreten ist, kann dieser Befehl dazu führen, dass das Kennwort des Hosts zurückgesetzt wird. Weitere Informationen finden Sie unter (Benutzerbefehle).

pool-ha-enable

xe pool-ha-enable heartbeat-sr-uuids=uuid_of_heartbeat_sr
<!--NeedCopy-->

Aktivieren Sie Hochverfügbarkeit im Ressourcenpool, indem Sie die angegebene SR-UUID als zentrales Speicher-Heartbeat-Repository verwenden.

pool-ha-disable

xe pool-ha-disable
<!--NeedCopy-->

Deaktiviert die Hochverfügbarkeitsfunktion im Ressourcenpool.

pool-ha-compute-hypothetical-max-host-failures-to-tolerate

Berechnet die maximale Anzahl von Host-Ausfällen, die in der aktuellen Pool-Konfiguration toleriert werden sollen.

pool-ha-compute-max-host-failures-to-tolerate

xe pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority]
<!--NeedCopy-->

Berechnen Sie die maximale Anzahl von zu tolerierenden Hostausfällen mit den bereitgestellten, vorgeschlagenen geschützten VMs.

pool-initialize-wlb

xe pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password
<!--NeedCopy-->

Initialisieren Sie den Workloadausgleich für den aktuellen Pool mit dem Workload Balancing-Zielserver.

pool-join

xe pool-join master-address=address master-username=username master-password=password
<!--NeedCopy-->

Weisen Sie Ihren Citrix Hypervisor-Server an, einem vorhandenen Pool beizutreten.

pool-management-reconfigure

xe pool-management-reconfigure [network-uuid=network-uuid]
<!--NeedCopy-->

Konfiguriert die Verwaltungsschnittstelle aller Hosts im Pool neu, um die angegebene Netzwerkschnittstelle zu verwenden, die für die Verbindung mit dem XenCenter verwendet wird. Der Befehl schreibt den Schlüssel MANAGEMENT_INTERFACE in /etc/xensource-inventory für alle Hosts im Pool um.

Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, bindet der Citrix Hypervisor Masterhost sofort neu. Dieser Befehl funktioniert sowohl im Normal- als auch im Notfallmodus.

Aus der angegebenen Netzwerk-UUID wird die UUID des PIF-Objekts identifiziert und dem Citrix Hypervisor-Server zugeordnet, der bestimmt, welche IP-Adresse an sich selbst neu gebunden werden soll. Es darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.

Warnung:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass die neue Schnittstelle über Netzwerkkonnektivität verfügt. Verwenden Sie xe pif-reconfigure zum Einrichten. Andernfalls können nachfolgende CLI-Befehle den Citrix Hypervisor-Server nicht erreichen.

pool-recover-slaves

xe pool-recover-slaves
<!--NeedCopy-->

Weisen Sie den Poolmaster an, zu versuchen, die Masteradresse aller Mitglieder zurückzusetzen, die gerade im Notfallmodus laufen. Dieser Befehl wird normalerweise verwendet, nachdem mit pool-emergency-transition-to-master eines der Mitglieder als neuen Master festgelegt wurde.

pool-restore-database

xe pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]
<!--NeedCopy-->

Laden Sie ein Datenbankbackup (erstellt mit pool-dump-database) in einen Pool hoch. Nach Erhalt des Uploads startet sich der Master mit der neuen Datenbank neu.

Es gibt auch eine Testlaufoption, mit der Sie überprüfen können, ob die Pooldatenbank wiederhergestellt werden kann, ohne den Vorgang tatsächlich auszuführen. Standardmäßig ist dry-run auf “false” festgelegt.

pool-retrieve-wlb-configuration

xe pool-retrieve-wlb-configuration
<!--NeedCopy-->

Ruft die Pool-Optimierungskriterien vom Workload Balancing-Server ab.

pool-retrieve-wlb-diagnostics

xe pool-retrieve-wlb-diagnostics [filename=file_name]
<!--NeedCopy-->

Ruft Diagnosen vom Workload Balancing-Server ab.

pool-retrieve-wlb-recommendations

xe pool-retrieve-wlb-recommendations
<!--NeedCopy-->

Ruft VM-Migrationsempfehlungen für den Pool vom Workload Balancing-Server ab.

pool-retrieve-wlb-report

xe pool-retrieve-wlb-report report=report [filename=file_name]
<!--NeedCopy-->

Ruft Berichte vom Workload Balancing-Server ab.

pool-secret-rotate

xe pool-secret-rotate
<!--NeedCopy-->

Rotieren Sie das Poolgeheimnis.

Das Poolgeheimnis ist ein Geheimnis, das von den Servern in einem Pool geteilt wird und es dem Server ermöglicht, seine Mitgliedschaft in einem Pool nachzuweisen. Benutzer mit der Rolle “Pool Admin” können dieses Geheimnis anzeigen, wenn sie sich über SSH mit dem Server verbinden. Rotieren Sie das Poolgeheimnis, wenn einer dieser Benutzer Ihre Organisation verlässt oder seine Pooladministratorrolle verliert.

pool-send-test-post

xe pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body
<!--NeedCopy-->

Senden Sie den angegebenen Text mithilfe von HTTPS an den angegebenen Host und Port und drucken Sie die Antwort aus. Dies wird für das Debuggen der TLS-Schicht verwendet.

pool-send-wlb-configuration

xe pool-send-wlb-configuration [config:=config]
<!--NeedCopy-->

Legt die Pool-Optimierungskriterien für den Workload Balancing-Server fest.

pool-sync-database

xe pool-sync-database
<!--NeedCopy-->

Erzwingt die Synchronisierung der Pooldatenbank über alle Hosts im Ressourcenpool. Dieser Befehl ist im normalen Betrieb nicht erforderlich, da die Datenbank regelmäßig automatisch repliziert wird. Der Befehl kann jedoch nützlich sein, um sicherzustellen, dass Änderungen schnell repliziert werden, nachdem ein erheblicher Satz von CLI-Operationen ausgeführt wurde.

igmp-snooping-enabled

xe pool-param-set [uuid=pool-uuid] [igmp-snooping-enabled=true|false]
<!--NeedCopy-->

Aktiviert oder deaktiviert IGMP-Snooping in einem Citrix Hypervisor-Pool.

https-only

xe pool-param-set [uuid=pool-uuid] [https-only=true|false]
<!--NeedCopy-->

Aktiviert oder deaktiviert die Blockierung von Port 80 auf der Verwaltungsschnittstelle von Citrix Hypervisor-Hosts.

PVS Accelerator-Befehle

Befehle zum Arbeiten mit dem PVS-Beschleuniger.

pvs-cache-storage-create

xe pvs-cache-storage-create sr-uuid=sr_uuid pvs-site-uuid=pvs_site_uuid size=size
<!--NeedCopy-->

Konfigurieren Sie einen PVS-Cache auf einem bestimmten SR für einen bestimmten Host.

pvs-cache-storage-destroy

xe pvs-cache-storage-destroy uuid=uuid
<!--NeedCopy-->

Entferne einen PVS-Cache.

pvs-proxy-create

xe pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid
<!--NeedCopy-->

Konfigurieren Sie eine VM/VIF für die Verwendung eines PVS-Proxys.

pvs-proxy-destroy

xe pvs-proxy-destroy uuid=uuid
<!--NeedCopy-->

Entfernen (oder schalten) Sie einen PVS-Proxy für diese VIF/VM aus.

pvs-server-forget

xe pvs-server-forget uuid=uuid
<!--NeedCopy-->

Vergessen Sie einen PVS-Server.

pvs-server-introduce

xe pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid
<!--NeedCopy-->

Einführung eines neuen PVS-Servers.

pvs-site-forget

xe pvs-site-forget uuid=uuid
<!--NeedCopy-->

Vergiss eine PVS-Site.

pvs-site-introduce

xe pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]
<!--NeedCopy-->

Einführung einer neuen PVS-Site.

Storage Manager-Befehle

Befehle zum Steuern von Storage Manager-Plug-ins.

Die Storage-Manager-Objekte können mit dem Standard-Objektauflistungsbefehl (xe sm-list) aufgelistet werden. Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

SM-Parameter

SMs haben folgende Parameter:

Snapshot-Befehle

Befehle zum Arbeiten mit Schnappschüssen.

snapshot-clone

xe snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]
<!--NeedCopy-->

Erstellen Sie eine neue Vorlage, indem Sie einen vorhandenen Snapshot klonen und, sofern verfügbar, einen schnellen Datenträgerklonvorgang auf Speicherebene verwenden.

snapshot-copy

xe snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]
<!--NeedCopy-->

Erstellen Sie eine neue Vorlage, indem Sie eine vorhandene VM kopieren, ohne jedoch den schnellen Datenträgerklonvorgang auf Speicherebene zu verwenden (auch wenn diese verfügbar ist). Die Datenträgerimages der kopierten VM sind garantiert “vollständige Images” - also nicht Teil einer CoW-Kette.

snapshot-destroy

xe snapshot-destroy  [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->

Zerstöre einen Schnappschuss. Dadurch bleibt der mit dem Snapshot verknüpfte Speicher intakt. Um auch Speicher zu löschen, verwenden Sie die Snapshot-Deinstallation.

snapshot-disk-list

xe snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]
<!--NeedCopy-->

Listet die Datenträger der ausgewählten VM(s) auf.

snapshot-export-to-template

xe snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid  [preserve-power-state=true|false]
<!--NeedCopy-->

Exportiert einen Snapshot in den Dateinamen.

snapshot-reset-powerstate

xe snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->

Erzwingt das Anhalten des VM-Energiezustands nur in der Datenbank des Management-Toolstack. Dieser Befehl wird verwendet, um einen Snapshot wiederherzustellen, der als “angehalten” markiert ist. Dies ist ein potenziell gefährlicher Vorgang: Sie müssen sicherstellen, dass Sie das Speicherimage nicht mehr benötigen. Sie können Ihren Snapshot nicht mehr fortsetzen.

snapshot-revert

xe snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]
<!--NeedCopy-->

Setzt eine vorhandene VM in einen früheren Checkpoint- oder Snapshot-Zustand zurück.

snapshot-uninstall

xe snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]
<!--NeedCopy-->

Deinstalliert einen Schnappschuss Durch diesen Vorgang werden die VDIs zerstört, die als RW gekennzeichnet sind und nur mit diesem Snapshot verbunden sind. Um den VM-Datensatz einfach zu löschen, verwenden Sie Snapshot-Zerstören.

SR-Befehle

Befehle zur Steuerung von SRs (Speicherrepositories).

Die SR-Objekte können mit dem Standard-Objektauflistungsbefehl (xe sr-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

SR-Parameter

SRs haben die folgenden Parameter:

sr-create

xe sr-create name-label=name physical-size=size type=type content-type=content_type device-config:config_name=value [host-uuid=host_uuid] [shared=true|false]
<!--NeedCopy-->

Erstellt ein SR auf dem Datenträger, führt es in die Datenbank ein und erstellt eine PBD, die das SR an den Citrix Hypervisor-Server anhängt. Wenn shared auf true festgelegt ist, wird für jeden Citrix Hypervisor-Server im Pool eine PBD erstellt. Wenn shared nicht angegeben oder auf false festgelegt ist, wird eine PBD nur für den mit host-uuid angegebenen Citrix Hypervisor-Server erstellt.

Die genauen Parameter device-config unterscheiden sich je nach type für das Gerät. Einzelheiten zu diesen Parametern in den verschiedenen Speicher-Back-Ends finden Sie unter SR erstellen.

sr-data-source-forget

xe sr-data-source-forget data-source=data_source
<!--NeedCopy-->

Beenden Sie die Aufzeichnung der angegebenen Datenquelle für ein SR und vergessen Sie alle aufgezeichneten Daten.

sr-data-source-list

xe sr-data-source-list
<!--NeedCopy-->

Listen Sie die Datenquellen auf, die für ein SR aufgezeichnet werden können.

sr-data-source-query

xe sr-data-source-query data-source=data_source
<!--NeedCopy-->

Fragen Sie den zuletzt aus einer SR-Datenquelle gelesenen Wert ab.

sr-data-source-record

xe sr-data-source-record  data-source=data_source
<!--NeedCopy-->

Notieren Sie die angegebene Datenquelle für ein SR.

sr-destroy

xe sr-destroy uuid=sr_uuid
<!--NeedCopy-->

Zerstört das angegebene SR auf dem Citrix Hypervisor-Server.

sr-enable-database-replication

xe sr-enable-database-replication uuid=sr_uuid
<!--NeedCopy-->

Ermöglicht die XAPI-Datenbankreplikation auf das angegebene (gemeinsame) SR.

sr-disable-database-replication

xe sr-disable-database-replication uuid=sr_uuid
<!--NeedCopy-->

Deaktiviert die XAPI-Datenbankreplikation auf das angegebene SR.

sr-forget

xe sr-forget uuid=sr_uuid
<!--NeedCopy-->

Der XAPI-Agent vergisst ein angegebenes SR auf dem Citrix Hypervisor-Server. Wenn der XAPI-Agent ein SR vergisst, wird das SR getrennt und Sie können nicht auf VDIs darauf zugreifen, aber es bleibt auf dem Quellmedium intakt (die Daten gehen nicht verloren).

sr-introduce

xe sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid
<!--NeedCopy-->

Platziert einfach einen SR-Datensatz in die Datenbank. Verwenden Sie device-config, um zusätzliche Parameter im Format device-config:parameter_key=parameter_value anzugeben, zum Beispiel:

xe sr-introduce device-config:device=/dev/sdb1
<!--NeedCopy-->

Hinweis:

Dieser Befehl wird niemals im Normalbetrieb verwendet. Dieser erweiterte Vorgang kann nützlich sein, wenn ein SR nach seiner Erstellung als freigegeben neu konfiguriert werden muss oder um die Wiederherstellung nach verschiedenen Ausfallszenarien zu unterstützen.

sr-probe

xe sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]
<!--NeedCopy-->

Führt einen Scan des Back-End mit den bereitgestellten device-config-Schlüsseln durch. Wenn device-config für das SR-Backend abgeschlossen ist, gibt dieser Befehl eine Liste der SRs zurück, die auf dem Gerät vorhanden sind, falls vorhanden. Wenn die Parameter device-config nur teilweise sind, wird ein Back-End-spezifischer Scan durchgeführt, der Ergebnisse liefert, die Sie bei der Verbesserung der verbleibenden Parameter device-config anleiten. Die Scanergebnisse werden als XML-spezifisch für das Backend zurückgegeben und auf der CLI gedruckt.

Die genauen Parameter device-config unterscheiden sich je nach type für das Gerät. Einzelheiten zu diesen Parametern in den verschiedenen Speicher-Backends finden Sie unter Speicher.

sr-probe-ext

xe sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]
<!--NeedCopy-->

Führen Sie eine Speichersonde durch. Die Gerätekonfigurationsparameter können beispielsweise durch device-config:devs=/dev/sdb1 angegeben werden. Im Gegensatz zu sr-probe gibt dieser Befehl Ergebnisse in demselben menschenlesbaren Format für jeden SR-Typ zurück.

sr-scan

xe sr-scan uuid=sr_uuid
<!--NeedCopy-->

Erzwingt einen SR-Scan und synchronisiert die XAPI-Datenbank mit VDIs, die im zugrunde liegenden Speichersubstrat vorhanden sind.

sr-update

xe sr-update uuid=uuid
<!--NeedCopy-->

Aktualisieren Sie die Felder des SR-Objekts in der Datenbank.

lvhd-enable-thin-provisioning

xe lvhd-enable-thin-provisioning  sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum
<!--NeedCopy-->

Ermöglichen Sie Thin-Provisioning auf einem LVHD-SR.

Subject-Befehle

Befehle zum Arbeiten mit Themen.

session-subject-identifier-list

xe session-subject-identifier-list
<!--NeedCopy-->

Gibt eine Liste aller Benutzersubjekt-IDs aller extern authentifizierten vorhandenen Sitzungen zurück.

session-subject-identifier-logout

xe session-subject-identifier-logout subject-identifier=subject_identifier
<!--NeedCopy-->

Melden Sie alle extern authentifizierten Sitzungen ab, die mit einer Benutzersubjekt-ID verknüpft sind.

session-subject-identifier-logout-all

xe session-subject-identifier-logout-all
<!--NeedCopy-->

Melden Sie alle extern authentifizierten Sitzungen ab.

subject-add

xe subject-add subject-name=subject_name
<!--NeedCopy-->

Fügen Sie der Liste der Themen, die auf den Pool zugreifen können, einen Betreff hinzu.

subject-remove

xe subject-remove subject-uuid=subject_uuid
<!--NeedCopy-->

Entfernt einen Betreff aus der Liste der Themen, die auf den Pool zugreifen können.

subject-role-add

xe subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->

Fügt einem Betreff eine Rolle hinzu.

subject-role-remove

xe subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]
<!--NeedCopy-->

Entfernt eine Rolle aus einem Betreff.

secret-create

xe secret-create value=value
<!--NeedCopy-->

Erstelle ein Geheimnis.

secret-destroy

xe secret-destroy uuid=uuid
<!--NeedCopy-->

Zerstöre ein Geheimnis.

Task-Befehle

Befehle zum Arbeiten mit langwierigen asynchronen Aufgaben. Bei diesen Befehlen handelt es sich um Aufgaben wie das Starten, Stoppen und Anhalten einer virtuellen Maschine. Die Aufgaben bestehen normalerweise aus einer Reihe anderer atomarer Unteraufgaben, die zusammen den angeforderten Vorgang ausführen.

Die Aufgabenobjekte können mit dem Standardbefehl für die Objektauflistung (xe task-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Parameter der Aufgabe

Aufgaben haben folgende Parameter:

task-cancel

xe task-cancel [uuid=task_uuid]
<!--NeedCopy-->

Weisen Sie die angegebene Aufgabe an, abzubrechen und zurückzukehren.

Template-Befehle

Befehle zum Arbeiten mit VM-Vorlagen.

Vorlagen sind im Wesentlichen VMs, bei denen der Parameter is-a-template auf true festgelegt ist. Eine Vorlage ist ein “Gold-Image”, das alle verschiedenen Konfigurationseinstellungen enthält, um eine bestimmte VM zu instanziieren. Citrix Hypervisor wird mit einem Basissatz von Vorlagen geliefert, bei denen es sich um generische “rohe” VMs handelt, mit denen eine Installations-CD eines Betriebssystemanbieters gestartet werden kann (z. B.: RHEL, CentOS, SLES, Windows). Sie können VMs erstellen, sie in Standardformularen für Ihre speziellen Anforderungen konfigurieren und eine Kopie davon als Vorlagen für die zukünftige Verwendung in der VM-Bereitstellung speichern.

Die Vorlagenobjekte können mit dem Standardbefehl für die Objektauflistung (xe template-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Hinweis:

Vorlagen können nicht direkt in VMs konvertiert werden, indem Sie den Parameter is-a-template auf false festlegen. Das Festlegen des Parameters is-a-template auf false wird nicht unterstützt und führt zu einer VM, die nicht gestartet werden kann.

Parameter der VM-Vorlage

Vorlagen haben die folgenden Parameter:

• uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die Vorlage
• name-label (lesen/schreiben) den Namen der Vorlage
• name-description (lesen/schreiben) die Beschreibungszeichenfolge der Vorlage
• user-version (Lese-/Schreib-) Zeichenfolge für Ersteller von VMs und Vorlagen zum Ablegen von Versionsinformationen

• is-a-template (Lesen/Schreiben) true, wenn diese VM eine Vorlage ist. Vorlagen-VMs können niemals gestartet werden, sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf “true” gesetzt wurde, kann er nicht auf “false” zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in virtuelle Rechner umgewandelt werden.

  Sie können eine VM in eine Vorlage konvertieren mit:

   xe vm-param-set uuid=<vm uuid> is-a-template=true
   <!--NeedCopy-->
  

• is-control-domain (schreibgeschützt) true, wenn dies eine Steuerdomäne (Domäne 0 oder eine Treiberdomäne) ist
• power-state (schreibgeschützt) aktueller Energiezustand. Der Wert wird für eine Vorlage immer angehalten
• memory-dynamic-max (schreibgeschützt) dynamischer maximaler Speicher in Byte. Derzeit nicht verwendet, aber wenn geändert, muss die folgende Einschränkung eingehalten werden: memory_static_max >= memory_dynamic_max >= memory_dynamic_min >= memory_static_min.
• memory-dynamic-min (Lesen/Schreiben) dynamischer Mindestspeicher in Byte. Derzeit nicht verwendet, aber wenn geändert, müssen die gleichen Einschränkungen wie für memory-dynamic-max eingehalten werden.
• memory-static-max (Lesen/Schreiben) setzt statisch (absolut) maximalen Speicher in Byte. Dieses Feld ist der Hauptwert, der verwendet wird, um die Größe des Speichers zu bestimmen, der einer VM zugewiesen ist.
• memory-static-min (Lesen/Schreiben) setzt statisch (absolut) Mindestspeicher in Byte. Dieses Feld stellt den absoluten Mindestspeicher dar und memory-static-min muss kleiner als memory-static-max sein. Dieser Wert wird im Normalbetrieb nicht verwendet, aber die vorherige Einschränkung muss eingehalten werden.
• suspend-VDI-uuid (schreibgeschützt) der VDI, auf dem ein Suspend-Image gespeichert ist (hat keine Bedeutung für eine Vorlage)

• VCPUs-params (Zuordnungsparameter lesen/schreiben) für die ausgewählte vCPU-Richtlinie.

  Sie können das Pinning einer vCPU tunen mit:

   xe template-param-set uuid=<template_uuid> vCPUs-params:mask=1,2,3
   <!--NeedCopy-->
  

  Eine mit dieser Vorlage erstellte VM wird nur auf den physischen CPUs 1, 2 und 3 ausgeführt.

  Sie können auch die vCPU-Priorität (Xen-Planung) mit den Cap- und Gewicht-Parametern optimieren. Beispiel:

   xe template-param-set uuid=<template_uuid> VCPUs-params:weight=512 xe template-param-set uuid=<template_uuid> VCPUs-params:cap=100
   <!--NeedCopy-->
  

  Eine VM, die auf dieser Vorlage mit einem Gewicht von 512 basiert, erhält doppelt so viel CPU wie eine Domäne mit einem Gewicht von 256 auf einem umstrittenen Host. Die zulässigen Gewichte reichen von 1 bis 65535 und die Standardeinstellung ist 256.

  Die Obergrenze legt optional die maximale Menge an CPU fest, die eine auf dieser Vorlage basierende VM verbrauchen kann, selbst wenn der Citrix Hypervisor-Server CPU-Zyklen im Leerlauf hat. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 sind 4 CPUs usw. Der Standardwert 0 bedeutet, dass es keine Obergrenze gibt.

• VCPUs-max (Lesen/Schreiben) maximale Anzahl von vCPUs
• VCPUs-at-startup (Lesen/Schreiben) Startnummer der vCPUs
• actions-after-crash (Lese-/Schreib-) Aktion, die ausgeführt werden muss, wenn eine auf dieser Vorlage basierende VM abstürzt
• console-uuids (schreibgeschützte eingestellte Parameter) virtuelle Konsolengeräte

• platform (Map-Parameter lesen/schreiben) plattformspezifische Konfiguration

  So deaktivieren Sie die Emulation eines Parallelports für HVM-Gäste (z. B. Windows-Gäste):

   xe vm-param-set uuid=<vm_uuid> platform:parallel=none
   <!--NeedCopy-->
  

  So deaktivieren Sie die Emulation einer seriellen Port für HVM-Gäste:

   xe vm-param-set uuid=<vm_uuid> platform:hvm_serial=none
   <!--NeedCopy-->
  

  So deaktivieren Sie die Emulation eines USB-Controllers und eines USB-Tablet-Geräts für HVM-Gäste:

   xe vm-param-set uuid=<vm_uuid> platform:usb=false
   xe vm-param-set uuid=<vm_uuid> platform:usb_tablet=false
   <!--NeedCopy-->
  

• allowed-operations (schreibgeschützt eingestellter Parameter) Liste der in diesem Zustand zulässigen Operationen
• current-operations (schreibgeschützter Set-Parameter) Liste der Vorgänge, die derzeit auf dieser Vorlage ausgeführt werden
• allowed-VBD-devices (schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VBD-Identifikatoren, dargestellt durch Ganzzahlen im Bereich 0—15. Diese Liste dient nur zur Information und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
• allowed-VIF-devices (schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VIF-Identifikatoren, dargestellt durch Ganzzahlen im Bereich 0—15. Diese Liste dient nur zur Information und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
• HVM-boot-policy (Lesen/Schreiben) der Boot-Richtlinie für HVM-Gäste. Entweder BIOS Order oder eine leere Zeichenfolge.
• HVM-boot-params (Zuordnungsparameter lesen/schreiben) Der Ordnungsschlüssel steuert die Startreihenfolge des HVM-Gastes, dargestellt als Zeichenfolge, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für den Stammdatenträger und n für den Netzwerk-PXE-Start. Die Standardeinstellung ist Gleichstrom.
• PV-kernel (lesen/schreiben) Pfad zum Kernel
• PV-ramdisk (lesen/schreiben) Pfad zum initrd
• PV-args (lesen/schreiben) Zeichenfolge von Kernel-Befehlszeilenargumenten
• PV-legacy-args (Lese-/Schreib) Zeichenfolge von Argumenten, um Legacy-VMs basierend auf dieser Vorlage zum Booten zu bringen
• PV-bootloader (lesen/schreiben) Name oder Pfad zum Bootloader
• PV-bootloader-args (lesen/schreiben) Zeichenfolge mit verschiedenen Argumenten für den Bootloader
• last-boot-CPU-flags (schreibgeschützt) beschreibt die CPU-Flags, auf denen eine auf dieser Vorlage basierende VM zuletzt gebootet wurde; nicht für eine Vorlage aufgefüllt
• resident-on (schreibgeschützt) der Citrix Hypervisor-Server, auf dem eine auf dieser Vorlage basierende VM residiert ist. Erscheint als not in database für eine Vorlage
• affinity (Lesen/Schreiben) der Citrix Hypervisor-Server, auf dem eine auf dieser Vorlage basierende VM bevorzugt ausgeführt werden soll. Wird vom Befehl xe vm-start verwendet, um zu entscheiden, wo die VM ausgeführt werden soll.
• other-config (Map-Parameter mit Lese-/Schreibzugriff) Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die Vorlage angeben
• start-time (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine VM basierend auf dieser Vorlage gelesen wurden, in der Form yyyymmddThh:mm:ss z, wobei z die militärische Zeitzonenanzeige mit einem Buchstaben ist, z. B. Z für UTC (GMT). Legen Sie für eine Vorlage auf 1 Jan 1970 Z (Anfang Unix/POSIX-Epoche) fest
• install-time (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine VM basierend auf dieser Vorlage gelesen wurden, in der Form yyyymmddThh:mm:ss z, wobei z die militärische Zeitzonenanzeige mit einem Buchstaben ist, z. B. Z für UTC (GMT). Legen Sie für eine Vorlage auf 1 Jan 1970 Z (Anfang Unix/POSIX-Epoche) fest
• memory-actual (schreibgeschützt) der tatsächliche Speicher, der von einer VM basierend auf dieser Vorlage verwendet wird; 0 für eine Vorlage
• VCPUs-number (schreibgeschützt) die Anzahl der virtuellen CPUs, die einer VM basierend auf dieser Vorlage zugewiesen wurden; 0 für eine Vorlage
• VCPUs-Utilization (schreibgeschützter Map-Parameter) Liste der virtuellen CPUs und deren Gewichtung schreibgeschützter Zuordnungsparameter os-version Die Version des Betriebssystems für eine VM, die auf dieser Vorlage basiert. Erscheint als not in database für eine Vorlage
• PV-drivers-version (schreibgeschützter Zuordnungsparameter) die Versionen der paravirtualisierten Treiber für eine VM, die auf dieser Vorlage basieren. Erscheint als not in database für eine Vorlage
• PV-drivers-detected (schreibgeschützt) für die neueste Version der paravirtualisierten Treiber für eine auf dieser Vorlage basierende VM. Erscheint als not in database für eine Vorlage
• memory (schreibgeschützter Zuordnungsparameter) Speichermetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet wurden. Erscheint als not in database für eine Vorlage
• disks (schreibgeschützter Zuordnungsparameter) Datenträgermetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet wurden. Erscheint als not in database für eine Vorlage
• networks (schreibgeschützter Zuordnungsparameter) Netzwerkmetriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet wurden. Erscheint als not in database für eine Vorlage
• other (schreibgeschützter Zuordnungsparameter) andere Metriken, die vom Agent auf einer VM basierend auf dieser Vorlage gemeldet wurden. Erscheint als not in database für eine Vorlage
• guest-metrics-last-updated (schreibgeschützt) Zeitstempel, an dem der Gast-Agent den letzten Schreibvorgang in diese Felder ausgeführt hat. In dem Formular yyyymmddThh:mm:ss z, wobei z die militärische Zeitzonenanzeige mit einem Buchstaben ist, z. B. Z für UTC (GMT)
• actions-after-shutdown (Lesen/Schreiben) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
• actions-after-reboot (Lesen/Schreiben) Aktion, die nach dem Neustart der VM ausgeführt werden soll
• possible-hosts (schreibgeschützt) Liste der Hosts, die die VM potenziell hosten können
• HVM-shadow-multiplier (Lese-/Schreib-) Multiplikator, der auf die Menge an Schatten angewendet wird, die dem Gast zur Verfügung gestellt wird
• dom-id (schreibgeschützt) Domänen-ID (falls verfügbar, andernfalls -1)
• recommendations (schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
• xenstore-data ( Read/Write Map-Parameter) Daten, die nach dem Erstellen der VM in die Struktur xenstore (/local/domain/*domid*/vmdata) eingefügt werden.
• is-a-snapshot (schreibgeschützt) True, wenn diese Vorlage ein VM-Snapshot ist
• snapshot_of (schreibgeschützt) die UUID der VM, von der diese Vorlage ein Snapshot ist
• snapshots (schreibgeschützt) die UUIDs aller Snapshots, die von dieser Vorlage erstellt wurden
• snapshot_time (schreibgeschützt) der Zeitstempel des zuletzt aufgenommenen VM-Snapshots
• memory-target (schreibgeschützt) die für diese Vorlage festgelegte Zielspeichermenge
• blocked-operations (Map-Parameter mit Lese-/Schreibzugriff) listet die Vorgänge auf, die mit dieser Vorlage nicht ausgeführt werden können
• last-boot-record (schreibgeschützt) Aufzeichnung der letzten Bootparameter für diese Vorlage im XML-Format
• ha-always-run (Lesen/Schreiben) True, wenn eine Instanz dieser Vorlage immer auf einem anderen Host neu gestartet wird, wenn der Host, auf dem sie ansässig ist, ausfällt. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restartpriority.
• ha-restart-priority (schreibgeschützt) Neustart oder Bestleistung Lese-/Schreibblobs binärer Datenspeicher
• live (schreibgeschützt) nur für eine laufende VM relevant.

template-export

xe template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template
<!--NeedCopy-->

Exportiert eine Kopie einer angegebenen Vorlage in eine Datei mit dem angegebenen neuen Dateinamen.

template-uninstall

xe template-uninstall template-uuid=template_uuid [--force]
<!--NeedCopy-->

Deinstallieren Sie eine benutzerdefinierte Vorlage. Dieser Vorgang zerstört die VDIs, die als “Eigentum” dieser Vorlage markiert sind.

Befehle aktualisieren

Der folgende Abschnitt enthält Befehle zum Aktualisieren des Citrix Hypervisor-Servers.

das Update sobjekte können mit dem Standardbefehl für die Objektauflistung (xe update-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

Parameter aktualisieren

Citrix Hypervisor-Serverupdates haben die folgenden Parameter:

update-upload

xe update-upload file-name=update_filename
<!--NeedCopy-->

Laden Sie eine angegebene Aktualisierungsdatei auf den Citrix Hypervisor-Server hoch. Dieser Befehl bereitet ein anzuwendendes Update vor. Bei Erfolg wird die UUID des hochgeladenen Updates gedruckt. Wenn das Update zuvor hochgeladen wurde, wird stattdessen ein Fehler UPDATE_ALREADY_EXISTS zurückgegeben und der Patch wird nicht erneut hochgeladen.

update-precheck

xe update-precheck uuid=update_uuid host-uuid=host_uuid
<!--NeedCopy-->

Führen Sie die im angegebenen Update enthaltenen Vorprüfungen auf dem angegebenen Citrix Hypervisor-Server aus.

update-destroy

xe update-destroy uuid=update_file_uuid
<!--NeedCopy-->

Löscht ein Updatesdatei, die nicht aus dem Pool angewendet wurde. Kann verwendet werden, um ein Updatesdatei zu löschen, die nicht auf die Hosts angewendet werden kann.

update-apply

xe update-apply host-uuid=host_uuid uuid=update_file_uuid
<!--NeedCopy-->

Wendet die angegebene Update datei an.

update-pool-apply

xe update-pool-apply uuid=update_uuid
<!--NeedCopy-->

Wenden Sie das angegebene Update auf alle Citrix Hypervisor-Server im Pool an.

update-introduce

xe update-introduce vdi-uuid=vdi_uuid
<!--NeedCopy-->

Einführung des Update-VDI.

update-pool-clean

xe update-pool-clean uuid=uuid
<!--NeedCopy-->

Entfernt die Dateien des Updates von allen Hosts im Pool.

Benutzer-Befehle

user-password-change

xe user-password-change old=old_password new=new_password
<!--NeedCopy-->

Ändert das Kennwort des angemeldeten Benutzers. Das alte Kennwortfeld ist nicht aktiviert, da Sie für die Verwendung dieses Befehls Supervisor-Privileg benötigen.

VBD-Befehle

Befehle zum Arbeiten mit VBDs (Virtual Block Devices).

Eine VBD ist ein Softwareobjekt, das eine VM mit dem VDI verbindet, der den Inhalt des virtuellen Laufwerks darstellt. Die VBD hat die Attribute, die den VDI mit der VM verknüpfen (ist er bootfähig, seine Lese-/Schreibmetriken usw.). Der VDI enthält Informationen zu den physikalischen Attributen des virtuellen Laufwerks (welcher SR-Typ, ob der Datenträger gemeinsam genutzt werden kann, ob das Medium schreibgeschützt oder schreibgeschützt ist usw.).

Die VBD-Objekte können mit dem Standard-Objektauflistungsbefehl (xe vbd-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

VBD-Parameter

VBDs haben die folgenden Parameter:

vbd-create

xe vbd-create vm-uuid=uuid_of_the_vm device=device_value vdi-uuid=uuid_of_vdi_to_connect_to [bootable=true] [type=Disk|CD] [mode=RW|RO]
<!--NeedCopy-->

Erstellen Sie eine VBD auf einer VM.

Die zulässigen Werte für das device-Feld sind Ganzzahlen 0-15, und die Zahl muss für jede VM eindeutig sein. Die aktuell zulässigen Werte können im Parameter allowed-VBD-devices auf der angegebenen VM angezeigt werden. Dies wird als userdevice in den Parametern vbd gesehen.

Wenn type auf Disk gesetzt ist, ist vdi-uuid erforderlich. Der Modus kann RO oder RW für einen Datenträger sein.

Wenn type auf CD gesetzt ist, ist vdi-uuid optional. Wenn kein VDI angegeben ist, wird eine leere VBD für die CD erstellt. Der Modus muss RO für eine CD sein.

vbd-destroy

xe vbd-destroy uuid=uuid_of_vbd
<!--NeedCopy-->

Zerstört die angegebene VBD.

Wenn der Parameter other-config:owner für die VBD auf true eingestellt ist, wird auch der zugehörige VDI zerstört.

vbd-eject

xe vbd-eject uuid=uuid_of_vbd
<!--NeedCopy-->

Entfernen Sie das Medium aus dem Laufwerk, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn das Medium vom Typ eines Wechselmediums ist (eine physische CD oder ein ISO). Andernfalls wird eine Fehlermeldung VBD_NOT_REMOVABLE_MEDIA zurückgegeben.

vbd-insert

xe vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media
<!--NeedCopy-->

Legen Sie neue Medien in das durch eine VBD dargestellte Laufwerk ein. Dieser Befehl funktioniert nur, wenn das Medium vom Typ eines Wechselmediums ist (eine physische CD oder ein ISO). Andernfalls wird eine Fehlermeldung VBD_NOT_REMOVABLE_MEDIA zurückgegeben.

vbd-plug

xe vbd-plug uuid=uuid_of_vbd
<!--NeedCopy-->

Versuchen Sie, die VBD anzuhängen, während sich die VM im laufenden Zustand befindet.

vbd-unplug

xe vbd-unplug uuid=uuid_of_vbd
<!--NeedCopy-->

Versucht, die VBD von der VM zu trennen, während sie sich im laufenden Zustand befindet.

VDI-Befehle

Befehle für die Arbeit mit VDIs (Virtual Disk Images).

Ein VDI ist ein Softwareobjekt, das den Inhalt des virtuellen Laufwerks darstellt, das von einer VM gesehen wird. Dies unterscheidet sich von der VBD, bei der es sich um ein Objekt handelt, das eine VM an den VDI bindet. Der VDI enthält Informationen zu den physikalischen Attributen des virtuellen Laufwerks (welcher SR-Typ, ob der Datenträger gemeinsam genutzt werden kann, ob das Medium schreibgeschützt oder schreibgeschützt ist usw.). Die VBD hat die Attribute, die den VDI mit der VM verknüpfen (ist er bootfähig, seine Lese-/Schreibmetriken usw.).

Die VDI-Objekte können mit dem Standard-Objektauflistungsbefehl (xe vdi-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

VDI-Parameter

VDIs haben die folgenden Parameter:

vdi-clone

xe vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]
<!--NeedCopy-->

Erstellen Sie eine neue, beschreibbare Kopie des angegebenen VDI, die direkt verwendet werden kann. Es ist eine Variante davon vdi-copy, die Hochgeschwindigkeits-Image-Klon-Funktionen verfügbar machen kann, wo sie existieren.

Verwenden Sie den optionalen Zuordnungsparameter driver-params, um zusätzliche herstellerspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem der VDI basiert. Weitere Informationen finden Sie in der Treiberdokumentation des Speicheranbieters.

vdi-copy

xe vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr
<!--NeedCopy-->

Kopieren Sie einen VDI auf ein angegebenes SR.

vdi-create

xe vdi-create sr-uuid=uuid_of_sr_to_create_vdi_on name-label=name_for_the_vdi type=system|user|suspend|crashdump virtual-size=size_of_virtual_disk sm-config-*=storage_specific_configuration_data
<!--NeedCopy-->

Erstellen Sie einen VDI.

Der Parameter virtual-size kann in Byte oder mit den IEC-Standardsuffixen KiB, MiB, GiB und TiB angegeben werden.

Hinweis:

SR-Typen, die Thin Provisioning von Datenträgern unterstützen (z. B. Local VHD und NFS), erzwingen keine virtuelle Zuweisung von Datenträgern. Seien Sie vorsichtig, wenn Sie virtuellen Speicherplatz auf einem SR mehrfach zuweisen. Wenn ein zu mehrfach zugewiesenes SR voll wird, muss Speicherplatz entweder auf dem SR-Zielsubstrat oder durch Löschen nicht verwendeter VDIs in dem SR verfügbar gemacht werden.

Einige SR-Typen runden den Wert virtual-size möglicherweise auf, um ihn durch eine konfigurierte Blockgröße teilbar zu machen.

vdi-data-destroy

xe vdi-data-destroy uuid=uuid_of_vdi
<!--NeedCopy-->

Löschen Sie die mit dem angegebenen VDI verknüpften Daten, behalten Sie jedoch die Metadaten für das Tracking geänderter Blocks bei.

Hinweis:

Wenn Sie Changed-Block-Tracking verwenden, um inkrementelle Backups des VDI zu erstellen, stellen Sie sicher, dass Sie den Befehl vdi-data-destroy verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie vdi-destroy nicht für Snapshots von VDIs, bei denen das Tracking geänderter Blocks aktiviert wurde.

vdi-destroy

xe vdi-destroy uuid=uuid_of_vdi
<!--NeedCopy-->

Zerstört den angegebenen VDI.

Hinweis:

Wenn Sie Changed-Block-Tracking verwenden, um inkrementelle Backups des VDI zu erstellen, stellen Sie sicher, dass Sie den Befehl vdi-data-destroy verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie vdi-destroy nicht für Snapshots von VDIs, bei denen das Tracking geänderter Blocks aktiviert wurde.

Bei lokalen VHD- und NFS-SR-Typen wird Speicherplatz nicht sofort mit vdi-destroy freigegeben, sondern sporadisch während eines Speicherrepositoryscanvorgangs. Wenn Sie die Bereitstellung von gelöschtem Speicherplatz erzwingen müssen, rufen Sie sr-scan manuell auf.

vdi-disable-cbt

xe vdi-disable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->

Deaktivieren Sie das Tracking geänderter Blocks für den VDI.

vdi-enable-cbt

xe vdi-enable-cbt uuid=uuid_of_vdi
<!--NeedCopy-->

Aktivieren Sie das Tracking geänderter Blocks für den VDI.

Hinweis:

Sie können das Tracking geänderter Blocks nur für lizenzierte Instanzen von Citrix Hypervisor Premium Edition aktivieren.

vdi-export

xe vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi] [--progress]
<!--NeedCopy-->

Exportiert einen VDI in den angegebenen Dateinamen. Sie können einen VDI in einem der folgenden Formate exportieren:

• raw
• vhd

Das VHD-Format kann sparse sein. Wenn innerhalb des VDI nicht zugewiesene Blöcke vorhanden sind, werden diese Blöcke möglicherweise in der VHD-Datei weggelassen, wodurch die VHD-Datei kleiner wird. Sie können von allen unterstützten VHD-basierten Speichertypen (EXT3/EXT4, NFS) in das VHD-Format exportieren.

Wenn Sie den Parameter base angeben, exportiert dieser Befehl nur die Blöcke, die sich zwischen dem exportierten VDI und dem Basis-VDI geändert haben.

vdi-forget

xe vdi-forget uuid=uuid_of_vdi
<!--NeedCopy-->

Entfernt bedingungslos einen VDI-Record aus der Datenbank, ohne das Speicher-Backend zu berühren. Verwenden Sie im Normalbetrieb stattdessen vdi-destroy.

vdi-import

xe vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]
<!--NeedCopy-->

Importieren Sie ein VDI. Sie können einen VDI aus einem der folgenden Formate importieren:

• raw
• vhd

vdi-introduce

xe vdi-introduce uuid=uuid_of_vdi sr-uuid=uuid_of_sr name-label=name_of_new_vdi type=system|user|suspend|crashdump location=device_location_(varies_by_storage_type) [name-description=description_of_vdi] [sharable=yes|no] [read-only=yes|no] [other-config=map_to_store_misc_user_specific_data] [xenstore-data=map_to_of_additional_xenstore_keys] [sm-config=storage_specific_configuration_data]
<!--NeedCopy-->

Erstellen Sie ein VDI-Objekt, das ein vorhandenes Speichergerät darstellt, ohne tatsächlich Speicher zu ändern oder zu erstellen. Dieser Befehl wird hauptsächlich intern verwendet, um Hot-Plug-Speichergeräte automatisch einzuführen.

vdi-list-changed-blocks

xe vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid
<!--NeedCopy-->

Vergleichen Sie zwei VDIs und geben Sie die Liste der Blöcke, die sich zwischen den beiden geändert haben, als Base64-codierte Zeichenfolge zurück. Dieser Befehl funktioniert nur für VDIs, bei denen das Tracking geänderter Blocks aktiviert wurde.

Weitere Informationen finden Sie unter Tracking geänderter Blocks.

vdi-pool-migrate

xe vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid
<!--NeedCopy-->

Migrieren Sie einen VDI zu einem angegebenen SR, während der VDI an einen laufenden Gast angeschlossen ist. (Speicher-Livemigration)

Weitere Informationen finden Sie unter Migrieren von virtuellen Rechnern.

vdi-resize

xe vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk
<!--NeedCopy-->

Ändern Sie die Größe des durch UUID angegebenen VDI.

vdi-snapshot

xe vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]
<!--NeedCopy-->

Erstellt eine Lese-/Schreibversion eines VDI, die als Referenz für Backup- oder Vorlagenerstellungszwecke oder beides verwendet werden kann. Verwenden Sie den Snapshot, um eine Backup durchzuführen, anstatt Backupsoftware innerhalb der VM zu installieren und auszuführen. Die VM wird weiterhin ausgeführt, während externe Backupsoftware den Inhalt des Snapshots auf das Backupmedium streamt. In ähnlicher Weise kann ein Snapshot als “Goldenes Image” verwendet werden, auf dem eine Vorlage basiert. Eine Vorlage kann mit beliebigen VDIs erstellt werden.

Verwenden Sie den optionalen Zuordnungsparameter driver-params, um zusätzliche herstellerspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem der VDI basiert. Weitere Informationen finden Sie in der Treiberdokumentation des Speicheranbieters.

Ein Klon eines Snapshots erzeugt immer einen beschreibbaren VDI.

vdi-unlock

xe vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]
<!--NeedCopy-->

Versucht, die angegebenen VDIs zu entsperren. Wenn force=true an den Befehl übergeben wird, erzwingt es den Entsperrvorgang.

vdi-update

xe vdi-update uuid=uuid
<!--NeedCopy-->

Aktualisieren Sie die Felder des VDI-Objekts in der Datenbank.

VIF-Befehle

Befehle zum Arbeiten mit VIFs (Virtual Network Interfaces).

Die VIF-Objekte können mit dem Standard-Objektauflistungsbefehl (xe vif-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

VIF-Parameter

VIFs haben die folgenden Parameter:

• uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für das VIF
• vm-uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die VM, auf der sich dieses VIF befindet
• vm-name-label (schreibgeschützt) der Name der VM, auf der sich dieses VIF befindet
• allowed-operations (schreibgeschützter Set-Parameter) eine Liste der in diesem Zustand zulässigen Vorgänge
• current-operations (schreibgeschützter Set-Parameter) eine Liste der Vorgänge, die derzeit auf diesem VIF ausgeführt werden
• device (schreibgeschützt) Integer-Label dieses VIF, das die Reihenfolge angibt, in der VIF-Backends erstellt wurden
• MAC (schreibgeschützt) MAC-Adresse von VIF, wie sie der VM ausgesetzt ist

• MTU (schreibgeschützt) Maximale Übertragungseinheit des VIF in Byte.

  Dieser Parameter ist schreibgeschützt, Sie können jedoch die MTU-Einstellung mit dem Schlüssel mtu überschreiben mit dem Map-Parameter other-config. Um beispielsweise die MTU auf einer virtuellen Netzwerkkarte zurückzusetzen, um Jumbo-Frames zu verwenden:

   xe vif-param-set \
       uuid=<vif_uuid> \
       other-config:mtu=9000
   <!--NeedCopy-->
  

• currently-attached (schreibgeschützt) true wenn das Gerät angeschlossen ist
• qos_algorithm_type (lesen/schreiben) zu verwendender QoS-Algorithmus
• qos_algorithm_params (Map-Parameter lesen/schreiben) für den ausgewählten QoS-Algorithmus
• qos_supported_algorithms (schreibgeschützter Set-Parameter) unterstützte QoS-Algorithmen für dieses VIF
• MAC-autogenerated (schreibgeschützt) True, wenn die MAC-Adresse des VIF automatisch generiert wurde
• other-config (Map-Parameter lesen/schreiben) Zusätzliche key:value-Konfigurationspaare
• other-config:ethtoolrx (Lesen/Schreiben) auf on setzen, um Prüfsumme empfangen zu können, aus zum Deaktivieren
• other-config:ethtooltx (Lesen/Schreiben) auf on gesetzt, um Prüfsumme zu übertragen, aus zum Deaktivieren
• other-config:ethtoolsg (Lesen/Schreiben) auf on setzen, um Scatter Gather zu aktivieren, aus zum Deaktivieren
• other-config:ethtooltso (Lesen/Schreiben) auf on gesetzt, um TCP-Segmentierungs-Offload zu ermöglichen, aus zum Deaktivieren
• other-config:ethtoolufo (Lesen/Schreiben) auf on gesetzt, um das Abladen von UDP-Fragmenten zu ermöglichen, aus zum Deaktivieren
• other-config:ethtoolgso (Lesen/Schreiben) auf on gesetzt, um generische Segmentierungsabladung zu ermöglichen, aus zum Deaktivieren
• other-config:promiscuous (Lesen/Schreiben) entspricht einem VIF, um auf der Brücke promiskuitiv zu sein, so dass es den gesamten Verkehr über die Brücke sieht. Nützlich zum Ausführen eines Intrusion Detection Systems (IDS) oder ähnlichem in einer VM.
• network-uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz des virtuellen Netzwerks, an das dieses VIF angeschlossen ist
• network-name-label (schreibgeschützt) der beschreibende Name des virtuellen Netzwerks, mit dem dieses VIF verbunden ist
• io_read_kbs (schreibgeschützt) durchschnittliche Leserate in KB/s für dieses VIF
• io_write_kbs (schreibgeschützt) durchschnittliche Schreibrate in KB/s für dieses VIF
• locking_mode (Lesen/Schreiben) Beeinflusst die Fähigkeit von VIFs, Datenverkehr zu/von einer Liste von MAC- und IP-Adressen zu filtern. Benötigt zusätzliche Parameter.

• locking_mode:default (Lesen/Schreiben) Variiert je nach Standardsperrmodus für das VIF-Netzwerk.

  Wenn der Standardsperrmodus auf festgelegt ist disabled, wendet Citrix Hypervisor eine Filterregel an, damit das VIF keinen Datenverkehr senden oder empfangen kann. Wenn der Standardsperrmodus auf festgelegt ist unlocked, entfernt Citrix Hypervisor alle mit dem VIF verknüpften Filterregeln. Weitere Informationen finden Sie unter Netzwerkbefehle.

• locking_mode:locked (Lesen/Schreiben) Im VIF ist nur Datenverkehr zulässig, der an oder von den angegebenen MAC- und IP-Adressen gesendet wird. Wenn keine IP-Adressen angegeben sind, ist kein Datenverkehr zulässig.
• locking_mode:unlocked (Lesen/Schreiben) Es werden keine Filter auf Datenverkehr angewendet, der zum oder vom VIF geht.
• locking_mode:disabled (Lesen/Schreiben) Citrix Hypervisor wendet eine Filterregel an, damit das VIF den gesamten Datenverkehr löscht.

vif-create

xe vif-create vm-uuid=uuid_of_the_vm device=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]
<!--NeedCopy-->

Erstellen Sie eine VIF auf einer VM.

Entsprechende Werte für das device-Feld sind im Parameter allowed-VIF-devices auf der angegebenen VM aufgeführt. Bevor dort VIFs existieren, sind die zulässigen Werte ganze Zahlen von 0-15.

Der Parameter mac ist die Standard-MAC-Adresse im Format aa:bb:cc:dd:ee:ff. Wenn Sie es nicht spezifiziert lassen, wird eine entsprechende zufällige MAC-Adresse erstellt. Sie können auch explizit eine zufällige MAC-Adresse festlegen, indem Sie angeben mac=random.

vif-destroy

xe vif-destroy uuid=uuid_of_vif
<!--NeedCopy-->

Zerstöre ein VIF.

vif-move

xe vif-move uuid=uuid network-uuid=network_uuid
<!--NeedCopy-->

Verschieben Sie das VIF in ein anderes Netzwerk.

vif-plug

xe vif-plug uuid=uuid_of_vif
<!--NeedCopy-->

Versuchen Sie, das VIF anzuhängen, während sich die VM im laufenden Zustand befindet.

vif-unplug

xe vif-unplug uuid=uuid_of_vif
<!--NeedCopy-->

Versucht, das VIF während der Ausführung von der VM zu trennen.

vif-configure-ipv4

Konfigurieren Sie IPv4-Einstellungen für diese virtuelle Schnittstelle. Stellen Sie die IPv4-Einstellungen wie folgt ein:

xe vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address
<!--NeedCopy-->

Beispiel:

VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")
<!--NeedCopy-->

Reinigen Sie die IPv4-Einstellungen wie folgt:

xe vif-configure-ipv4 uuid=uuid_of_vif mode=none
<!--NeedCopy-->

vif-configure-ipv6

Konfigurieren Sie IPv6-Einstellungen für diese virtuelle Schnittstelle. Stellen Sie die IPv6-Einstellungen wie folgt ein:

xe vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address
<!--NeedCopy-->

Beispiel:

VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")
<!--NeedCopy-->

Reinigen Sie die IPv6-Einstellungen wie folgt:

xe vif-configure-ipv6 uuid=uuid_of_vif mode=none
<!--NeedCopy-->

VLAN-Befehle

Befehle zum Arbeiten mit VLANs (virtuelle Netzwerke). Informationen zum Auflisten und Bearbeiten virtueller Schnittstellen finden Sie in den PIF-Befehlen, die über einen VLAN-Parameter verfügen, um zu signalisieren, dass sie über ein zugehöriges virtuelles Netzwerk verfügen. Weitere Informationen finden Sie unter PIF-Befehle. Um beispielsweise VLANs aufzulisten, verwenden Sie xe pif-list.

vlan-create

xe vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->

Erstellen Sie ein VLAN auf Ihrem Citrix Hypervisor-Server.

pool-vlan-create

xe pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network
<!--NeedCopy-->

Erstellen Sie ein VLAN auf allen Hosts in einem Pool, indem Sie festlegen, auf welcher Schnittstelle (z. B. eth0) sich das angegebene Netzwerk befindet (auf jedem Host) und ein neues PIF-Objekt an jedem Host entsprechend erstellen und einstecken.

vlan-destroy

xe vlan-destroy uuid=uuid_of_pif_mapped_to_vlan
<!--NeedCopy-->

Zerstöre ein VLAN. Benötigt die UUID des PIF, das das VLAN darstellt.

VM-Befehle

Befehle zur Steuerung von virtuellen Rechnern und ihren Attributen.

VM-Selektoren

Einige der hier aufgeführten Befehle haben einen gemeinsamen Mechanismus zum Auswählen einer oder mehrerer VMs, auf denen der Vorgang ausgeführt werden soll. Der einfachste Weg ist die Angabe des Arguments vm=name_or_uuid. Eine einfache Möglichkeit, die UUID einer tatsächlichen VM zu erhalten, besteht beispielsweise darin, auszuführen xe vm-list power-state=running. (Ruft die vollständige Liste der Felder ab, die mit dem Befehl xe vm-list params=all abgeglichen werden können.) Wenn Sie z. B. power-state=halted angeben, werden VMs ausgewählt, deren Parameter power-state gleich halted ist. Wenn mehrere VMs übereinstimmen, geben Sie die Option --multiple zum Ausführen des Vorgangs an. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben.

Die VM-Objekte können mit dem Standard-Objektauflistungsbefehl (xe vm-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

VM-Parameter

Virtuelle Rechner haben die folgenden Parameter:

Hinweis:

Alle beschreibbaren VM-Parameterwerte können geändert werden, während die VM ausgeführt wird, aber neue Parameter werden nicht dynamisch angewendet und können erst angewendet werden, wenn die VM neu gestartet wurde.

• appliance (Lesen/Schreiben) der Appliance/vApp, zu der die VM gehört
• uuid (schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die VM
• name-label (lesen/schreiben) der Name der VM
• name-description (lesen/schreiben) die Beschreibungszeichenfolge der VM
• order (Lesen/Schreiben) für das Starten/Herunterfahren der vApp und für den Start nach einem HA-Failover. VMs mit einem Ordnungswert von 0 (Null) werden zuerst gestartet, dann VMs mit einem Ordnungswert von 1 usw.
• version (schreibgeschützt) wie oft diese VM wiederhergestellt wurde. Wenn Sie eine neue VM mit einer älteren Version überschreiben möchten, rufen Sie vm-recover
• user-version (Lese-/Schreib-) Zeichenfolge für Ersteller von VMs und Vorlagen zum Ablegen von Versionsinformationen

• is-a-template (Lesen/Schreiben) False, sofern diese VM keine Vorlage ist. Vorlagen-VMs können nie gestartet werden, sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf true gesetzt wurde, kann er nicht auf false zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in virtuelle Rechner umgewandelt werden.

  Sie können eine VM in eine Vorlage konvertieren mit:

   xe vm-param-set uuid=<vm uuid> is-a-template=true
   <!--NeedCopy-->
  

• is-control-domain (schreibgeschützt) True, wenn dies eine Steuerdomäne (Domäne 0 oder eine Treiberdomäne) ist
• power-state (schreibgeschützt) aktueller Energiezustand
• start-delay (lesen/schreiben) Die Wartezeit, bis ein Aufruf zum Starten der VM dauert, kehrt in Sekunden zurück
• shutdown-delay (lesen/schreiben) Die Wartezeit, bis ein Aufruf zum Herunterfahren der VM dauert, kehrt in Sekunden zurück
• memory-dynamic-max (Lesen/Schreiben) dynamisches Maximum in Byte
• memory-dynamic-min (Lesen/Schreiben) dynamisches Minimum in Byte
• memory-static-max (Lesen/Schreiben) statisch gesetztes (absolutes) Maximum in Byte. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
• memory-static-min (Lesen/Schreiben) statisch gesetztes (absolutes) Minimum in Byte. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
• suspend-VDI-uuid (schreibgeschützt) der VDI, auf dem ein Suspend-Image gespeichert ist

• VCPUs-params (Zuordnungsparameter lesen/schreiben) für die ausgewählte vCPU-Richtlinie.

  Sie können das Pinning einer vCPU mit

   xe vm-param-set uuid=<vm_uuid> VCPUs-params:mask=1,2,3
   <!--NeedCopy-->
  

  Die ausgewählte VM läuft dann nur auf den physischen CPUs 1, 2 und 3. Sie können auch die vCPU-Priorität (Xen-Planung) mit den Cap- und Gewicht-Parametern optimieren. Beispiel:

   xe vm-param-set uuid=<vm_uuid> VCPUs-params:weight=512 xe vm-param-set uuid=<vm_uuid> VCPUs-params:cap=100
   <!--NeedCopy-->
  

  Eine VM mit einem Gewicht von 512 erhält auf einem umstrittenen Citrix Hypervisor-Server doppelt so viel CPU wie eine Domäne mit einem Gewicht von 256. Die zulässigen Gewichte reichen von 1 bis 65535 und die Standardeinstellung ist 256. Die Obergrenze legt optional die maximale Menge an CPU fest, die eine VM verbrauchen kann, selbst wenn der Citrix Hypervisor-Server CPU-Zyklen im Leerlauf hat. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 sind 4 CPUs usw. Der Standardwert 0 bedeutet, dass es keine Obergrenze gibt.

• VCPUs-max (Lesen/Schreiben) maximale Anzahl virtueller CPUs.
• VCPUs-at-startup (Lesen/Schreiben) Startnummer der virtuellen CPUs
• actions-after-crash (Lesen/Schreiben) Aktion, die ergriffen werden muss, wenn die VM abstürzt. Für PV-Gäste sind gültige Parameter:
  • preserve (nur zur Analyse)
  • coredump_and_restart (Coredump aufzeichnen und VM neu starten)
  • coredump_and_destroy (Coredump aufzeichnen und VM angehalten lassen)
  • restart (kein Coredump und Neustart der VM)
  • destroy (kein Coredump und VM verlassen angehalten)
• console-uuids (schreibgeschützte eingestellte Parameter) virtuelle Konsolengeräte

• platform (Map-Parameter lesen/schreiben) plattformspezifische Konfiguration

  Deaktivieren des VDA, um Windows 10 in den Tablet-Modus zu versetzen:

   xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=0
   <!--NeedCopy-->
  

  So ermöglichen Sie dem VDA, Windows 10 in den Tablet-Modus zu versetzen:

   xe vm-param-set uuid=<vm_uuid> platform:acpi_laptop_slate=1
   <!--NeedCopy-->
  

  Um den aktuellen Status zu überprüfen:

   xe vm-param-get uuid=<vm_uuid> param-name=platform param-key=acpi_laptop_slate
   <!--NeedCopy-->
  

• allowed-operations (schreibgeschützt eingestellter Parameter) Liste der in diesem Zustand zulässigen Operationen
• current-operations (schreibgeschützter Set-Parameter) eine Liste der Vorgänge, die derzeit auf der VM ausgeführt werden
• allowed-VBD-devices (schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VBD-Identifikatoren, dargestellt durch Ganzzahlen im Bereich 0—15. Diese Liste dient nur zur Information und andere Geräte können verwendet werden (funktioniert aber möglicherweise nicht).
• allowed-VIF-devices (schreibgeschützter Set-Parameter) Liste der zur Verwendung verfügbaren VIF-Identifikatoren, dargestellt durch Ganzzahlen im Bereich 0—15. Diese Liste dient nur zur Information und andere Geräte können verwendet werden (funktioniert aber möglicherweise nicht).
• HVM-boot-policy (Lesen/Schreiben) der Boot-Richtlinie für HVM-Gäste. Entweder BIOS Order oder eine leere Zeichenfolge.
• HVM-boot-params (Zuordnungsparameter lesen/schreiben) Der Ordnungsschlüssel steuert die Startreihenfolge des HVM-Gastes, dargestellt als Zeichenfolge, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für den Stammdatenträger und n für den Netzwerk-PXE-Start. Die Standardeinstellung ist Gleichstrom.
• HVM-shadow-multiplier (Lese-/Schreibzugriff) Gleitkommawert, der den Schattenspeicher-Overhead steuert, der der VM gewährt werden soll. Der Standardwert ist 1,0 (der Mindestwert). Ändern Sie diesen Wert nur, wenn Sie ein fortgeschrittener Benutzer sind.
• PV-kernel (lesen/schreiben) Pfad zum Kernel
• PV-ramdisk (lesen/schreiben) Pfad zum initrd
• PV-args (lesen/schreiben) Zeichenfolge von Kernel-Befehlszeilenargumenten
• PV-legacy-args (lesen/schreiben) Zeichenfolge von Argumenten, um ältere VMs zum Booten zu bringen
• PV-bootloader (lesen/schreiben) Name oder Pfad zum Bootloader
• PV-bootloader-args (lesen/schreiben) Zeichenfolge mit verschiedenen Argumenten für den Bootloader
• last-boot-CPU-flags (schreibgeschützt) beschreibt die CPU-Flags, auf denen die VM zuletzt gebootet wurde
• resident-on (schreibgeschützt) der Citrix Hypervisor-Server, auf dem eine VM ansässig ist
• affinity (Lesen/Schreiben) Der Citrix Hypervisor-Server, auf dem die VM bevorzugt ausgeführt wird. Wird vom Befehl xe vm-start verwendet, um zu entscheiden, wo die VM ausgeführt werden soll.

• other-config (Zuordnungsparameter mit Lese-/Schreibzugriff) Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die VM angeben.

  Das other-config-Schlüssel/Wert-Paar auto_poweron: true fordert beispielsweise an, die VM automatisch zu starten, nachdem ein Host im Pool gestartet wurde. Sie müssen diesen Parameter auch in Ihrem Pool unter other-config festlegen. Diese Parameter sind jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restart-priority.

• start-time (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat das Format yyyymmddThh:mm:ss z, in der z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT)
• install-time (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat das Format yyyymmddThh:mm:ss z, in der z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT)
• memory-actual (schreibgeschützt) der tatsächliche Speicher, der von einer VM verwendet wird
• VCPUs-number (schreibgeschützt) die Anzahl der virtuellen CPUs, die der VM für eine Linux-VM zugewiesen sind. Diese Nummer kann von VCPUS-max abweichen und kann geändert werden, ohne die VM mit dem Befehl vm-vcpu-hotplug neu zu starten. Weitere Informationen finden Sie unter vm-vcpu-hotplug. Windows-VMs werden immer mit der Anzahl der vCPUs ausgeführt, die in VCPUsmaxeingestellt ist, und müssen neu gestartet werden, um diesen Wert zu ändern. Die Leistung nimmt stark ab, wenn Sie einen Wert festlegen VCPUs-number, der größer ist als die Anzahl der physischen CPUs auf dem Citrix Hypervisor-Server.
• VCPUs-Utilization (schreibgeschützter Map-Parameter) eine Liste virtueller CPUs und deren Gewicht
• os-version (schreibgeschützter Zuordnungsparameter) die Version des Betriebssystems für die VM
• PV-drivers-version (schreibgeschützter Map-Parameter) die Versionen der paravirtualisierten Treiber für die VM
• PV-drivers-detected (schreibgeschützt) Flag für die neueste Version der paravirtualisierten Treiber für die VM
• memory (schreibgeschützte Zuordnungsparameter) Speichermetriken, die vom Agent auf der VM gemeldet wurden
• disks (schreibgeschützte Zuordnungsparameter) Datenträgermetriken, die vom Agent auf der VM gemeldet wurden
• networks (schreibgeschützte Zuordnungsparameter) Netzwerkmetriken, die vom Agent auf der VM gemeldet wurden
• other (schreibgeschützter Zuordnungsparameter) andere vom Agent auf der VM gemeldete Metriken
• guest-metrics-lastupdated (schreibgeschützt) Zeitstempel, an dem der Gast-Agent den letzten Schreibvorgang in diese Felder ausgeführt hat. Der Zeitstempel hat das Format yyyymmddThh:mm:ss z, wobei z die militärische Zeitzonenanzeige mit einem Buchstaben ist, z. B. Z für UTC (GMT)
• actions-after-shutdown (Lesen/Schreiben) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
• actions-after-reboot (Lesen/Schreiben) Aktion, die nach dem Neustart der VM ausgeführt werden soll
• possible-hosts potenzielle Hosts dieser VM schreibgeschützt
• dom-id (schreibgeschützt) Domänen-ID (falls verfügbar, andernfalls -1)
• recommendations (schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
• xenstore-data (Map-Parameter lesen/schreiben) Daten, die nach dem Erstellen der VM in die xenstore-Struktur (/local/domain/*domid*/vm-data) eingefügt werden
• is-a-snapshot (schreibgeschützt) True, wenn diese VM ein Snapshot ist
• snapshot_of (schreibgeschützt) die UUID der VM, zu der dieser Snapshot gehört
• snapshots (schreibgeschützt) die UUIDs aller Snapshots dieser VM
• snapshot_time (schreibgeschützt) der Zeitstempel des Snapshot-Vorgangs, der diesen VM-Snapshot erstellt hat
• memory-target (schreibgeschützt) die für diese VM festgelegte Zielmenge an Arbeitsspeicher
• blocked-operations (Map-Parameter mit Lese-/Schreibzugriff) listet die Vorgänge auf, die auf dieser VM nicht ausgeführt werden können
• last-boot-record (schreibgeschützt) Aufzeichnung der letzten Bootparameter für diese Vorlage im XML-Format
• ha-always-run (Lesen/Schreiben) True, wenn diese VM immer auf einem anderen Host neu gestartet wird, wenn der Host, auf dem sie sich befindet, ausfällt. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restart-priority.
• ha-restart-priority (Lesen/Schreiben) Neustart oder Bestleistung
• blobs (schreibgeschützt) binärer Datenspeicher
• live (schreibgeschützt) True, wenn die VM läuft. False, wenn HA vermutet, dass die VM nicht läuft.

vm-assert-can-be-recovered

xe vm-assert-can-be-recovered uuid [database] vdi-uuid
<!--NeedCopy-->

Testet, ob Speicher für die Wiederherstellung dieser VM verfügbar ist.

vm-call-plugin

xe vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]
<!--NeedCopy-->

Ruft die Funktion innerhalb des Plug-Ins auf der angegebenen VM mit optionalen Argumenten auf (args:key=value). Um eine “value” -Zeichenfolge mit Sonderzeichen zu übergeben (z. B. neue Zeile), kann eine alternative Syntax args:key:file=local_file verwendet werden, wobei der Inhalt von local_file abgerufen und “key” als Ganzes zugewiesen wird.

vm-cd-add

xe vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Fügen Sie der ausgewählten VM eine neue virtuelle CD hinzu. Wählen Sie den Parameter device aus dem Wert des Parameters allowed-VBD-devices der VM aus.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-cd-eject

xe vm-cd-eject [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Werfen Sie eine CD aus dem virtuellen CD-Laufwerk aus. Dieser Befehl funktioniert nur, wenn genau eine CD an die VM angeschlossen ist. Wenn zwei oder mehr CDs vorhanden sind, verwenden Sie den Befehl xe vbd-eject und geben Sie die UUID der VBD an.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-cd-insert

xe vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Legen Sie eine CD in das virtuelle CD-Laufwerk ein. Dieser Befehl funktioniert nur, wenn genau ein leeres CD-Gerät an die VM angeschlossen ist. Wenn zwei oder mehr leere CD-Geräte vorhanden sind, verwenden Sie den Befehl xe vbd-insert und geben Sie die UUIDs der VBD und des VDI an, die eingefügt werden sollen.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-cd-list

xe vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Listet CDs auf, die an die angegebenen VMs angeschlossen

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Sie können auch auswählen, welche VBD- und VDI-Parameter aufzulisten sind.

vm-cd-remove

xe vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Entfernen Sie eine virtuelle CD von den angegebenen virtuellen Rechnern.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-checkpoint

xe vm-checkpoint new-name-label=name_label [new-name-description=description]
<!--NeedCopy-->

Überprüfen Sie eine vorhandene VM und verwenden Sie den schnellen Datenträger-Snapshot-Betrieb auf Speicherebene, sofern verfügbar.

vm-clone

xe vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Klonen Sie eine vorhandene VM und verwenden Sie den schnellen Datenträgerklonvorgang auf Speicherebene, sofern verfügbar. Geben Sie den Namen und die optionale Beschreibung für die resultierende geklonte VM mit den Argumenten new-name-label und new-name-description an.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-compute-maximum-memory

xe vm-compute-maximum-memory total=amount_of_available_physical_ram_in_bytes [approximate=add overhead memory for additional vCPUS? true|false] [vm_selector=vm_selector_value...]
<!--NeedCopy-->

Berechnen Sie die maximale Menge an statischem Speicher, die einer vorhandenen VM zugewiesen werden kann, indem Sie die Gesamtmenge an physischem RAM als Obergrenze verwenden. Der optionale Parameter approximate reserviert ausreichend zusätzlichen Speicher in der Berechnung, um das spätere Hinzufügen zusätzlicher vCPUs zur VM zu berücksichtigen.

Beispiel:

xe vm-compute-maximum-memory vm=testvm total=`xe host-list params=memory-free --minimal`
<!--NeedCopy-->

Dieser Befehl verwendet den Wert des vom Befehl xe host-list zurückgegebenen Parameters memory-free, um den maximalen Speicher der VM testvm festzulegen.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-compute-memory-overhead

xe vm-compute-memory-overhead
<!--NeedCopy-->

Berechnet den Virtualisierungsspeicher-Overhead einer VM.

vm-copy

xe vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Kopieren Sie eine vorhandene VM, ohne den schnellen Datenträgerklonvorgang auf Speicherebene zu verwenden (auch wenn diese Option verfügbar ist). Bei den Datenträgerimages der kopierten VM handelt es sich garantiert um vollständige Images, d. h. sie sind nicht Teil einer Copy-on-Write-Kette (CoW).

Geben Sie den Namen und die optionale Beschreibung für die resultierende kopierte VM mit den Argumenten new-name-label und new-name-description an.

Geben Sie das Ziel-SR für die resultierende kopierte VM mit sr-uuid an. Wenn dieser Parameter nicht angegeben wird, entspricht das Ziel demselben SR, in dem die ursprüngliche VM ist.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-copy-bios-strings

xe vm-copy-bios-strings host-uuid=host_uuid
<!--NeedCopy-->

Kopieren Sie die BIOS-Strings des angegebenen Hosts auf die VM.

Hinweis:

Nachdem Sie eine VM zum ersten Mal gestartet haben, können Sie ihre BIOS-Zeichenfolgen nicht ändern. Stellen Sie sicher, dass die BIOS-Zeichenfolgen korrekt sind, bevor Sie die VM zum ersten Mal starten.

vm-crashdump-list

xe vm-crashdump-list [vm-selector=vm selector value...]
<!--NeedCopy-->

Listet Crashdumps auf, die mit den angegebenen VMs verknüpft sind

Wenn Sie das optionale Argument verwenden params, ist der Wert von params eine Zeichenfolge, die eine Liste von Parametern dieses Objekts enthält, die Sie anzeigen möchten. Alternativ können Sie das Schlüsselwort verwenden all, um alle Parameter anzuzeigen. Wenn params nicht verwendet wird, zeigt die zurückgegebene Liste eine Standardteilmenge aller verfügbaren Parameter an.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-data-source-list

xe vm-data-source-list [vm-selector=vm selector value...]
<!--NeedCopy-->

Listen Sie die Datenquellen auf, die für eine VM aufgezeichnet werden können.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.

Datenquellen haben zwei Parameter - standard und enabled -, die Sie in der Ausgabe dieses Befehls sehen können. Wenn in einer Datenquelle enabled auf true festgelegt wurde, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet. Wenn für eine Datenquelle standard auf true eingestellt ist, werden die Metriken standardmäßig in der Performance-Datenbank aufgezeichnet (und enabled ist auch für diese Datenquelle auf true festgelegt). Wenn für eine Datenquelle standard auf false eingestellt ist, werden die Metriken nicht standardmäßig in der Performance-Datenbank aufgezeichnet (und enabled sind auch für diese Datenquelle auf false festgelegt).

Führen Sie den Befehl vm-data-source-record aus, um die Aufzeichnung von Datenquellenmetriken in der Performance-Datenbank zu starten. Mit diesem Befehl wird enabled auf true festgelegt. Um aufzuhören, führe das aus vm-data-source-forget. Mit diesem Befehl wird enabled auf false festgelegt.

vm-data-source-record

xe vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->

Notieren Sie die angegebene Datenquelle für eine VM.

Bei diesem Vorgang werden die Informationen aus der Datenquelle in die Datenbank der persistenten Leistungsmetriken der angegebenen VMs geschrieben. Aus Leistungsgründen unterscheidet sich diese Datenbank von der normalen Agentdatenbank.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.

vm-data-source-forget

xe vm-data-source-forget data-source=name_description_of_data-source [vm-selector=vm selector value...]
<!--NeedCopy-->

Beenden Sie die Aufzeichnung der angegebenen Datenquelle für eine VM und vergessen Sie alle aufgezeichneten Daten.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.

vm-data-source-query

xe vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Zeigt die angegebene Datenquelle für eine VM an.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein. Wenn keine Parameter zur Auswahl von Hosts angegeben sind, wird der Vorgang auf allen VMs ausgeführt.

vm-destroy

xe vm-destroy uuid=uuid_of_vm
<!--NeedCopy-->

Zerstört die angegebene VM. Dadurch bleibt der mit der VM verknüpfte Speicher intakt. Um auch Speicher zu löschen, verwenden Sie xe vm-uninstall.

vm-disk-add

xe vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Fügen Sie den angegebenen virtuellen Rechnern einen Datenträger hinzu. Wählen Sie den Parameter device aus dem Wert des Parameters allowed-VBD-devices der VMs aus.

Der Parameter disk-size kann in Byte oder mit den IEC-Standardsuffixen KiB, MiB, GiB und TiB angegeben werden.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-disk-list

xe vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Listet die an die angegebenen VMs angeschlossenen Datenträger auf. Die Parameter vbd-params und vdi-params steuern die Felder der jeweiligen Objekte, die ausgegeben werden sollen. Geben Sie die Parameter als kommagetrennte Liste oder den speziellen Schlüssel all für die vollständige Liste an.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-disk-remove

xe vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Entfernen Sie einen Datenträger aus den angegebenen VMs und löschen Sie ihn.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-export

xe vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Exportieren Sie die angegebenen VMs (einschließlich Datenträgerimages) in eine Datei auf dem lokalen Computer. Geben Sie mit dem Parameter filename den Dateinamen an, in den die VM exportiert werden soll. Konventionell hat der Dateiname eine Erweiterung .xva.

Wenn der Parameter metadata auf true gesetzt ist, werden die Datenträger nicht exportiert. Nur die VM-Metadaten werden in die Ausgabedatei geschrieben. Verwenden Sie diesen Parameter, wenn der zugrunde liegende Speicher über andere Mechanismen übertragen wird, und ermöglicht die Neuerstellung der VM-Informationen. Weitere Informationen finden Sie unter vm-import.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-import

xe vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]
<!--NeedCopy-->

Importieren Sie eine VM aus einer zuvor exportierten Datei. Wenn preserve auf true eingestellt ist , wird die MAC-Adresse der ursprünglichen VM beibehalten. sr-uuid bestimmt das Ziel-SR, in die die VM importiert werden soll. Wenn dieser Parameter nicht angegeben ist, wird das Standard-SR verwendet.

Wenn metadata auf true gesetzt ist, können Sie einen zuvor exportierten Satz von Metadaten ohne die zugehörigen Datenträgerblöcke importieren. Der Import nur für Metadaten schlägt fehl, wenn keine VDIs gefunden werden können (von SR benannt und VDI.location), sofern die Option --force nicht angegeben ist. In diesem Fall wird der Import trotzdem fortgesetzt. Wenn Datenträger gespiegelt oder aus dem Band verschoben werden können, ist der Import/Export von Metadaten eine schnelle Möglichkeit, VMs zwischen unzusammenhängenden Pools zu verschieben. Zum Beispiel als Teil eines Notfallwiederherstellungsplans.

Hinweis:

Mehrere VM-Importe werden seriell schneller ausgeführt als parallel.

vm-install

xe vm-install new-name-label=name [template-uuid=uuid_of_desired_template] [template=template_uuid_or_name] [sr-uuid=sr_uuid | sr-name-label=name_of_sr][copy-bios-strings-from=host_uuid]
<!--NeedCopy-->

Installieren oder klonen Sie eine VM aus einer Vorlage. Geben Sie den Vorlagennamen mit dem Argument template-uuid oder template an. Geben Sie ein SR mit dem Argument sr-uuid oder sr-name-label an. Geben Sie mit dem Argument copy-bios-strings-from an, dass BIOS-gesperrte Medien installiert werden.

Hinweis:

Bei der Installation von einer Vorlage mit vorhandenen Datenträgern werden standardmäßig neue Datenträger in demselben SR wie diese vorhandenen Datenträger erstellt. Wo das SR dies unterstützt, sind diese Datenträger schnelle Kopien. Wenn in der Befehlszeile ein anderes SR angegeben ist, werden die neuen Datenträger dort erstellt. In diesem Fall ist ein schnelles Kopieren nicht möglich und die Datenträger sind vollständige Kopien.

Bei der Installation von einer Vorlage, die keine vorhandenen Datenträger hat, werden alle neuen Datenträger in dem angegebenen SR oder dem Standard-SR des Pools erstellt, wenn kein SR angegeben ist.

vm-is-bios-customized

xe vm-is-bios-customized
<!--NeedCopy-->

Zeigt an, ob die BIOS-Zeichenfolgen der VM angepasst wurden.

vm-memory-dynamic-range-set

xe vm-memory-dynamic-range-set min=min max=max
<!--NeedCopy-->

Konfigurieren Sie den dynamischen Speicherbereich einer VM. Der dynamische Speicherbereich definiert weiche Unter- und Obergrenzen für den Speicher einer VM. Es ist möglich, diese Felder zu ändern, wenn eine VM läuft oder angehalten wird. Der Dynamikbereich muss innerhalb des statischen Bereichs liegen.

vm-memory-limits-set

xe vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max
<!--NeedCopy-->

Konfigurieren Sie die Speicherbeschränkungen einer VM.

vm-memory-set

xe vm-memory-set memory=memory
<!--NeedCopy-->

Konfigurieren Sie die Speicherzuweisung einer VM.

vm-memory-shadow-multiplier-set

xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]
<!--NeedCopy-->

Setzt den Schattenspeicher-Multiplikator für die angegebene VM.

Dies ist eine erweiterte Option, mit der die Größe des Shadow-Speichers geändert wird, der einer hardwareunterstützten VM zugewiesen ist.

In einigen spezialisierten Anwendungsworkloads, wie Citrix Virtual Apps, ist zusätzlicher Schattenspeicher erforderlich, um die volle Leistung zu erzielen.

Dieser Speicher wird als Overhead angesehen. Es ist von den normalen Speicherberechnungen für die Abrechnung von Speicher an eine VM getrennt. Wenn dieser Befehl aufgerufen wird, verringert sich die Menge an freiem Hostspeicher entsprechend dem Multiplikator und das Feld HVM_shadow_multiplier wird mit dem Wert aktualisiert, den Xen der VM zugewiesen hat. Wenn nicht genügend Citrix Hypervisor-Serverspeicher frei ist, wird ein Fehler zurückgegeben.

Die virtuellen Maschinen, auf denen dieser Vorgang ausgeführt werden soll, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren.

vm-memory-static-range-set

xe vm-memory-static-range-set min=min max=max
<!--NeedCopy-->

Konfigurieren Sie den statischen Speicherbereich einer VM. Der statische Speicherbereich definiert harte Unter- und Obergrenzen für den Speicher einer VM. Es ist möglich, diese Felder nur zu ändern, wenn eine VM angehalten wird. Der statische Bereich muss den Dynamikbereich umfassen.

vm-memory-target-set

xe vm-memory-target-set target=target
<!--NeedCopy-->

Setzt das Speicherziel für eine angehaltene oder laufende VM. Der angegebene Wert muss innerhalb des Bereichs liegen, der durch die Werte memory_static_min und memory_static_max der VM definiert ist.

vm-migrate

xe vm-migrate [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:source_vif_uuid=destination_network_uuid] [vdi:vdi_uuid=destination_sr_uuid]
<!--NeedCopy-->

Dieser Befehl migriert die angegebenen virtuellen Maschinen zwischen physischen Hosts. Der Parameter host kann entweder der Name oder die UUID des Citrix Hypervisor-Servers sein. Um beispielsweise die VM auf einen anderen Host im Pool zu migrieren, wo sich die VM-Datenträger auf einem von beiden Hosts gemeinsam genutzten Speicher befinden:

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid
<!--NeedCopy-->

So verschieben Sie VMs zwischen Hosts im selben Pool, die sich keinen Speicher teilen (Speicher-Livemigration):

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
    remote-master=192.0.2.35 remote-username=username remote-password=password
<!--NeedCopy-->

Für die Speicher-Live-Migration müssen Sie den Hostnamen oder die IP-Adresse, den Benutzernamen und das Kennwort für den Poolmaster angeben, auch wenn Sie innerhalb desselben Pools migrieren.

Sie können das SR wählen, in der jeder VDI gespeichert wird:

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 remote-username=username remote-password=password host-uuid=destination_host_uuid \
    vdi:vdi_1=destination_sr1_uuid \
    vdi:vdi_2=destination_sr2_uuid \
    vdi:vdi_3=destination_sr3_uuid
<!--NeedCopy-->

Darüber hinaus können Sie auswählen, welches Netzwerk die VM nach der Migration anhängen soll:

xe vm-migrate uuid=vm_uuid \
    vdi1:vdi_1_uuid=destination_sr1_uuid \
    vdi2:vdi_2_uuid=destination_sr2_uuid \
    vdi3:vdi_3_uuid=destination_sr3_uuid \
    vif:vif_uuid=network_uuid
<!--NeedCopy-->

Für die poolübergreifende Migration:

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 \
    remote-username=username remote-password=password \
    host-uuid=destination_host_uuid  \
    vif:source_vif_uuid=destination_network_uuid \
    vdi:vdi_uuid=destination_sr_uuid
<!--NeedCopy-->

Weitere Informationen zur Speicher-Livemigration, Live-Migration und Live-VDI-Migration finden Sie unter Migrieren von VMs.

Standardmäßig wird die VM angehalten, migriert und auf dem anderen Host fortgesetzt. Der Parameter live wählt die Livemigration aus. Die Live-Migration sorgt dafür, dass die VM während der Migration läuft, wodurch die Ausfallzeiten der virtuellen Maschine minimiert werden. Unter bestimmten Umständen, z. B. bei extrem speicherintensiven Workloads in der VM, fällt die Livemigration wieder in den Standardmodus und setzt die VM für kurze Zeit an, bevor die Speicherübertragung abgeschlossen wird.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-pause

xe vm-pause
<!--NeedCopy-->

Pausieren Sie eine laufende VM. Beachten Sie, dass dieser Vorgang den zugehörigen Speicher nicht freigibt (siehe vm-suspend).

vm-reboot

xe vm-reboot [vm-selector=vm_selector_value...] [force=true]
<!--NeedCopy-->

Starten Sie die angegebenen VMs neu.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Verwenden Sie das Argument force, um einen nicht ordnungsgemäßen Neustart zu verursachen. Wo das Herunterfahren dem Ziehen des Steckers auf einem physischen Server ähnelt.

vm-recover

xe vm-recover vm-uuid [database] [vdi-uuid] [force]
<!--NeedCopy-->

Stellt eine VM aus der Datenbank wieder her, die im bereitgestellten VDI enthalten ist.

vm-reset-powerstate

xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
<!--NeedCopy-->

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Dies ist ein erweiterter Befehl, der nur verwendet wird, wenn ein Mitgliedshost in einem Pool ausfällt. Sie können diesen Befehl verwenden, um den Poolmaster zu zwingen, den Energiezustand der VMs zurückzusetzen halted. Im Wesentlichen erzwingt dieser Befehl die Sperre der VM und der Datenträger, sodass sie als Nächstes auf einem anderen Poolhost gestartet werden kann. Für diesen Aufruf muss das Force-Flag angegeben werden und schlägt fehl, wenn es sich nicht in der Befehlszeile befindet.

vm-resume

xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
<!--NeedCopy-->

Setzt die angegebenen VMs fort.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Wenn sich die VM auf einem gemeinsam genutzten SR in einem Pool von Hosts befindet, verwenden Sie das Argument on, um anzugeben, auf welchem Poolmitglied sie gestartet werden soll. Standardmäßig bestimmt das System einen geeigneten Host, bei dem es sich um eines der Mitglieder des Pools handeln kann.

vm-retrieve-wlb-recommendations

xe vm-retrieve-wlb-recommendations
<!--NeedCopy-->

Rufen Sie die Empfehlungen für den Workloadausgleich für die ausgewählte VM ab.

vm-shutdown

xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Fahren Sie die angegebene VM herunter.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Verwenden Sie das Argument force, um ein nicht ordnungsgemäßen Herunterfahren zu verursachen, ähnlich dem Ziehen des Steckers auf einem physischen Server.

vm-snapshot

xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
<!--NeedCopy-->

Snapshot einer vorhandenen VM mit schnellem Datenträger-Snapshot-Betrieb auf Speicherebene, sofern verfügbar.

vm-start

xe vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]
<!--NeedCopy-->

Startet die angegebenen VMs.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Wenn sich die VMs auf einem gemeinsam genutzten SR in einem Pool von Hosts befinden, verwenden Sie das Argument on, um anzugeben, auf welchem Poolmitglied die VMs gestartet werden sollen. Standardmäßig bestimmt das System einen geeigneten Host, bei dem es sich um eines der Mitglieder des Pools handeln kann.

vm-suspend

xe vm-suspend [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Die angegebene VM aussetzen.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-uninstall

xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Deinstallieren Sie eine VM und löschen Sie ihre Datenträger (die VDIs, die als RW gekennzeichnet sind und nur mit dieser VM verbunden sind) zusätzlich zu ihrem Metadatensatz. Um nur die VM-Metadaten zu löschen, verwenden Sie xe vm-destroy.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-unpause

xe vm-unpause
<!--NeedCopy-->

Unterbrechen Sie eine angehaltene VM.

vm-vcpu-hotplug

xe vm-vcpu-hotplug new-vcpus=new_total_vcpu_count [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Passen Sie dynamisch die Anzahl der vCPUs an, die für eine laufende Linux-VM verfügbar sind. Die Anzahl der vCPUs wird durch den Parameter begrenzt VCPUs-max. Windows-VMs werden immer mit der Anzahl der vCPUs ausgeführt, die in VCPUs-maxeingestellt ist, und müssen neu gestartet werden, um diesen Wert zu ändern.

Verwenden Sie den Parameter new-vcpus, um die neue Gesamtzahl der vCPUs zu definieren, die Sie nach der Ausführung dieses Befehls haben möchten. Verwenden Sie diesen Parameter nicht, um die Anzahl der vCPUs zu übergeben, die Sie hinzufügen möchten. Wenn Sie beispielsweise zwei vorhandene vCPUs in Ihrer VM haben und zwei weitere vCPUs hinzufügen möchten, geben Sie new-vcpus=4 an.

Die Linux-VM oder Windows-VMs, auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Hinweis:

Wenn Sie Linux-VMs ohne installierte Citrix VM Tools ausführen, führen Sie den folgenden Befehl auf der VM als root aus, um sicherzustellen, dass die neu im laufenden Betrieb angeschlossenen vCPUs verwendet werden: # for i in /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(cat $i)" = 0 ]; then echo 1 > $i; fi; done

vm-vif-list

xe vm-vif-list [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Listet die VIFs der angegebenen VMs auf.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Die Selektoren arbeiten beim Filtern mit den VM-Datensätzen und nicht mit den VIF-Werten. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Geplante Snapshots

Befehle zum Steuern von VM-geplanten Snapshots und deren Attributen.

Die vmss-Objekte können mit dem Standardbefehl zur Objektauflistung (xe vmss-list) aufgelistet werden, und die Parameter können mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Parameterbefehle auf niedriger Ebene

vmss-create

xe vmss-create enabled=True/False name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule
<!--NeedCopy-->

Erstellt einen Snapshot-Zeitplan im Pool.

Beispiel:

xe vmss-create retained-snapshots=9 enabled=true frequency=daily \
    name-description=sample name-label=samplepolicy type=snapshot \
    schedule:hour=10 schedule:min=30
<!--NeedCopy-->

Snapshot-Zeitpläne haben die folgenden Parameter:

vmss-destroy

xe vmss-destroy uuid=uuid
<!--NeedCopy-->

Zerstört einen Snapshot-Zeitplan im Pool.

USB-Durchgang

USB-Passthrough wird für die folgenden USB-Versionen unterstützt: 1.1, 2.0 und 3.0.

USB-Pass-Through aktivieren/deaktivieren

xe pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
<!--NeedCopy-->

Aktivieren/Deaktivieren von USB-Passthrough.

pusb-scan

xe pusb-scan host-uuid=host_uuid
<!--NeedCopy-->

PUSB scannen und aktualisieren.

vusb-create

xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
<!--NeedCopy-->

Erstellt einen virtuellen USB-Stick im Pool. Starten Sie die VM, um den USB zur VM zu leiten.

vusb-unplug

xe vusb-unplug uuid=vusb_uuid
<!--NeedCopy-->

Trennen Sie den USB-Stecker von der VM.

vusb-destroy

xe vusb-destroy uuid=vusb_uuid
<!--NeedCopy-->

Entfernt die virtuelle USB-Liste von der VM.