Befehlszeilenschnittstelle

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

Installation der xe CLI

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

Unter Windows

Unter Windows wird derxe.exe Befehl zusammen mit XenCenter installiert.

Um denxe.exe Befehl zu verwenden, öffnen Sie eine Windows Eingabeaufforderung und ändern Sie die Verzeichnisse in das Verzeichnis, in dem sich diexe.exe Datei befindet (normalerweiseC:\Program Files\Citrix\XenCenter ). Wenn Sie denxe.exe Installationsspeicherort zu Ihrem Systempfad hinzufügen, können Sie den Befehl verwenden, ohne in das Verzeichnis wechseln zu müssen.

Unter Linux

Bei RPM-basierten Distributionen (z. B. Red Hat) können Sie den eigenständigen xe-Befehl aus dem RPM installieren, derclient_install/xapi-xe-BUILD.x86_64.rpm auf der Citrix Hypervisor Hauptinstallations-ISO benannt ist.

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

rpm -ivh xapi-xe-BUILD.x86_64.rpm

Sie können Parameter in der Befehlszeile verwenden, um den Citrix Hypervisor or-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. Zum Beispiel:

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

Hinweis:

Die remote xe CLI unter Linux hängt möglicherweise ab, wenn versucht wird, Befehle über eine sichere Verbindung auszuführen, und diese Befehle beinhalten Dateiübertragung. In diesem Fall können Sie den Befehl mithilfe des--no-ssl Parameters über eine unsichere Verbindung zum Citrix Hypervisor or-Server ausführen.

Hilfe zu xe-Befehlen erhalten

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

xe help command

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

xe help

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

xe help --all

Grundlegende x-Syntax

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

xe command-name argument=value argument=value

Jeder spezifische Befehl enthält einen eigenen Satz von Argumenten, die in der Form sindargument=value. Einige Befehle haben erforderliche Argumente, und die meisten haben einige optionale Argumente. Normalerweise nimmt ein Befehl Standardwerte für einige der optionalen Argumente an, wenn er ohne diese aufgerufen wird.

Wenn der xe-Befehl remote ausgeführt wird, werden zusätzliche Argumente verwendet, um eine Verbindung herzustellen und zu authentifizieren. Diese Argumente nehmen auch die Form anargument=argument_value.

Dasserver Argument wird verwendet, um den Hostnamen oder die IP-Adresse anzugeben. Dieusername Argumentepassword und werden verwendet, um Anmeldeinformationen anzugeben.

Einpassword-file Argument kann anstelle des Kennworts direkt angegeben werden. In diesem Fall versucht der Befehl xe, 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 das Kennwort direkt in der Befehlszeile anzugeben.

Das optionaleport Argument kann verwendet werden, um den Agent-Port auf dem Remote-Server von Citrix Hypervisor anzugeben (Standardwert 443).

Beispiel: Auf dem lokalen Citrix Hypervisor -Server:

xe vm-list

Beispiel: Auf dem Remote-Server von Citrix Hypervisor:

xe vm-list -user username -password password -server hostname

Für Remoteverbindungsargumente ist auch eine Kurzschrift verfügbar:

  • -u Benutzername
  • -pw Passwort
  • -pwf Passwortdatei
  • -p Port
  • -s Server

Beispiel: Auf einem entfernten Citrix Hypervisor -Server:

xe vm-list -u myuser -pw mypassword -s hostname

Argumente werden auch der Umgebungsvariable XE_EXTRA_ARGS in Form von durch Kommas getrennten Schlüssel/Wert-Paaren entnommen. Um beispielsweise Befehle einzugeben, die auf einem Citrix Hypervisor or-Server ausgeführt werden, führen Sie zuerst den folgenden Befehl aus:

export XE_EXTRA_ARGS="server=jeffbeck,port=443,username=root,password=pass"

Nach dem Ausführen dieses Befehls müssen Sie nicht mehr die Remote-Citrix Hypervisor or-Serverparameter in jedem ausgeführten xe-Befehl angeben.

Die Verwendung der Umgebungsvariable XE_EXTRA_ARGS ermöglicht auch die Tabulatorvervollständigung von xe-Befehlen, wenn sie für einen entfernten Citrix Hypervisor or-Server ausgegeben werden, der standardmäßig deaktiviert ist.

Sonderzeichen und Syntax

Um Argument/Wert-Paare in derxe Befehlszeile anzugeben, schreiben Sie:argument=value

Verwenden Sie keine Anführungszeichen, wenn der Wert Leerzeichen enthält. Zwischen dem Argumentnamen, dem Gleichheitszeichen (=) und dem Wert sollte kein Leerzeichen vorhanden sein. 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 dem Citrix Hypervisor or-Server verwenden, verfügen Befehle über eine Funktion zur Tabulatorvervollständigung, die der Funktion in der Standard-Linux-Bash-Shell ähnelt. Wenn Sie beispielsweise die TAB-TASTE eingebenxe vm-l und dann drücken, wird der Rest des Befehls angezeigt. Wenn mehr als ein Befehl mit beginntvm-l, werden die Möglichkeiten durch Drücken von TABein zweites Mal aufgelistet. Diese Funktion ist nützlich, wenn Objekt-UUIDs in Befehlen angegeben werden.

Hinweis:

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

Befehlstypen

Die CLI-Befehle können in zwei Hälften geteilt werden. Low-Level-Befehle befassen sich mit der Auflistung und Parametermanipulation von API-Objekten. Befehle höherer Ebene werden verwendet, um mit VMs oder Hosts in einer abstrakten Ebene zu interagieren.

Die Low-Level-Befehle sind:

  • class-list

  • Klasse-param-get

  • class-param-set

  • Klasse-param-list

  • Klasse-param-add

  • Klasse-param-remove

  • Klasse-param-clear

Wo Klasse eine der folgenden ist:

  • bond

  • console

  • host

  • host-crashdump

  • host-cpu

  • network

  • patch

  • pbd

  • pif

  • pool

  • sm

  • sr

  • task

  • template

  • vbd

  • vdi

  • vif

  • vlan

  • vm

Nicht jeder Wert der Klasse hat den vollständigen Satz von Klassenbefehlen -param-action . Einige Werte der Klasse haben einen kleineren Satz von Befehlen.

Parametertypen

Die Objekte, die mit den xe-Befehlen adressiert werden, verfügen über Parametersätze, die sie identifizieren und deren Status definieren.

Die meisten Parameter nehmen einen einzelnen Wert an. Beispielsweise enthält dername-label Parameter einer VM einen einzelnen Zeichenfolgenwert. In der Ausgabe von Parameterlistenbefehlenxe vm-param-list, z. B. gibt ein Wert in Klammern an, ob Parameter schreibgeschützt (RW) oder schreibgeschützt (RO) sind. Die Ausgabe vonxe vm-param-list auf einer angegebenen VM kann folgende Zeilen haben:

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

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

Die beiden anderen Parametertypen sind mehrwertig. Ein Set-Parameter enthält eine Liste von Werten. Ein Kartenparameter ist ein Satz von Schlüssel/Wert-Paaren. Sehen Sie sich beispielsweise die folgende Beispielausgabe desxe vm-param-list auf einer angegebenen VM an:

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

Derplatform Parameter enthält eine Liste von Elementen, die Schlüssel/Wert-Paare darstellen. Den Schlüsselnamen folgt ein Doppelpunkt (:). Jedes Schlüssel/Wert-Paar wird durch ein Semikolon (;) vom nächsten getrennt. Das M, das dem RW vorangestellt ist, gibt an, dass dieser Parameter ein Kartenparameter ist und lesbar und beschreibbar ist. Derallowed-operations Parameter verfügt über eine Liste, aus der eine Reihe von Elementen besteht. Das S, das dem RO vorangestellt ist, zeigt an, dass es sich um einen eingestellten Parameter handelt und lesbar, aber nicht beschreibbar ist.

Um nach einem Kartenparameter zu filtern oder einen Kartenparameter festzulegen, verwenden Sie einen Doppelpunkt (:), um den Kartenparameternamen und das Schlüssel/Wert-Paar zu trennen. Um beispielsweise den Wert desfoo Schlüssels desother-config Parameters einer VM auf festzulegenbaa , lautet der Befehl

xe vm-param-set uuid=VM uuid other-config:foo=baa

Hinweis:

In früheren Versionen wurde das Bindestrich (-) verwendet, um Kartenparameter anzugeben. Diese Syntax funktioniert immer noch, ist aber veraltet.

Low-Level-Parameterbefehle

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 und class-param-list. Jeder dieser Befehle verwendet einenuuid Parameter, um das jeweilige Objekt anzugeben. Da diese Befehle als Low-Level-Befehle gelten, müssen sie die UUID und nicht die VM-Namensbezeichnung verwenden.

  • 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.

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

    Gibt den Wert eines bestimmten Parameters zurück. Bei einem Zuordnungsparameter wird durch die Angabe des Paramschlüssels der Wert abgerufen, der diesem Schlüssel in der Karte zugeordnet ist. Wenn paramkey nicht angegeben ist oder wenn der Parameter ein Satz ist, gibt der Befehl eine Zeichenfolgendarstellung des Satzes oder der Zuordnung zurück.

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

    Legt den Wert eines oder mehrerer Parameter fest.

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

    Fügt entweder einer Karte oder einem Set-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.

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

    Entfernt entweder ein Schlüssel/Wert-Paar aus einer Karte oder einen Schlüssel aus einem Satz.

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

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

Low-Level-Listenbefehle

Der Befehl class-list listet die Objekte des Typs 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 filtern, so dass es nur eine Teilmenge ausgibt
  • Die Parameter, die gedruckt werden, können geändert werden.

Um die Parameter zu ändern, die gedruckt werden, geben Sie die Argumentparameter als kommagetrennte Liste der erforderlichen Parameter an. Zum Beispiel:

xe vm-list params=name-label,other-config

Um alle Parameter aufzulisten, verwenden Sie alternativ die Syntax:

xe vm-list params=all

Der Befehl list zeigt nicht einige Parameter an, die teuer zu berechnen sind. Diese Parameter werden beispielsweise wie folgt dargestellt:

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

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 Werten ab, die in der Befehlszeile angegeben sind. Dabei werden nur Objekte gedruckt, die allen angegebenen Einschränkungen entsprechen. Zum Beispiel:

xe vm-list HVM-boot-policy="BIOS order" power-state=halted

Dieser Befehl listet nur die VMs auf, für die sowohl das Feld den Wert angehaltenpower-state* hat als auch das Feld die *BIOS-ReihenfolgeHVM-boot-policy aufweist .

Sie können die Liste auch nach dem Wert von Schlüsseln in Zuordnungen oder nach der Existenz von Werten in einem Satz filtern. Die Syntax für die Filterung basierend auf Schlüsseln in Karten istmap-name:key=value. Die Syntax für die Filterung basierend auf Werten, die in einem Satz vorhanden sind, istset-name:contains=value.

Beim Skripting wird die Befehlszeile durch eine nützliche Technik übergeben--minimal , wodurchxe nur das erste Feld in einer kommagetrennten Liste gedruckt wird. Beispielsweise gibt der Befehlxe 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

Geheimnisse

Citrix Hypervisor bietet einen Geheimnismechanismus, um zu verhindern, dass Kennwörter im Befehlszeilenverlauf oder in API-Objekten im Klartext gespeichert werden. XenCenter verwendet diese Funktion automatisch und kann auch über die xe-CLI für alle Befehle verwendet werden, für die ein Kennwort erforderlich ist.

Hinweis

Kennwortgeheimnisse können nicht zur Authentifizierung mit einem Citrix Hypervisor Host von einer Remote-Instanz der xe-CLI verwendet werden.

Führen Sie zum Erstellen eines geheimen Objekts den folgenden Befehl auf dem Citrix Hypervisor Host aus.

xe secret-create value=my-password

Ein Geheimnis wird erstellt und auf dem Citrix Hypervisor Host gespeichert. Der Befehl gibt die UUID des geheimen Objekts aus. Beispiel: 99945d96-5890-de2a-3899-8c04ef2521db. _secret`` Hängen Sie an den Namen des Passwort-Arguments an, um diese UUID an einen beliebigen Befehl zu übergeben, der ein Kennwort erfordert.

Beispiel: Auf dem Citrix Hypervisor Host, auf dem Sie den geheimen Schlüssel 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"

xe-Befehlsreferenz

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

Appliance-Befehle

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

Einheitenparameter

Appliance-Befehle haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die Appliance uid Erforderlich
name-description Beschreibung der Appliance Optional
paused   Optional
force Herunterfahren erzwingen Optional

appliance-assert-can-be-recovered

appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid

Prüft, ob Speicher verfügbar ist, um diese VM-Appliance/vApp wiederherzustellen.

appliance-create

appliance-create name-label=name-label [name-description=name-description]

Erstellt eine Appliance/vApp. Zum Beispiel:

xe appliance-create name-label=my_appliance

Hinzufügen von VMs zur Appliance:

    xe vm-param-set uuid=VM-UUID appliance=appliance-uuid

appliance-destroy

appliance-destroy uuid=appliance-uuid

Zerstört eine Appliance/vApp. Zum Beispiel:

xe appliance-destroy uuid=appliance-uuid

appliance-recover

appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [paused=true|false]

Wiederherstellen einer VM-Appliance/vApp aus der Datenbank, die im mitgelieferten VDI enthalten ist.

appliance-shutdown

appliance-shutdown uuid=appliance-uuid [force=true|false]

Beenden Sie alle VMs in einer Appliance/vApp. Zum Beispiel:

xe appliance-shutdown uuid=appliance-uuid

appliance-start

appliance-start uuid=appliance-uuid [paused=true|false]

Startet eine Appliance/vApp. Zum Beispiel:

xe appliance-start uuid=appliance-uuid

Überwachungsbefehle

Überwachungsbefehle laden alle verfügbaren Datensätze der RBAC-Überwachungsdatei im Pool herunter. Wenn der optionale Parameter vorhandensince ist, werden nur die Datensätze von diesem bestimmten Zeitpunkt heruntergeladen.

audit-log-get Parameter

audit-log-get hat die folgenden Parameter

Parametername Beschreibung Typ
filename Schreiben Sie das Überwachungsprotokoll des Pools in Dateiname Erforderlich
since Spezifischer Datum/Zeitpunkt Optional

audit-log-get

audit-log-get [since=timestamp] filename=filename

Führen Sie beispielsweise den folgenden Befehl aus, um Überwachungsdatensätze des Pools seit einem genauen Zeitstempel in Millisekunden zu erhalten:

Führen Sie den folgenden Befehl aus:

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

Bonding-Befehle

Befehle für die Arbeit mit Netzwerkanleihen, für Widerstandsfähigkeit mit physischem Schnittstellen-Failover. Weitere Informationen finden Sie unter Vernetzung.

Das Bindungsobjekt ist ein Referenzobjekt, das Master- und Member-PIF zusammenklebt. Die Master-PIF ist die Klebungsschnittstelle, die als Gesamt-PIF verwendet werden muss, um sich auf die Bindung zu beziehen. Bei den Mitglied-PIFs handelt es sich um eine Gruppe von zwei oder mehr physikalischen Schnittstellen, die zu der High-Level-gebundenen Schnittstelle kombiniert wurden.

Anleihungsparameter

Anleihen haben folgende Parameter:

Parametername Beschreibung Typ
uuid Eindeutige Bezeichner/Objektreferenz für die Bindung Schreibgeschützt
master UUID für die Master-Anleihe PIF Schreibgeschützt
members Satz von UUIDs für die zugrunde liegenden gebundenen PIF Schreibgeschützt

bond-create

bond-create network-uuid=network_uuid pif-uuids=pif_uuid_1,pif_uuid_2,...

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

  • Wenn PIF bereits in einer anderen Anleihe sind
  • Wenn ein Mitglied ein VLAN-Tag gesetzt hat
  • Wenn sich die referenzierten PIF nicht auf demselben Citrix Hypervisor or-Server befinden
  • Wenn weniger als 2 PIF geliefert werden

bond-destroy

bond-destroy uuid=bond_uuid

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

bond-set-mode

bond-set-mode uuid=bond_uuid mode=bond_mode

Ändern Sie den Bond-Modus.

CD-Befehle

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

CD-Parameter

CDs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Eindeutige Bezeichner/Objektreferenz für die CD Schreibgeschützt
name-label Name der CD Lese-/Schreibzugriff
name-description Beschreibungstext für die CD Lese-/Schreibzugriff
allowed-operations Eine Liste der Vorgänge, die auf dieser CD ausgeführt werden können Schreibgeschützte Parameter
current-operations Eine Liste der Vorgänge, die derzeit auf dieser CD ausgeführt werden Schreibgeschützte Parameter
sr-uuid Die eindeutige Bezeichner/Objektreferenz für die SR, die diese CD enthält, ist Teil von Schreibgeschützt
sr-name-label Der Name für die SR dieser CD ist Teil von Schreibgeschützt
vbd-uuids Eine Liste der eindeutigen Bezeichner für die VBDs auf VMs, die eine Verbindung zu dieser CD herstellen Schreibgeschützte Parameter
crashdump-uuids Nicht auf CDs verwendet. Da Crashdumps nicht auf CDs geschrieben werden können Schreibgeschützte Parameter
virtual-size Größe der CD, wie sie für VMs angezeigt wird (in Byte) Schreibgeschützt
physical-utilisation Menge des physischen Speicherplatzes, den das CD-Image auf der SR belegt (in Bytes) Schreibgeschützt
type Für CDs auf Benutzer festlegen Schreibgeschützt
sharable Gibt an, ob das CD-Laufwerk gemeinsam verwendet werden kann. Der Standardwert istfalse. Schreibgeschützt
read-only Ob die CD schreibgeschützt ist, wennfalse, ist das Gerät beschreibbar. Immer wahr für CDs. Schreibgeschützt
storage-lock Der Wert isttrue , wenn dieser Datenträger auf Speicherebene gesperrt ist. Schreibgeschützt
parent Verweis auf die übergeordnete Festplatte, wenn diese CD Teil einer Kette ist. Schreibgeschützt
missing Der Wert isttrue , wenn der SR-Scanvorgang diese CD als nicht auf der Festplatte gemeldet hat. Schreibgeschützt
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die CD angeben Kartenparameter mit Lese-/Schreibzugriff
location Der Pfad, auf dem das Gerät eingehängt ist Schreibgeschützt
managed Wert isttrue , wenn das Gerät verwaltet wird Schreibgeschützt
xenstore-data Daten, die in den Xenstore-Baum eingefügt werden sollen Schreibgeschützte Kartenparameter
sm-config Namen und Beschreibungen von Speicher-Manager-Gerätekonfigurationsschlüsseln Schreibgeschützte Kartenparameter
is-a-snapshot Wert isttrue , wenn es sich bei dieser Vorlage um einen CD-Schnappschuss handelt. Schreibgeschützt
snapshot_of Die UUID der CD, die diese Vorlage ein Snapshot von Schreibgeschützt
snapshots Die UUIDs aller Snapshots, die von dieser CD erstellt wurden Schreibgeschützt
snapshot_time Der Zeitstempel des Snapshot-Vorgangs Schreibgeschützt

cd-list

cd-list [params=param1,param2,...] [parameter=parameter_value]

Listen Sie die CDs und ISOs (CD-Imagedateien) auf dem Citrix Hypervisor-Server oder -pool auf und filtern Sie das optionale Argumentparams.

Wenn das optionale Argument verwendetparams 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. Wennparams nicht verwendet wird, zeigt die zurückgegebene Liste eine Standardteilmenge aller verfügbaren Parameter an.

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

Clusterbefehle

Befehle zum Arbeiten mit gruppierten Pools.

Cluster-Pools sind Ressourcenpools, für die das Cluster-Feature aktiviert ist. Verwenden Sie diese Pools mit GFS2 SRs. Weitere Informationen finden Sie unter Cluster-Pools

Die Cluster- und Cluster-Host-Objekte können mit den Standardobjekt-Auflistungsbefehlen (xe cluster-list undxe cluster-host-list ) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle. Befehle zum Arbeiten mit gruppierten Pools.

Clusterparameter

Cluster haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den Cluster Schreibgeschützt
cluster-hosts Eine Liste eindeutiger Bezeichner/Objektreferenzen für die Hosts im Cluster Schreibgeschützte Parameter
cluster-token Der geheime Schlüssel, der von xapi-clusterd verwendet wird, wenn er auf anderen Hosts mit sich selbst spricht Schreibgeschützt
cluster-stack Der Technologie-Stack, der die Clustering-Funktionen bereitstellt. Mögliche Werte sindcorosync. Schreibgeschützt
allowed-operations Listet die in diesem Zustand zulässigen Vorgänge auf. Diese Liste ist nur beratend, und der Clusterstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. Schreibgeschützte Parameter
current-operations Listet die derzeit in Bearbeitung befindlichen Vorgänge auf. Diese Liste ist nur beratend, und der Clusterstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. Schreibgeschützte Parameter
token-timeout Das Timeout des Corosync-Token in Sekunden Schreibgeschützt
token-timeout-coefficient Der Corosync-Token Timeout-Koeffizient in Sekunden Schreibgeschützt
pool-auto-join True, wenn neue Poolmitglieder automatisch mit dem Cluster verbunden werden. Dies ist auf eingestellttrue. Schreibgeschützt
cluster-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. Schreibgeschützte Kartenparameter
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Cluster angeben. Kartenparameter mit Lese-/Schreibzugriff

cluster-host-create

cluster-host-create cluster-uuid=cluster_uuid host-uuid=host_uuid pif-uuid=pif_uuid

Fügen Sie einem vorhandenen Cluster einen Host hinzu.

cluster-host-destroy

cluster-host-destroy uuid=host_uuid

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

cluster-host-disable

cluster-host-disable uuid=cluster_uuid

Deaktivieren der Clustermitgliedschaft für einen aktivierten Clusterhost.

cluster-host-enable

cluster-host-enable uuid=cluster_uuid

Aktivieren der Clustermitgliedschaft für einen deaktivierten Clusterhost.

cluster-host-force-destroy

cluster-host-force-destroy uuid=cluster_host

Zerstören Sie ein Cluster-Hostobjekt mit Nachdruck und verlassen Sie den Cluster effektiv.

cluster-pool-create

cluster-pool-create network-uuid=network_uuid [cluster-stack=cluster_stack] [token-timeout=token_timeout] [token-timeout-coefficient=token_timeout_coefficient]

Erstellen Sie einen Pool-weiten Cluster.

cluster-pool-destroy

cluster-pool-destroy cluster-uuid=cluster_uuid

Zerstöre den Pool-weiten Cluster. Der Pool existiert weiterhin, ist aber nicht mehr gruppiert und kann keine GFS2-SRs mehr verwenden.

cluster-pool-force-destroy

cluster-pool-force-destroy cluster-uuid=cluster_uuid

Erzwingen Sie, den Pool-weiten Cluster zu zerstören.

cluster-pool-resync

cluster-pool-resync cluster-uuid=cluster_uuid

Synchronisieren Sie einen Cluster über einen Pool hinweg.

Konsolenbefehle

Befehle zum Arbeiten mit Konsolen.

Die Konsolenobjekte können mit dem Standardbefehl (xe console-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.

Konsolenparameter

Konsolen haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die Konsole Schreibgeschützt
vm-uuid Die eindeutige Bezeichner/Objektreferenz der VM, auf der diese Konsole geöffnet ist Schreibgeschützt
vm-name-label Der Name der VM, auf der diese Konsole geöffnet ist Schreibgeschützt
protocol Protokoll, das von dieser Konsole verwendet wird. Mögliche Werte sindvt100: VT100-Terminal,rfb: Remote Framebuffer Protocol (wie in VNC verwendet) oderrdp: Remote Desktop Protocol Schreibgeschützt
location URI für den Konsolendienst Schreibgeschützt
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die Konsole angeben. Kartenparameter mit Lese-/Schreibzugriff

console

console

An eine bestimmte Konsole anhängen.

Diagnosebefehle

Befehle zum Sammeln von Diagnoseinformationen von Citrix Hypervisor.

diagnostic-compact

diagnostic-compact

Führen Sie eine große GC-Sammlung und Heap-Komprimierung durch.

diagnostic-db-log

diagnostic-db-log

Starten Sie die Protokollierung der Datenbankvorgänge. Warnung: Einmal gestartet, kann diese nicht gestoppt werden.

diagnostic-db-stats

diagnostic-db-stats

Drucken von Datenbankstatistiken.

diagnostic-gc-stats

diagnostic-gc-stats

GC-Statistiken drucken.

diagnostic-license-status

diagnostic-license-status

Hilfe bei der Diagnose von Poolweiten Lizenzierungsproblemen.

diagnostic-net-stats

diagnostic-net-stats [uri=uri] [method=method] [params=param1,param2...]

Drucken von Netzwerkstatistiken.

diagnostic-timing-stats

diagnostic-timing-stats

Zeitstatistiken drucken.

diagnostic-vdi-status

diagnostic-vdi-status uuid=vdi_uuid

Fragen Sie den Sperr- und Freigabestatus eines VDI ab.

diagnostic-vm-status

diagnostic-vm-status uuid=vm_uuid

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

Disaster Recovery-Befehle

Befehle zum Wiederherstellen von VMs nach einer Katastrophe

drtask-create

drtask-create type=type sr-whitelist=sr-white-list device-config=device-config

Erstellt eine Disaster Recovery-Aufgabe. So stellen Sie beispielsweise eine Verbindung zu einer iSCSI-SR in Vorbereitung auf die Disaster Recovery her:

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

Hinweis:

Der Befehlsr-whitelist listet SR-UUIDs auf. Der drtask-create Befehl führt nur eine SR ein und stellt eine Verbindung mit einer der UUIDs auf der weißen Liste her.

drtask-destroy

drtask-destroy uuid=dr-task-uuid

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

vm-assert-can-be-recovered

vm-assert-can-be-recovered uuid=vm-uuid database:vdi-uuid=vdi-uuid

Prüft, ob Speicher verfügbar ist, um diese VM wiederherzustellen.

appliance-assert-can-be-recovered

appliance-assert-can-be-recovered uuid=appliance-uuid database:vdi-uuid=vdi-uuid

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

appliance-recover

appliance-recover uuid=appliance-uuid database:vdi-uuid=vdi-uuid [force=true|false]

Wiederherstellen einer Appliance/vApp aus der Datenbank, die im mitgelieferten VDI enthalten ist.

vm-recover

vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid [force=true|false]

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

sr-enable-database-replication

sr-enable-database-replication uuid=sr_uuid

Aktiviert die XAPI-Datenbankreplikation auf die angegebene (gemeinsam genutzte) SR.

sr-disable-database-replication

sr-disable-database-replication uuid=sr_uuid

Deaktiviert die XAPI-Datenbankreplikation auf die angegebene SR.

Beispielnutzung

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

Stellen Sie nach einer Katastrophe am sekundären Standort eine Verbindung zum SR her. Derdevice-config Befehl hat die gleichen Felder wiesr-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

Suchen Sie nach Datenbank-VDIs auf der SR:

xe vdi-list sr-uuid=sr-uuid type=Metadata

Abfrage eines Datenbank-VDI für vorhandene VMs:

xe vm-list database:vdi-uuid=vdi-uuid

Wiederherstellen einer VM:

xe vm-recover uuid=vm-uuid database:vdi-uuid=vdi-uuid

Zerstören Sie den DR-Task. Alle von der DR-Task eingeführten und von VMs nicht benötigten SRs werden vernichtet:

xe drtask-destroy uuid=drtask-uuid

Ereignisbefehle

Befehle zum Arbeiten mit Ereignissen.

Eventklassen

Ereignisklassen sind in der folgenden Tabelle aufgeführt:

Klassenname Beschreibung
pool Ein Pool physischer Hosts
vm Eine virtuelle Maschine
host Ein physischer Host
network Ein virtuelles Netzwerk
vif Eine virtuelle Netzwerkschnittstelle
pif Eine physische Netzwerkschnittstelle (separate VLANs werden als mehrere PIFs dargestellt)
sr Ein Speicher-Repository
vdi Ein virtuelles Laufwerk-Image
vbd Ein virtuelles Blockgerät
pbd Die physischen Blockgeräte, über die Hosts auf SRs zugreifen

event-wait

event-wait class=class_name [param-name=param_value] [param-name=/=param_value]

Blockiert die Ausführung anderer Befehle, bis ein Objekt vorhanden ist, das die in der Befehlszeile angegebenen Bedingungen erfüllt. Das Argumentx=y bedeutet „warten, bis Feld x Wert y nimmt“ undx=/=y bedeutet „warten, bis Feld x einen anderen Wert als y nimmt.“

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

xe event-wait class=vm name-label=myvm power-state=running

Blockiert andere Befehle, bis eine VM aufgerufenmyvm wird in derpower-state „läuft. „

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)

Blockiert 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 jeder der am Anfang dieses AbschnittsEreignisklassenaufgeführten sein. Bei den Parametern kann es sich um einen der in der CLI-Befehlsklasse-param-list aufgeführten Parameter handeln.

GPU-Befehle

Befehle für die Arbeit mit physischen GPUs, GPU-Gruppen und virtuellen GPUs.

Die GPU-Objekte können mit den Standardobjektlistenbefehlen aufgelistet werden:xe pgpu-listxe gpu-group-list````, undxe vgpu-list``. Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.

Physische GPU-Parameter

Physische GPUS (PGPU) haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die PGPU Schreibgeschützt
vendor-name Der Herstellername der PGPU Schreibgeschützt
device-name Der vom Hersteller diesem PGPU Modell zugewiesene Name Schreibgeschützt
gpu-group-uuid Der eindeutige Bezeichner/Objektreferenz für die GPU-Gruppe, der diese PGPU automatisch von Citrix Hypervisor zugewiesen wurde. Identische PGPU über Hosts in einem Pool sind gruppiert Schreibgeschützt
gpu-group-name-label Der Name der GPU-Gruppe, der die PGPU zugewiesen ist Schreibgeschützt
host-uuid Der eindeutige Bezeichner/Objektreferenz für den Citrix Hypervisor or-Server, mit dem die PGPU verbunden ist Schreibgeschützt
host-name-label Der Name des Citrix Hypervisor or-Servers, mit dem die PGPU verbunden ist Schreibgeschützt
pci-id PCI-Bezeichner Schreibgeschützt
dependencies Listet die abhängigen PCI-Geräte auf, die an dieselbe VM übergeben wurden Kartenparameter mit Lese-/Schreibzugriff
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die PGPU angeben Kartenparameter mit Lese-/Schreibzugriff
supported-VGPU-types Liste der virtuellen GPU-Typen, die von der zugrunde liegenden Hardware unterstützt werden Schreibgeschützt
enabled-VGPU-types Liste der virtuellen GPU-Typen, die für diese PGPU aktiviert wurden Lesen/Schreiben
resident-VGPUs Liste der auf dieser PGPU ausgeführten VGPUs Schreibgeschützt

pgpu-disable-dom0-access

pgpu-disable-dom0-access uuid=uuid

Deaktivieren Sie den PGPU Zugriff auf dom0.

pgpu-enable-dom0-access

pgpu-enable-dom0-access uuid=uuid

Aktivieren Sie den PGPU Zugriff auf dom0.

GPU-Gruppenparameter

GPU-Gruppen haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die GPU-Gruppe Schreibgeschützt
name-label Der Name der GPU-Gruppe Lese-/Schreibzugriff
name-description Der beschreibende Text der GPU-Gruppe Lese-/Schreibzugriff
VGPU-uuids Listet die eindeutigen Bezeichner/Objektreferenzen für die virtuellen GPUs in der GPU-Gruppe auf Schreibgeschützte Parameter
PGPU-uuids Listet die eindeutigen Bezeichner/Objektreferenzen für die PGPU in der GPU-Gruppe auf Schreibgeschützte Parameter
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die GPU-Gruppe angeben Kartenparameter mit Lese-/Schreibzugriff
supported-VGPU-types Vereinigung aller von der zugrunde liegenden Hardware unterstützten virtuellen GPU-Typen Schreibgeschützt
enabled-VGPU-types Vereinigung aller virtuellen GPU-Typen, die auf den zugrunde liegenden PGPU aktiviert wurden Schreibgeschützt
allocation-algorithm Tiefe-ersten/Breadth-erste Einstellung für die Zuweisung virtueller GPUs auf PGPU innerhalb der Gruppe Enum-Parameter mit Lese-/Schreibzugriff

GPU-Gruppenvorgänge

Befehle für die Arbeit mit GPU-Gruppen

gpu-group-create
gpu-group-create name-label=name_for_group [name-description=description]

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

gpu-group-destroy
gpu-group-destroy uuid=uuid_of_group

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

gpu-group-get-remaining-capacity
gpu-group-get-remaining-capacity uuid=uuid_of_group vgpu-type-uuid=uuid_of_vgpu_type

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

gpu-group-param-set
gpu-group-param-set uuid=uuid_of_group allocation-algorithm=breadth-first|depth-first

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

gpu-group-param-get-uuid
gpu-group-param-get-uuid uuid=uuid_of_group param-name=supported-vGPU-types|enabled-vGPU-types

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

Virtuelle GPU-Parameter

Virtuelle GPUs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die virtuelle GPU Schreibgeschützt
vm-uuid Der eindeutige Bezeichner/Objektreferenz für die VM, der die virtuelle GPU zugewiesen ist Schreibgeschützt
vm-name-label Der Name der VM, der die virtuelle GPU zugewiesen ist Schreibgeschützt
gpu-group-uuid Die eindeutige Bezeichner/Objektreferenz für die GPU-Gruppe, in der die virtuelle GPU enthalten ist Schreibgeschützt
gpu-group-name-label Der Name der GPU-Gruppe, in der die virtuelle GPU enthalten ist Schreibgeschützt
currently-attached True, wenn eine VM mit GPU-Pass-Through ausgeführt wird, andernfalls false Schreibgeschützt
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die virtuelle GPU angeben Kartenparameter mit Lese-/Schreibzugriff
type-uuid Die eindeutige Bezeichner/Objektreferenz für den virtuellen GPU-Typ dieser virtuellen GPU Kartenparameter mit Lese-/Schreibzugriff
type-model-name Modellname, der dem virtuellen GPU-Typ zugeordnet ist Schreibgeschützt

Parameter des virtuellen GPU-Types

Hinweis:

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

Virtuelle GPU-Typen haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den virtuellen GPU-Typ Schreibgeschützt
vendor-name Name des virtuellen GPU-Anbieters Schreibgeschützt
model-name Modellname, der dem virtuellen GPU-Typ zugeordnet ist Schreibgeschützt
freeze-frame Framebuffer-Größe des virtuellen GPU-Typs, in Byte Schreibgeschützt
max-heads Maximale Anzahl von Bildschirmen, die vom virtuellen GPU-Typ unterstützt werden Schreibgeschützt
supported-on-PGPUs Liste der PGPU, die diesen virtuellen GPU-Typ unterstützen Schreibgeschützt
enabled-on-PGPUs Liste der PGPU, für die dieser virtuelle GPU-Typ aktiviert ist Schreibgeschützt
VGPU-uuids Liste der virtuellen GPUs dieses Typs Schreibgeschützt

Virtuelle GPU-Vorgänge

vgpu-create

vgpu-create vm-uuid=uuid_of_vm gpu_group_uuid=uuid_of_gpu_group [vgpu-type-uuid=uuid_of_vgpu-type]

Erstellt eine virtuelle GPU. Mit diesem Befehl wird die VM an die angegebene GPU-Gruppe angehängt und optional den virtuellen GPU-Typ angegeben. Wenn kein virtueller GPU-Typ angegeben wird, wird der Typ „Pass-Through“ angenommen.

vgpu-destroy

vgpu-destroy uuid=uuid_of_vgpu

Zerstören Sie 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

Mitfalse dieser Option wird die VNC-Konsole für eine VM deaktiviert, während sie andisablevnc=1 den Anzeigeemulator weitergeleitet wird. Standardmäßig ist VNC aktiviert.

Host-Befehle

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

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

Die Citrix Hypervisor or-Serverobjekte können mit den Standardbefehlen aufgelistet werden:xe host-listxe host-cpu-list````, undxe host-crashdump-list``). Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle.

Host-Selektoren

Mehrere der hier aufgeführten Befehle verfügen über einen gemeinsamen Mechanismus zur Auswahl eines oder mehrerer Citrix Hypervisor or-Server, auf denen der Vorgang ausgeführt werden soll. Am einfachsten ist die Angabe des Argumentshost=uuid_or_name_label. Sie können Citrix Hypervisor auch angeben, indem Sie die vollständige Liste der Hosts nach den Werten der Felder filtern. Durch Angeben werden beispielsweiseenabled=true alle Citrix Hypervisor or-Server ausgewählt, derenenabled Feld gleich isttrue . Wenn mehrere Citrix Hypervisor or-Server übereinstimmen und der Vorgang auf mehreren Citrix Hypervisor or-Servern ausgeführt werden kann, müssen Sie angeben,--multiple um den Vorgang auszuführen. Die vollständige Liste der Parameter, die abgeglichen werden können, wird am Anfang dieses Abschnitts beschrieben. Sie können diese Liste der Befehle erhalten, indem Sie den Befehl ausführenxe host-list params=all. Wenn keine Parameter für die Auswahl von Citrix Hypervisor or-Servern angegeben werden, wird der Vorgang auf allen Citrix Hypervisor-Servern ausgeführt.

Host-Parameter

Citrix Hypervisor -Server verfügen über die folgenden Parameter:

Parametername Beschreibung Typ
uuid Der eindeutige Bezeichner/Objektreferenz für den Citrix Hypervisor or-Server Schreibgeschützt
name-label Der Name des Citrix Hypervisor -Servers Lese-/Schreibzugriff
name-description Die Beschreibungszeichenfolge des Citrix Hypervisor -Servers Schreibgeschützt
enabled Wert istfalse , wenn deaktiviert. Dadurch wird verhindert, dass neue VMs auf den Hosts gestartet werden, und die Hosts werden für das Herunterfahren oder Neustart vorbereitet. Wert isttrue , wenn der Host aktiviert ist Schreibgeschützt
API-version-major Hauptversionsnummer Schreibgeschützt
API-version-minor Nebenversionsnummer Schreibgeschützt
API-version-vendor Identifizierung des API-Anbieters Schreibgeschützt
API-version-vendor-implementation Details zur Implementierung des Anbieters Schreibgeschützte Kartenparameter
logging Protokollierungskonfiguration Kartenparameter mit Lese-/Schreibzugriff
suspend-image-sr-uuid Die eindeutige Bezeichner/Objektreferenz für die SR, in der suspendierte Bilder platziert werden Lese-/Schreibzugriff
crash-dump-sr-uuid Die eindeutige Bezeichner/Objektreferenz für die SR, in der Crash-Dumps platziert werden Lese-/Schreibzugriff
software-version Liste der Versionsparameter und deren Werte Schreibgeschützte Kartenparameter
capabilities Liste der Xen Versionen, die auf dem Citrix Hypervisor or-Server ausgeführt werden können Schreibgeschützte Parameter
other-config Eine Liste der Schlüssel/Wert-Paare, die zusätzliche Konfigurationsparameter für den Citrix Hypervisor or-Server angeben Kartenparameter mit Lese-/Schreibzugriff
chipset-info Eine Liste von Schlüssel/Wert-Paaren, die Informationen über den Chipsatz angeben Schreibgeschützte Kartenparameter
hostname Hostname des Citrix Hypervisor or-Servers Schreibgeschützt
address IP-Adresse des Citrix Hypervisor or-Servers Schreibgeschützt
license-server Eine Liste von Schlüssel/Wert-Paaren, die Informationen zum Lizenzserver angeben. Der Standardport für die Kommunikation mit Citrix Produkten ist 27000. Informationen zum Ändern von Portnummern aufgrund von Konflikten finden Sie unterPortnummern ändern Schreibgeschützte Kartenparameter
supported-bootloaders Liste der Bootloader, die der Citrix Hypervisor or-Server unterstützt, z. B. pygrub, eliloader Schreibgeschützte Parameter
memory-total Gesamtmenge des physischen Arbeitsspeichers auf dem Citrix Hypervisor or-Server in Byte Schreibgeschützt
memory-free Gesamtmenge des verbleibenden physischen Arbeitsspeichers, der VMs zugewiesen werden kann, in Byte Schreibgeschützt
host-metrics-live True, wenn der Host betriebsbereit ist Schreibgeschützt
logging Dersyslog_destination Schlüssel kann auf den Hostnamen eines Remote Listening Syslog-Dienstes gesetzt werden. Kartenparameter mit Lese-/Schreibzugriff
allowed-operations Listet die in diesem Zustand zulässigen Vorgänge auf. Diese Liste ist nur beratend, und der Serverstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. Schreibgeschützte Parameter
current-operations Listet die derzeit in Bearbeitung befindlichen Vorgänge auf. Diese Liste ist nur beratend, und der Serverstatus hat sich möglicherweise geändert, wenn ein Client dieses Feld liest. Schreibgeschützte Parameter
patches Satz von Host-Patches Schreibgeschützte Parameter
blobs Binärer Datenspeicher Schreibgeschützt
memory-free-computed Eine konservative Schätzung der maximalen Speichermenge, die auf einem Host frei ist Schreibgeschützt
ha-statefiles Die UUIDs aller HA-Statusdateien Schreibgeschützt
ha-network-peers Die UUIDs aller Hosts, die die VMs auf diesem Host hosten könnten, wenn ein Fehler auftritt Schreibgeschützt
external-auth-type Typ der externen Authentifizierung, z. B. Active Directory. Schreibgeschützt
external-auth-service-name Der Name des externen Authentifizierungsdienstes Schreibgeschützt
external-auth-configuration Konfigurationsinformationen für den externen Authentifizierungsdienst. Schreibgeschützte Kartenparameter

Citrix Hypervisor or-Server enthalten einige andere Objekte, die auch Parameterlisten enthalten.

CPUs auf Citrix Hypervisor or-Servern weisen die folgenden Parameter auf:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die CPU Schreibgeschützt
number Die Nummer des physischen CPU-Kerns innerhalb des Citrix Hypervisor or-Servers Schreibgeschützt
vendor Die Herstellerzeichenfolge für den CPU-Namen Schreibgeschützt
speed Die CPU-Takt in Hz Schreibgeschützt
modelname Die Herstellerzeichenfolge für das CPU-Modell, z. B. „Intel (R) Xeon (TM) CPU 3.00 GHz“ Schreibgeschützt
stepping Die CPU-Revisionsnummer Schreibgeschützt
flags Die Flags der physischen CPU (eine dekodierte Version des Feature-Feldes) Schreibgeschützt
Utilisation Die aktuelle CPU-Auslastung Schreibgeschützt
host-uuid Die UUID, wenn der Host, in dem sich die CPU befindet Schreibgeschützt
model Die Modellnummer der physischen CPU Schreibgeschützt
family Die Nummer der physischen CPU-Familie Schreibgeschützt

Crash Dumps auf Citrix Hypervisor or-Servern weisen die folgenden Parameter auf:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den Crashdump Schreibgeschützt
host Citrix Hypervisor -Server, dem der Crashdump entspricht Schreibgeschützt
timestamp Zeitstempel des Datums und der Uhrzeit, an der der Absturz aufgetreten ist, in der Formyyyymmdd-hhmmss-ABC, wobei ABCder Zeitzonenindikator ist, z. B. GMT Schreibgeschützt
size Größe des Crashdump, in Bytes Schreibgeschützt

host-all-editions

host-all-editions

Eine Liste aller verfügbaren Editionen abrufen

host-apply-edition

host-apply-edition [host-uuid=host_uuid] [edition=xenserver_edition="free" "per-socket" "xendesktop"]

Weist die Citrix Hypervisor or-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 Editionen"xendesktop".

Informationen zur Erstkonfiguration der Lizenzierung finden Sie unter auchlicense-server-address undlicense-server-port .

host-backup

host-backup file-name=backup_filename host=host_name

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

Wichtig:

Während derxe host-backup Befehl funktioniert, wenn er auf dem lokalen Host ausgeführt wird (dh ohne einen bestimmten Hostnamen angegeben), verwenden Sie ihn nicht auf diese Weise. Dies würde die Kontrolldomänenpartition mit der Sicherungsdatei füllen. Verwenden Sie nur den Befehl von einem externen Rechner, auf dem Sie Speicherplatz für die Sicherungsdatei haben.

host-bugreport-upload

host-bugreport-upload [host-selector=host_selector_value...] [url=destination_url http-proxy=http_proxy_name]

Generieren Sie einen neuen Fehlerbericht (mit xen-bugtool, mit allen optionalen Dateien enthalten) und laden Sie sie auf die Support-FTP-Site oder an einen anderen Ort hoch.

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

Optionale Parameter sind http-proxy: Verwenden Sie den angegebenen HTTP-Proxy und url: Upload zu dieser Ziel-URL. Wenn keine optionalen Parameter verwendet werden, wird kein Proxyserver identifiziert, und das Ziel ist die standardmäßige Support-FTP-Site.

host-call-plugin

host-call-plugin host-uuid=host_uuid plugin=plugin fn=function [args=args]

Ruft die Funktion innerhalb des Plugins auf dem angegebenen Host mit optionalen Argumenten auf.

host-compute-free-memory

host-compute-free-memory

Berechnet die Menge des freien Speichers auf dem Host.

host-compute-memory-overhead

host-compute-memory-overhead

Berechnet den Virtualisierungsspeicher-Overhead eines Hosts.

host-cpu-info

host-cpu-info [uuid=uuid]

Listet Informationen über die physischen CPUs des Hosts auf.

host-crashdump-destroy

host-crashdump-destroy uuid=crashdump_uuid

Löschen Sie einen durch seine UUID angegebenen Host-Crashdump vom Citrix Hypervisor or-Server.

host-crashdump-upload

host-crashdump-upload uuid=crashdump_uuid [url=destination_url] [http-proxy=http_proxy_name]

Laden Sie ein crashdump auf die Support-FTP-Site oder einen anderen Speicherort hoch. Wenn keine optionalen Parameter verwendet werden, wird kein Proxyserver identifiziert, und das Ziel ist die standardmäßige Support-FTP-Site. Optionale Parameter sind http-proxy: Verwenden Sie den angegebenen HTTP-Proxy und url: Upload zu dieser Ziel-URL.

host-declare-dead

host-declare-dead uuid=host_uuid

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

Warnhinweis:

Dieser Aufruf ist gefährlich und kann Datenverlust verursachen, wenn der Host nicht tatsächlich tot ist.

host-disable

host-disable [host-selector=host_selector_value...]

Deaktiviert die angegebenen Citrix Hypervisor or-Server, wodurch verhindert wird, dass neue VMs auf ihnen gestartet werden. Mit dieser Aktion werden die Citrix Hypervisor or-Server für das Herunterfahren oder Neustart vorbereitet.

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

host-disable-display

host-disable-display uuid=host_uuid

Deaktivieren Sie die Anzeige für den Host.

host-disable-local-storage-caching

host-disable-local-storage-caching

Deaktivieren Sie das lokale Speicher-Caching auf dem angegebenen Host.

host-dmesg

host-dmesg [host-selector=host_selector_value...]

Abrufen eines Xendmesg (die Ausgabe des Kernelringpuffers) von angegebenen Citrix Hypervisor or-Servern.

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

host-emergency-ha-disable

host-emergency-ha-disable  [--force]

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

host-emergency-management-reconfigure

host-emergency-management-reconfigure interface=uuid_of_management_interface_pif

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

host-enable

host-enable [host-selector=host_selector_value...]

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

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

host-enable-display

host-enable-display uuid=host_uuid

Anzeige für den Host aktivieren.

host-enable-local-storage-caching

host-enable-local-storage-caching  sr-uuid=sr_uuid

Aktivieren Sie das lokale Speicher-Caching auf dem angegebenen Host.

host-evacuate

host-evacuate [host-selector=host_selector_value...]

Live migriert alle ausgeführten VMs auf andere geeignete Hosts in einem Pool. Zuerst lösen Sie den Host mithilfe deshost-disable Befehls auf.

Wenn der evakuierte Host der Poolmaster ist, muss ein anderer Host als Poolmaster ausgewählt werden. Verwenden Sie denpool-designate-new-master Befehl, um den Poolmaster mit deaktiviertem HA zu ändern. Weitere Informationen finden Sie unter pool-bezeichnen-neu-master.

Wenn HA aktiviert ist, besteht Ihre einzige Option darin, den Server herunterzufahren, wodurch HA zufällig einen neuen Master wählt. Weitere Informationen finden Sie unter Host-Shutdown.

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

host-forget

host-forget uuid=host_uuid

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

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

Warnhinweis:

Verwenden Sie diesen Befehl nicht, wenn HA im Pool aktiviert ist. Deaktivieren Sie zuerst HA und aktivieren Sie es dann erneut, nachdem Sie den Host vergessen haben.

Dieser Befehl ist nützlich, wenn der Citrix Hypervisor or-Server zum „Vergessen“ nicht mehr vorhanden ist. Wenn der Citrix Hypervisor or-Server jedoch live ist und Teil des Pools ist, verwenden Siexe pool-eject stattdessen.

host-get-cpu-features

host-get-cpu-features {features=pool_master_cpu_features} [uuid=host_uuid]

Druckt eine hexadezimale Darstellung der physischen CPU-Funktionen des Hosts.

host-get-server-certificate

host-get-server-certificate

Holen Sie sich das installierte SSL-Zertifikat des Servers.

host-get-sm-diagnostics

host-get-sm-diagnostics uuid=uuid

Zeigt SM-Diagnoseinformationen pro Host an.

host-get-system-status

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

Laden Sie Systemstatusinformationen in die angegebene Datei herunter. Der optionale Parameterentries ist eine durch Kommas getrennte Liste von Systemstatuseinträgen, die aus dem vomhost-get-system-status-capabilities Befehl zurückgegebenen Capabilities XML-Fragment entnommen werden. Weitere Informationen finden Sie unter Host-get-system-status-Funktionen. Wenn nicht angegeben, werden alle Systemstatusinformationen in der Datei gespeichert. Der Parameteroutput kann tar.bz2 (Standardeinstellung) oder zip sein. Wenn dieser Parameter nicht angegeben ist, wird die Datei intar.bz2 Form gespeichert.

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

host-get-system-status-capabilities

host-get-system-status-capabilities [host-selector=host_selector_value...]

Abrufen der Systemstatusfunktionen für die angegebenen Hosts. 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>

Jede Capability-Entity kann die folgenden Attribute haben.

  • key Ein eindeutiger Bezeichner für die Fähigkeit.
  • content-type Kann entweder text/plain oder application/data sein. Gibt an, ob eine Benutzeroberfläche 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ählen soll.
  • min-size,max-sizeGibt einen ungefähren Bereich für die Größe dieses Eintrags in Byte an. -1 gibt an, dass die Größe unwichtig ist.
  • min-time,max-timeGeben Sie einen ungefähren Bereich für die Zeit in Sekunden an, die benötigt wird, um diesen Eintrag zu erfassen. -1 gibt an, dass die Zeit unwichtig ist.
  • pii Persönlich identifizierbare Informationen. Gibt an, ob der Eintrag Informationen enthält, die den Systembesitzer identifizieren können, oder Details seiner Netzwerktopologie. Das Attribut kann einen der folgenden Werte haben:

    • no: keine PII ist in diesen Einträgen enthalten
    • yes: PII ist wahrscheinlich oder sicher in diesen Einträgen
    • maybe: Sie können diese Einträge für 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.

    Passwörter dürfen niemals in einen Fehlerbericht aufgenommen werden, unabhängig von der PII Deklaration.

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

host-get-thread-diagnostics

host-get-thread-diagnostics uuid=uuid

Zeigt Diagnoseinformationen pro Host Thread an.

host-get-vms-which-prevent-evacuation

host-get-vms-which-prevent-evacuation uuid=uuid

Gibt eine Liste der VMs zurück, die die Evakuierung eines bestimmten Hosts verhindern und die Gründe für jeden anzeigen.

host-is-in-emergency-mode

host-is-in-emergency-mode

Gibt zurücktrue , wenn sich der Host, mit dem die CLI spricht, im Notfallmodus befindet,false andernfalls. Dieser CLI-Befehl funktioniert direkt auf Slave-Hosts, selbst wenn kein Master-Host vorhanden ist.

host-license-add

host-license-add [license-file=path/license_filename] [host-uuid=host_uuid]

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

host-license-remove

host-license-remove [host-uuid=host_uuid]

Entfernen Sie alle Lizenzierungen, die auf einen Host angewendet werden.

host-license-view

host-license-view [host-uuid=host_uuid]

Zeigt den Inhalt der Citrix Hypervisor-Serverlizenz an.

host-logs-download

host-logs-download [file-name=logfile_name] [host-selector=host_selector_value...]

Laden Sie eine Kopie der Protokolle der angegebenen Citrix Hypervisor or-Server herunter. Die Kopie wird standardmäßig in einer Zeitstempeldatei mit dem Namen gespeicherthostname-yyyy-mm-dd T hh:mm:ssZ.tar.gz. Sie können einen anderen Dateinamen mit dem optionalen Parameter file-nameangeben.

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

Wichtig:

Während derxe host-logs-download Befehl funktioniert, wenn er auf dem lokalen Host ausgeführt wird (dh ohne einen bestimmten Hostnamen angegeben), verwenden Sie ihn nicht auf diese Weise. Dadurch wird die Partition der Steuerdomäne mit der Kopie der Protokolle umklammert. Der Befehl sollte nur von einem externen Rechner aus verwendet werden, auf dem Sie Platz haben, um die Kopie der Protokolle zu speichern.

host-management-disable

host-management-disable

Deaktiviert den Host-Agent, der eine externe Verwaltungsnetzwerkschnittstelle überwacht, und trennt alle verbundenen API-Clients (z. B. XenCenter). Dieser Befehl funktioniert direkt auf dem Citrix Hypervisor or-Server, mit dem die CLI verbunden ist. Der Befehl wird nicht an den Poolmaster weitergeleitet, wenn er auf einen Citrix Hypervisor or-Server eines Mitglieds angewendet wird.

Warnhinweis:

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

host-management-reconfigure

host-management-reconfigure [interface=device] [pif-uuid=uuid]

Konfiguriert den Citrix Hypervisor or-Server so neu, dass die angegebene Netzwerkschnittstelle als Verwaltungsschnittstelle verwendet wird, d. h. die Schnittstelle, die für die Verbindung mit XenCenter verwendet wird. Der Befehl schreibt den MANAGEMENT_INTERFACE Schlüssel in um/etc/xensource-inventory.

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

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

Warnhinweis:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass Sie über Netzwerkkonnektivität auf der neuen Schnittstelle verfügen. Verwenden Sie xe pif-reconfigure, um eine zuerst einzurichten. Andernfalls können nachfolgende CLI-Befehle den Citrix Hypervisor or-Server nicht erreichen.

host-power-on

host-power-on [host=host_uuid]

Schaltet Citrix Hypervisor or-Server mit aktivierter Host-Einschaltfunktion ein. Aktivieren Sie vor der Verwendung dieses Befehls host-set-power-on auf dem Host.

host-reboot

host-reboot [host-selector=host_selector_value...]

Starten Sie die angegebenen Citrix Hypervisor -Server neu. Die angegebenen Hosts müssen zuerst mit demxe host-disable Befehl deaktiviert werden, andernfalls wird eineHOST_IN_USE Fehlermeldung angezeigt.

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

Wenn die angegebenen Citrix Hypervisor or-Server Mitglieder eines Pools sind, wird der Verlust der Konnektivität beim Herunterfahren gehandhabt, und der Pool wird wiederhergestellt, wenn die Citrix Hypervisor or-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 auftritt:

  • Sie machen eines der Mitglieder in den Master
  • Der ursprüngliche Master wird neu gestartet und wieder online.

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

host-restore

host-restore [file-name=backup_filename] [host-selector=host_selector_value...]

Stellen Sie eine Sicherung mit dem Namenfile-name der Citrix Hypervisor-Serversteuerungssoftware wieder her. Die Verwendung des Wortes „restore“ bedeutet hier nicht eine vollständige Wiederherstellung im üblichen Sinne, sondern bedeutet lediglich, dass die komprimierte Sicherungsdatei unkomprimiert und auf die sekundäre Partition entpackt wurde. Nachdem Sie eine getan habenxe host-restore, müssen Sie die CD installieren booten und die Option Aus Sicherung wiederherstellen verwenden.

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

host-send-debug-keys

host-send-debug-keys  host-uuid=host_uuid keys=keys

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

host-set-hostname-live

host-set-hostname host-uuid=uuid_of_host hostname=new_hostname

Ändern Sie den Hostnamen des von angegebenen Citrix Hypervisor or-Servershost-uuid. Mit diesem Befehl wird sowohl der Hostname in der Steuerdomänendatenbank als auch der tatsächliche Linux-Hostname des Citrix Hypervisor or-Servers dauerhaft festgelegt. Der Wert von hostname ist nicht identisch mit dem Wert des Felds name_label .

host-set-power-on-mode

host-set-power-on-mode host=host_uuid power-on-mode={"" | "wake-on-lan" | "iLO" | "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 ]

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

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

host-shutdown

host-shutdown [host-selector=host_selector_value...]

Fahren Sie die angegebenen Citrix Hypervisor -Server herunter. Die angegebenen Citrix Hypervisor or-Server müssen zuerst mit demxe host-disable Befehl deaktiviert werden, andernfalls wird eineHOST_IN_USE Fehlermeldung angezeigt.

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

Wenn die angegebenen Citrix Hypervisor or-Server Mitglieder eines Pools sind, wird der Verlust der Konnektivität beim Herunterfahren gehandhabt, und der Pool wird wiederhergestellt, wenn die Citrix Hypervisor or-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 auftritt:

  • Sie machen eines der Mitglieder in den Master
  • Der ursprüngliche Master wird neu gestartet und 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 in einen Master umgewandelt. Wenn HA deaktiviert ist, müssen Sie den gewünschten Server mit dempool-designate-new-master Befehl manuell als Master festlegen. Weitere Informationen finden Sie unter pool-bezeichnen-neu-master.

host-sm-dp-destroy

host-sm-dp-destroy uuid=uuid dp=dp [allow-leak=true|false]

Versuchen Sie, einen Speicherdatenpfad auf einem Host zu zerstören und zu bereinigen. Wenn angegebenallow-leak=true wird, werden alle Datensätze des Datenpfads gelöscht, auch wenn er nicht sauber heruntergefahren werden konnte.

host-sync-data

host-sync-data

Synchronisieren Sie die auf dem Poolmaster gespeicherten Nicht-Datenbankdaten mit dem benannten Host.

host-syslog-reconfigure

host-syslog-reconfigure [host-selector=host_selector_value...]

Konfigurieren Sie densyslog Daemon auf den angegebenen Citrix Hypervisor or-Servern neu. Mit diesem Befehl werden die imlogging Host-Parameter definierten Konfigurationsinformationen angewendet.

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

host-data-source-list

host-data-source-list [host-selectors=host selector value...]

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

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

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

  • Wenn eine Datenquelle auf enabled festgelegt ist true, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet.
  • Wenn eine Datenquelle aufstandard festgelegt isttrue , werden die Metriken standardmäßig in der Performance-Datenbank aufgezeichnet. Der Wert von enabled wird auch true für diese Datenquelle auf festgelegt.
  • Wenn eine Datenquelle aufstandard festgelegt istfalse , werden die Metriken nicht standardmäßig in der Performance-Datenbank aufgezeichnet. Der Wert von enabled wird auch false für diese Datenquelle auf festgelegt.

Führen Sie den host-data-source-record Befehl aus, um Datenquellen-Metriken in der Performance-Datenbank aufzuzeichnen. Dieser Befehl wird enabled auf festgelegt true. Um zu stoppen, führen Sie den aus host-data-source-forget. Dieser Befehl wird enabled auf festgelegt false.

host-data-source-record

host-data-source-record data-source=name_description_of_data_source [host-selectors=host_selector_value...]

Zeichnen Sie die angegebene Datenquelle für einen Host auf.

Dieser Vorgang schreibt die Informationen aus der Datenquelle in die Datenbank für persistente Performance-Metriken der angegebenen Hosts. Aus Performance-Gründen unterscheidet sich diese Datenbank von der normalen Agent-Datenbank.

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

host-data-source-forget

host-data-source-forget data-source=name_description_of_data_source [host-selectors=host_selector_value...]

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

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

host-data-source-query

host-data-source-query data-source=name_description_of_data_source [host-selectors=host_selector_value...]

Zeigt die angegebene Datenquelle für einen Host an.

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

Protokollierungsbefehle

Befehle zum Arbeiten mit Protokollen.

log-get

log-get

Gibt das Protokoll zurück, das aktuell im String-Logger gespeichert ist.

log-get-keys

log-get-keys

Listen Sie die Schlüssel auf, die der Logger kennt.

log-reopen

log-reopen

Öffnen Sie alle Logger erneut (verwenden Sie dies für das Drehen von Dateien).

log-set-output

log-set-output output=output [key=key] [level=level]

Setzen Sie alle Logger auf die angegebene Ausgabe (nil, stderr, string, file:filename, syslog:something).

Nachrichtenbefehle

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

Die Nachrichtenobjekte können mit dem Standardbefehl (xe message-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

Meldungsparameter

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die Nachricht Schreibgeschützt
name Der eindeutige Name der Nachricht Schreibgeschützt
priority Die Nachrichtenpriorität. Höhere Zahlen weisen eine höhere Priorität auf Schreibgeschützt
class Die Nachrichtenklasse, z. B. VM. Schreibgeschützt
obj-uuid Die uuid des betroffenen Objekts. Schreibgeschützt
timestamp Die Uhrzeit, zu der die Nachricht generiert wurde. Schreibgeschützt
body Der Nachrichteninhalt. Schreibgeschützt

message-create

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]]

Erstellt eine Nachricht.

message-destroy

message-destroy [uuid=message_uuid]

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

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

Netzwerkbefehle

Befehle zum Arbeiten mit Netzwerken.

Die Netzwerkobjekte können mit dem Standardbefehl (xe network-list) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

Netzwerkparameter

Netzwerke haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für das Netzwerk Schreibgeschützt
name-label Der Name des Netzwerks Lese-/Schreibzugriff
name-description Der Beschreibungstext des Netzwerks Lese-/Schreibzugriff
VIF-uuids Eine Liste eindeutiger Bezeichner der VIFs (virtuelle Netzwerkschnittstellen), die von VMs an dieses Netzwerk angeschlossen sind Schreibgeschützte Parameter
PIF-uuids Eine Liste der eindeutigen Bezeichner der PIFs (physische Netzwerkschnittstellen), die von Citrix Hypervisor or-Servern an dieses Netzwerk angeschlossen sind Schreibgeschützte Parameter
bridge Name der diesem Netzwerk entsprechenden Bridge auf dem lokalen Citrix Hypervisor or-Server Schreibgeschützt
default-locking-mode Ein Netzwerkobjekt, das mit VIF-Objekten für die ARP-Filterung verwendet wird. Setzen Sie aufunlocked , um alle Filterregeln zu entfernen, die dem VIF zugeordnet sind. Stellen Sie diese Einstellungdisabled so ein, dass der VIF den gesamten Datenverkehr löscht. Lese-/Schreibzugriff
purpose Satz von Zwecken, für die der Citrix Hypervisor or-Server dieses Netzwerk verwendet. Legen Sie festnbd , dass das Netzwerk zum Herstellen von NBD-Verbindungen verwendet wird. Lese-/Schreibzugriff
other-config:staticroutes Kommagetrennte Liste von Subnetz/Netzmaske/Gateway-formatiertenEinträgen, die die Gateway-Adresse angeben, über die Subnetze weitergeleitet werden sollen. Wenn Sie z. B.other-config:static-routes auf 172.16.0.0/15/192.168.0.3,172.18.0.0/16/192.168.0.4 festlegen, wird der Datenverkehr auf 172.16.0.0/15 über 192.168.0.3 und der Datenverkehr auf 172.18.0.0/16 über 192.168.0.4 geleitet. Lese-/Schreibzugriff
other-config:ethtoolautoneg Setzen Sie auf „no“, um die automatische Verhandlung der physischen Schnittstelle oder Brücke zu deaktivieren. Der Standardwert ist ja. Lese-/Schreibzugriff
other-config:ethtool-rx Auf „Ein“ setzen, um die Empfangsprüfsumme zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-tx Setzen Sie auf ein, um die Prüfsumme der Übertragung zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-sg Setzen Sie auf ein, um Scatter sammeln zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-tso Setzen Sie auf ein, um die TCP-Segmentierung Offload zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-ufo Setzen Sie auf ein, um die UDP-Fragmentabladung zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-gso Setzen Sie auf ein, um generische Segmentierungsabladung zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
blobs Binärer Datenspeicher Schreibgeschützt

network-create

network-create name-label=name_for_network [name-description=descriptive_text]

Erstellt ein Netzwerk.

network-destroy

network-destroy uuid=network_uuid

Zerstört ein vorhandenes Netzwerk.

SR-IOV-Befehle

Befehle für die Arbeit mit SR-IOV.

Die network-sriov-Objekte können mit dem standardmäßigen Objektlistenbefehl (xe network-sriov-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

SR-IOV-Parameter

SR-IOV hat die folgenden Parameter:

Parametername Beschreibung Typ
physical-PIF Die PIF, um SR-IOV zu aktivieren. Schreibgeschützt
logical-PIF Ein SR-IOV-logisches PIF. Benutzer können diesen Parameter verwenden, um ein SR-IOV-VLAN-Netzwerk zu erstellen. Schreibgeschützt
requires-reboot Wenn auf True festgelegt, wird der Host neu gestartet, um die SR-IOV-Aktivierung in Kraft zu setzen. Schreibgeschützt
remaining-capacity Anzahl der verbleibenden verfügbaren VFs. Schreibgeschützt

network-sriov-create

network-sriov-create network-uuid=network_uuid pif-uuid=physical_pif_uuid

Erstellt ein SR-IOV-Netzwerkobjekt für eine bestimmte physische PIF und aktiviert SR-IOV auf der physischen PIF.

network-sriov-destroy

network-sriov-destroy uuid=network_sriov_uuid

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

Zuweisen eines SR-IOV-VF

xe vif-create device=device_index mac=vf_mac_address network-uuid=sriov_network vm-uuid=vm_uuid

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

SDN-Controller Befehle

Befehle für die Arbeit mit dem SDN-Controller.

sdn-controller-forget

sdn-controller-introduce [address=address] [protocol=protocol] [tcp-port=tcp_port]

Einführung eines SDN-Controllers.

sdn-controller-introduce

sdn-controller-forget uuid=uuid

Entfernen Sie einen SDN-Controller.

Tunnelbefehle

Befehle für die Arbeit mit Tunneln.

tunnel-create

tunnel-create pif-uuid=pif_uuid network-uuid=network_uuid

Erstellen Sie einen neuen Tunnel auf einem Host.

tunnel-destroy

tunnel-destroy uuid=uuid

Zerstöre einen Tunnel.

Patch-Befehle

Befehle zum Arbeiten mit Patches.

patch-apply

patch-apply uuid=patch_uuid host-uuid=host_uuid

Wenden Sie den zuvor hochgeladenen Patch auf den angegebenen Host an.

patch-clean

patch-clean uuid=uuid

Löschen Sie eine zuvor hochgeladene Patch-Datei.

patch-destroy

patch-destroy uuid=uuid

Entfernen Sie einen nicht angewendeten Patchdatensatz und Dateien vom Server.

patch-pool-apply

patch-pool-apply uuid=uuid

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

patch-pool-clean

patch-pool-clean uuid=uuid

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

patch-precheck

patch-precheck uuid=uuid host-uuid=host_uuid

Führen Sie die Vorprüfungen aus, die im Patch enthalten sind, der zuvor auf den angegebenen Host hochgeladen wurde.

patch-upload

patch-upload file-name=file_name

Laden Sie eine Patchdatei auf den Server hoch.

PBD-Befehle

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

Die PBD-Objekte können mit dem Standard-Objektlistenbefehl (xe pbd-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

PBD-Parameter

PBDs haben folgende Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die PBD. Schreibgeschützt
sr-uuid Das Speicher-Repository, auf das die PBD verweist Schreibgeschützt
device-config Zusätzliche Konfigurationsinformationen, die dem SR-Backend-Treiber eines Hosts zur Verfügung gestellt werden Schreibgeschützte Kartenparameter
currently-attached True, wenn der SR auf diesem Host angehängt ist, andernfalls False Schreibgeschützt
host-uuid UUID des physischen Computers, auf dem die PBD verfügbar ist Schreibgeschützt
host Das Hostfeld ist veraltet. Verwenden Sie stattdessen host_uuid. Schreibgeschützt
other-config Zusätzliche Konfigurationsinformationen. Kartenparameter mit Lese-/Schreibzugriff

pbd-create

pbd-create host-uuid=uuid_of_host sr-uuid=uuid_of_sr [device-config:key=corresponding_value]

Erstellen Sie eine PBD auf dem Citrix Hypervisor or-Server. Der schreibgeschütztedevice-config Parameter kann nur bei der Erstellung festgelegt werden.

Um eine Zuordnung von ‘path’ zu ‘/tmp’ hinzuzufügen, sollte die Befehlszeile das Argumentdevice-config:path=/tmp

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

pbd-destroy

pbd-destroy uuid=uuid_of_pbd

Zerstören Sie die angegebene PBD.

pbd-plug

pbd-plug uuid=uuid_of_pbd

Versucht, die PBD mit dem Citrix Hypervisor or-Server zu verbinden. Wenn dieser Befehl erfolgreich ist, sollten die referenzierte SR (und die darin enthaltenen VDIs) für den Citrix Hypervisor or-Server sichtbar werden.

pbd-unplug

pbd-unplug uuid=uuid_of_pbd

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

PIF-Befehle

Befehle für die Arbeit mit PIF (Objekte, die die physischen Netzwerkschnittstellen darstellen).

Die PIF-Objekte können mit dem Standardbefehl (xe pif-list) aufgelistet und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

PIF-Parameter

PIF haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die PIF Schreibgeschützt
device machine-readable Name der Schnittstelle (z. B. eth0) Schreibgeschützt
MAC Die MAC-Adresse des PIF Schreibgeschützt
other-config Zusätzlichename:value PIF-Konfigurationspaare. Kartenparameter mit Lese-/Schreibzugriff
physical Wenn true, zeigt die PIF auf eine tatsächliche physische Netzwerkschnittstelle Schreibgeschützt
currently-attached Ist die PIF derzeit an diesem Host angeschlossen? true oderfalse Schreibgeschützt
MTU Maximale Übertragungseinheit des PIF in Byte. Schreibgeschützt
VLAN VLAN-Tag für den gesamten Datenverkehr, der diese Schnittstelle durchläuft. -1 gibt an, dass kein VLAN-Tag zugewiesen ist Schreibgeschützt
bond-master-of Die UUID der Bindung dieses PIF ist der Master (falls vorhanden) Schreibgeschützt
bond-slave-of Die UUID der Bindung dieses PIF ist der Slave von (falls vorhanden) Schreibgeschützt
management Ist diese PIF als Verwaltungsschnittstelle für die Steuerdomäne bestimmt Schreibgeschützt
network-uuid Die eindeutige Bezeichner/Objektreferenz des virtuellen Netzwerks, mit dem diese PIF verbunden ist Schreibgeschützt
network-name-label Der Name des virtuellen Netzwerks, mit dem diese PIF verbunden ist Schreibgeschützt
host-uuid Der eindeutige Bezeichner/Objektreferenz des Citrix Hypervisor or-Servers, mit dem diese PIF verbunden ist Schreibgeschützt
host-name-label Der Name des Citrix Hypervisor or-Servers, mit dem diese PIF verbunden ist Schreibgeschützt
IP-configuration-mode Typ der verwendeten Netzwerkadressenkonfiguration; DHCP oder statisch Schreibgeschützt
IP IP-Adresse des PIF. Hier definiert, wenn der IP-Konfigurations-Modus statisch ist; nicht definiert, wenn DHCP Schreibgeschützt
netmask Netzmaske des PIF. Hier definiert, wenn der IP-Konfigurations-Modus statisch ist; nicht definiert, wenn er von DHCP bereitgestellt wird Schreibgeschützt
gateway Gateway-Adresse des PIF. Hier definiert, wenn der IP-Konfigurations-Modus statisch ist; nicht definiert, wenn er von DHCP bereitgestellt wird Schreibgeschützt
DNS DNS-Adresse des PIF. Hier definiert, wenn der IP-Konfigurations-Modus statisch ist; nicht definiert, wenn er von DHCP bereitgestellt wird Schreibgeschützt
io_read_kbs Durchschnittliche Lesegeschote in KB/s für das Gerät Schreibgeschützt
io_write_kbs Durchschnittliche Schreibrate in KB/s für das Gerät Schreibgeschützt
carrier Verbindungsstatus für dieses Gerät Schreibgeschützt
vendor-id Die dem NIC-Hersteller zugewiesene ID Schreibgeschützt
vendor-name Name des NIC-Anbieters Schreibgeschützt
device-id Die vom Hersteller diesem NIC-Modell zugewiesene ID Schreibgeschützt
device-name Der vom Hersteller diesem NIC-Modell zugewiesene Name Schreibgeschützt
speed Datenübertragungsrate der NIC Schreibgeschützt
duplex Duplexmodus der NIC; voll oder halb Schreibgeschützt
pci-bus-path PCI-Buspfadadresse Schreibgeschützt
other-config:ethtoolspeed Legt die Geschwindigkeit der Verbindung in Mbit/s fest Lese-/Schreibzugriff
other-config:ethtoolautoneg Setzen Sie auf „no“, um die automatische Verhandlung der physischen Schnittstelle oder Brücke zu deaktivieren. Der Standardwert ist ja. Lese-/Schreibzugriff
other-config:ethtoolduplex Legt die Duplexfunktion des PIF fest, entweder voll oder halb. Lese-/Schreibzugriff
other-config:ethtool-rx Auf „Ein“ setzen, um die Empfangsprüfsumme zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-tx Setzen Sie auf ein, um die Prüfsumme der Übertragung zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-sg Setzen Sie auf ein, um Scatter sammeln zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-tso Setzen Sie auf ein, um die TCP-Segmentierung Offload zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-ufo Setzen Sie auf ein, um die udp-Fragmentabladung zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:ethtool-gso Setzen Sie auf ein, um generische Segmentierungsabladung zu aktivieren, aus, um zu deaktivieren Lese-/Schreibzugriff
other-config:domain Kommagetrennte Liste zum Festlegen des DNS-Suchpfads Lese-/Schreibzugriff
other-config:bondmiimon Intervall zwischen den Prüfungen der Verknüpfungsfähigkeit in Millisekunden Lese-/Schreibzugriff
other-config:bonddowndelay Anzahl der Millisekunden, die nach dem Verlust des Links gewartet werden müssen, bevor der Link wirklich verschwunden ist. Dieser Parameter ermöglicht einen vorübergehenden Verbindungsverlust Lese-/Schreibzugriff
other-config:bondupdelay Anzahl der Millisekunden, die gewartet werden müssen, nachdem der Link auftaucht, bevor er wirklich in Erwägung zieht. Ermöglicht das Flattern von Links. Der Standardwert ist31s , dass die Switches Zeit für die Weiterleitung des Datenverkehrs zulassen. Lese-/Schreibzugriff
disallow-unplug True, wenn diese PIF eine dedizierte Speicher-NIC ist, andernfalls false Lese-/Schreibzugriff

Hinweis:

Änderungen an denother-config Feldern eines PIF werden erst nach einem Neustart wirksam. Alternativ können Sie diexe pif-unplug Befehlexe pif-plug und verwenden, um die PIF-Konfiguration neu zu schreiben.

pif-forget

pif-forget uuid=uuid_of_pif

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

pif-introduce

pif-introduce host-uuid=host_uuid mac=mac_address_for_pif device=interface_name

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

pif-plug

pif-plug uuid=uuid_of_pif

Versuchen Sie, die angegebene physikalische Schnittstelle aufzurufen.

pif-reconfigure-ip

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]

Ändern Sie die IP-Adresse des PIF. Setzen Sie für die statische IP-Konfiguration denmode Parameter aufstatic , mit demgatewayIP```` , undnetmask`` Parameter, die auf die entsprechenden Werte festgelegt sind. Um DHCP zu verwenden, setzen Sie denmode Parameter aufDHCP und lassen Sie die statischen Parameter nicht definiert.

Hinweis:

Die Verwendung statischer IP-Adressen auf physischen Netzwerkschnittstellen, die mit einem Port eines Switches verbunden sind, das Spanning Tree Protocol verwendet und STP Fast Link deaktiviert (oder nicht unterstützt), führt zu einem Zeitraum, in dem kein Datenverkehr stattfindet.

pif-reconfigure-ipv6

pif-reconfigure-ipv6 uuid=uuid_of_pif mode=mode [gateway=network_gateway_address] [IPv6=static_ip_for_this_pif] [DNS=dns_address]

Konfigurieren Sie die IPv6-Adresseinstellungen auf einem PIF neu.

pif-scan

pif-scan host-uuid=host_uuid

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

pif-set-primary-address-type

pif-set-primary-address-type  uuid=uuid primary_address_type=address_type

Ändern Sie den primären Adresstyp, der von dieser PIF verwendet wird.

pif-unplug

pif-unplug uuid=uuid_of_pif

Versuchen Sie, die angegebene physikalische Schnittstelle herunterzufahren.

Poolbefehle

Befehle zum Arbeiten mit Pools. Ein Pool ist ein Aggregat aus einem oder mehreren Citrix Hypervisor or-Servern. Ein Pool verwendet ein oder mehrere freigegebene Speicher-Repositories, sodass die VMs, die auf einem Host im Pool ausgeführt werden, in nahezu Echtzeit auf einen anderen Host im Pool migriert werden können. Diese Migration erfolgt, während die VM noch ausgeführt wird, ohne dass sie heruntergefahren und wieder hochgefahren werden muss. Jeder Citrix Hypervisor or-Server ist wirklich ein Pool, der standardmäßig aus einem einzelnen Mitglied besteht. Wenn Ihr Citrix Hypervisor or-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-Objekt-Auflistungsbefehl (xe pool-list) aufgelistet werden. Seine Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

Pool-Parameter

Pools haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den Pool Schreibgeschützt
name-label Der Name des Pools Lese-/Schreibzugriff
name-description Die Beschreibungszeichenfolge des Pools Lese-/Schreibzugriff
master Der eindeutige Bezeichner/Objektreferenz des Citrix Hypervisor or-Servers, der als Master des Pools festgelegt ist Schreibgeschützt
default-SR Die eindeutige Bezeichner/Objektreferenz der Standard-SR für den Pool Lese-/Schreibzugriff
crash-dump-SR Die eindeutige Bezeichner/Objektreferenz der SR, in der alle Absturzabbilder für Pool-Mitglieder gespeichert werden Lese-/Schreibzugriff
metadata-vdis Alle bekannten Metadaten-VDIs für den Pool Schreibgeschützt
suspend-image-SR Die eindeutige Bezeichner/Objektreferenz der SR, in der suspendierte VMs auf Pool-Mitgliedern gespeichert werden Lese-/Schreibzugriff
other-config Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für den Pool angeben Kartenparameter mit Lese-/Schreibzugriff
supported-sr-types SR-Typen, die dieser Pool verwenden kann Schreibgeschützt
ha-enabled True, wenn HA für den Pool aktiviert ist, andernfalls false Schreibgeschützt
ha-configuration Reserviert für die zukünftige Nutzung. Schreibgeschützt
ha-statefiles Listet die UUIDs der VDIs auf, die von HA zur Ermittlung des Speicherzustands verwendet werden Schreibgeschützt
ha-host-failures-to-tolerate Die Anzahl der Hostfehler, die vor dem Senden einer Systemwarnung toleriert werden müssen Lese-/Schreibzugriff
ha-plan-exists-for Die Anzahl der Host-Ausfälle, die tatsächlich behandelt werden können, entsprechend den Berechnungen des HA-Algorithmus Schreibgeschützt
ha-allow-overcommit True, wenn der Pool überschrieben werden darf, andernfalls False Lese-/Schreibzugriff
ha-overcommitted True, wenn der Pool überschrieben ist Schreibgeschützt
blobs Binärer Datenspeicher Schreibgeschützt
live-patching-disabled Setzen Sie auf False, um Live-Patching zu aktivieren. Setzen Sie auf True, um Live-Patching zu deaktivieren. Lese-/Schreibzugriff
igmp-snooping-enabled Setzen Sie auf True, um IGMP-Snooping zu aktivieren. Setzen Sie auf False, um IGMP-Snooping zu deaktivieren. Lese-/Schreibzugriff

pool-apply-edition

pool-apply-edition edition=edition [uuid=uuid] [license-server-address=address] [license-server-port=port]

Wenden Sie eine Edition über den Pool.

pool-certificate-install

pool-certificate-install filename=file_name

Installieren Sie ein SSL-Zertifikat, pool-weit.

pool-certificate-list

pool-certificate-list

Liste aller installierten SSL-Zertifikate.

pool-certificate-sync

pool-certificate-sync

Synchronisieren Sie SSL-Zertifikate und Zertifikatsperrlisten von Master zu Slaves.

pool-certificate-uninstall

pool-certificate-uninstall name=name

Deinstallieren Sie ein SSL-Zertifikat.

pool-crl-install

pool-crl-install filename=file_name

Installieren Sie eine SSL-Zertifikatssperrliste, pool-weit.

pool-crl-list

pool-crl-list

Listen Sie alle installierten SSL-Zertifikatsperrlisten auf.

pool-crl-uninstall

pool-crl-uninstall name=name

Deinstallieren Sie eine SSL-Zertifikatssperrliste.

pool-deconfigure-wlb

pool-deconfigure-wlb

Entfernen Sie die Konfiguration für den Arbeitslastausgleich dauerhaft.

pool-designate-new-master

pool-designate-new-master host-uuid=uuid_of_new_master

Weisen Sie den angegebenen Citrix Hypervisor or-Server an, der Master eines vorhandenen Pools zu werden. Dieser Befehl führt eine geordnete Übergabe der Rolle des Master-Hosts 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 Notmodusbefehle.

pool-disable-external-auth

pool-disable-external-auth [uuid=uuid] [config=config]

Deaktiviert die externe Authentifizierung in allen Hosts in einem Pool.

pool-disable-local-storage-caching

pool-disable-local-storage-caching uuid=uuid

Deaktivieren Sie das lokale Speicher-Caching im gesamten Pool.

pool-disable-redo-log

pool-disable-redo-log

Deaktivieren Sie das Redo Log, wenn es verwendet wird, es sei denn, HA ist aktiviert.

pool-disable-ssl-legacy

pool-disable-ssl-legacy [uuid=uuid]

Setzen Sie ssl-legacy auf jedem Host auf False.

pool-dump-database

pool-dump-database file-name=filename_to_dump_database_into_(on_client)

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

pool-enable-external-auth

pool-enable-external-auth  auth-type=auth_type service-name=service_name [uuid=uuid] [config:=config]

Aktiviert die externe Authentifizierung in allen Hosts in einem Pool. Beachten Sie, dass einige Werte des auth-Typs bestimmte config: -Werte erfordern.

pool-enable-local-storage-caching

pool-enable-local-storage-caching uuid=uuid

Aktivieren Sie das lokale Speicher-Caching im gesamten Pool.

pool-enable-redo-log

pool-ensable-redo-log sr-uuid=sr_uuid

Aktivieren Sie das Redo Log für die angegebene SR, wenn sie verwendet wird, es sei denn, HA ist aktiviert.

pool-enable-ssl-legacy

pool-enable-ssl-legacy [uuid=uuid]

Setzen Sie ssl-legacy auf jedem Host auf True. „

pool-eject

pool-eject host-uuid=uuid_of_host_to_eject

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

pool-emergency-reset-master

pool-emergency-reset-master master-address=address_of_pool_master

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

pool-emergency-transition-to-master

pool-emergency-transition-to-master

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

Wenn das Hostkennwort 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

pool-ha-enable heartbeat-sr-uuids=uuid_of_heartbeat_sr

Aktivieren Sie Hochverfügbarkeit im Ressourcenpool, wobei die angegebene SR-UUID als zentrales Speicher-Heartbeat-Repository verwendet wird.

pool-ha-disable

pool-ha-disable

Deaktiviert die Hochverfügbarkeitsfunktion im Ressourcenpool.

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

Berechnen Sie die maximale Anzahl von Hostfehlern, die unter der aktuellen Poolkonfiguration toleriert werden sollen.

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

pool-ha-compute-hypothetical-max-host-failures-to-tolerate [vm-uuid=vm_uuid] [restart-priority=restart_priority]

Berechnen Sie die maximale Anzahl von Hostfehlern, die mit den bereitgestellten, vorgeschlagenen geschützten VMs toleriert werden sollen.

pool-initialize-wlb

pool-initialize-wlb wlb_url=url wlb_username=wlb_username wlb_password=wlb_password xenserver_username=username xenserver_password=password

Initialisieren Sie den Arbeitslastausgleich für den aktuellen Pool mit dem Ziel-WLB-Server.

pool-join

pool-join master-address=address master-username=username master-password=password

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

pool-management-reconfigure

pool-management-reconfigure [network-uuid=network-uuid]

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

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

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

Warnhinweis:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass Sie über Netzwerkkonnektivität auf der neuen Schnittstelle verfügen. Verwenden Sie xe pif-reconfigure, um eine zuerst einzurichten. Andernfalls können nachfolgende CLI-Befehle den Citrix Hypervisor or-Server nicht erreichen.

pool-recover-slaves

pool-recover-slaves

Weisen Sie den Poolmaster an, die Master-Adresse aller Mitglieder zurückzusetzen, die derzeit im Notfallmodus ausgeführt werden. Dieser Befehl wird in der Regel verwendet, nachdem verwendetpool-emergency-transition-to-master wurde, um eines der Elemente als neuen Master festzulegen.

pool-restore-database

pool-restore-database file-name=filename_to_restore_from_on_client [dry-run=true|false]

Laden Sie eine Datenbanksicherung (erstellt mitpool-dump-database) in einen Pool hoch. Beim Empfang des Uploads startet der Master selbst mit der neuen Datenbank neu.

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

pool-retrieve-wlb-configuration

pool-retrieve-wlb-configuration

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

pool-retrieve-wlb-diagnostics

pool-retrieve-wlb-diagnostics [filename=file_name]

Ruft die Diagnose vom Workload-Balancing-Server ab.

pool-retrieve-wlb-recommendations

pool-retrieve-wlb-recommendations

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

pool-retrieve-wlb-report

pool-retrieve-wlb-report report=report [filename=file_name]

Ruft Berichte vom Workload-Balancing-Server ab.

pool-send-test-post

pool-send-test-post dest-host=destination_host dest-port=destination_port body=post_body

Senden Sie den gegebenen Körper mit HTTPS an den angegebenen Host und Port und drucken Sie die Antwort. Dies wird zum Debuggen der SSL-Schicht verwendet.

pool-send-wlb-configuration

pool-send-wlb-configuration [config:=config]

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

pool-sync-database

pool-sync-database

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

Pooligmp-snooping

pool-param-set [uuid=pool-uuid] [igmp-snooping-enabled=true|false]

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

PVS Accelerator-Befehle

Befehle für die Arbeit mit dem PVS Accelerator.

pvs-cache-storage-create

pvs-cache-storage-create sr-uuid=sr_uuid pvs-site-uuid=pvs_site_uuid size=size

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

pvs-cache-storage-destroy

pvs-cache-storage-destroy uuid=uuid

Entfernen Sie einen PVS-Cache.

pvs-proxy-create

pvs-proxy-create pvs-site-uuid=pvs_site_uuid vif-uuid=vif_uuid

Konfigurieren Sie einen VM/VIF für die Verwendung eines PVS-Proxy.

pvs-proxy-destroy

pvs-proxy-destroy uuid=uuid

Entfernen (oder ausschalten) eines PVS-Proxy für diese VIF/VM.

pvs-server-forget

pvs-server-forget uuid=uuid

Vergessen Sie einen PVS-Server.

pvs-server-introduce

pvs-server-introduce addresses=adresses first-port=first_port last-port=last_port pvs-site-uuid=pvs_site_uuid

Einführung eines neuen PVS-Servers.

pvs-site-forget

pvs-site-forget uuid=uuid

Vergessen Sie eine PVS-Website.

pvs-site-introduce

pvs-site-introduce name-label=name_label [name-description=name_description] [pvs-uuid=pvs_uuid]

Einführung neuer PVS-Website.

Storage Manager-Befehle

Befehle zum Steuern von Storage Manager-Plugins.

Die Speichermanager-Objekte können mit dem Befehl zur Standardobjektauflistung (xe sm-list) aufgelistet werden. Die Parameter können mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

SM-Parameter

SMs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für das SM-Plugin Schreibgeschützt
name-label Der Name des SM-Plugins Schreibgeschützt
name-description Die Beschreibungszeichenfolge des SM-Plugins Schreibgeschützt
type Der SR-Typ, mit dem dieses Plugin eine Verbindung herstellt Schreibgeschützt
vendor Name des Anbieters, der dieses Plugin erstellt hat Schreibgeschützt
copyright Copyright-Erklärung für dieses SM-Plugin Schreibgeschützt
required-api-version Minimale SM-API-Version auf dem Citrix Hypervisor or-Server erforderlich Schreibgeschützt
configuration Namen und Beschreibungen der Gerätekonfigurationsschlüssel Schreibgeschützt
capabilities Funktionen des SM-Plugins Schreibgeschützt
driver-filename Der Dateiname des SR-Treibers. Schreibgeschützt

Snapshot-Befehle

Befehle zum Arbeiten mit Snapshots.

snapshot-clone

snapshot-clone new-name-label=name_label [uuid=uuid] [new-name-description=description]

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

snapshot-copy

snapshot-copy new-name-label=name_label [uuid=uuid] [new-name-description=name_description] [sr-uuid=sr_uuid]

Erstellen Sie eine neue Vorlage, indem Sie eine vorhandene VM kopieren, ohne den schnellen Festplattenklonvorgang auf Speicherebene zu verwenden (auch wenn diese verfügbar ist). Die Disk-Images der kopierten VM sind garantiert „vollständige Bilder“ - d.h. nicht Teil einer KuW-Kette.

snapshot-destroy

snapshot-destroy  [uuid=uuid] [snapshot-uuid=snapshot_uuid]

Einen Schnappschuss zerstören. Dadurch bleibt der mit dem Snapshot verknüpfte Speicher intakt. Um auch Speicher zu löschen, verwenden Sie snapshot-uninstall.

snapshot-disk-list

snapshot-disk-list [uuid=uuid] [snapshot-uuid=snapshot_uuid] [vbd-params=vbd_params] [vdi-params=vdi_params]

Listen Sie die Datenträger auf den ausgewählten virtuellen Rechnern auf.

snapshot-export-to-template

snapshot-export-to-template filename=file_name snapshot-uuid=snapshot_uuid  [preserve-power-state=true|false]

Exportieren Sie einen Snapshot in Dateiname.

snapshot-reset-powerstate

snapshot-reset-powerstate [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]

Erzwingen Sie, dass der VM-Powerstate nur in der Management-Toolstack-Datenbank angehalten wird. Dieser Befehl wird verwendet, um einen Snapshot wiederherzustellen, der als „suspendiert“ markiert ist. Dies ist eine potenziell gefährliche Operation: Sie müssen sicherstellen, dass Sie das Speicherbild nicht mehr benötigen (dh Sie können Ihren Snapshot nicht mehr fortsetzen).

snapshot-revert

snapshot-revert [uuid=uuid] [snapshot-uuid=snapshot_uuid]

Stellen Sie eine vorhandene VM in einen vorherigen Status mit Checkpoint- oder Snapshott-Status zurück.

snapshot-uninstall

snapshot-uninstall [uuid=uuid] [snapshot-uuid=snapshot_uuid] [--force]

Deinstallieren Sie einen Snapshot. Dieser Vorgang zerstört die VDIs, die als RW markiert sind und nur mit diesem Snapshot verbunden sind. Um den VM-Eintrag einfach zu zerstören, verwenden Sie snapshot-destroy.

SR-Befehle

Befehle zur Steuerung von SRs (Storage Repositories).

Die SR-Objekte können mit dem Befehl zur Standardobjektauflistung (xe sr-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

SR-Parameter

SRs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die SR Schreibgeschützt
name-label Der Name der SR Lese-/Schreibzugriff
name-description Die Beschreibungszeichenfolge der SR Lese-/Schreibzugriff
allowed-operations Liste der zulässigen Vorgänge auf der SR in diesem Zustand Schreibgeschützte Parameter
current-operations Liste der Vorgänge, die derzeit auf dieser SR ausgeführt werden Schreibgeschützte Parameter
VDIs Eindeutige Bezeichner/Objektreferenz für die virtuellen Laufwerke in dieser SR Schreibgeschützte Parameter
PBDs Eindeutige Bezeichner/Objektreferenz für die an diese SR angeschlossenen PBDs Schreibgeschützte Parameter
physical-utilisation Physischer Speicherplatz, der derzeit auf dieser SR in Bytes belegt wird. Für Thin Provisioned Datenträgerformate kann die physische Auslastung geringer sein als die virtuelle Zuweisung Schreibgeschützt
physical-size Physische Gesamtgröße des SR in Byte Schreibgeschützt
type Typ des SR, der verwendet wird, um den SR-Back-End-Treiber anzugeben, der verwendet werden soll Schreibgeschützt
introduced-by Die drtask (falls vorhanden), die die SR eingeführt hat Schreibgeschützt
content-type Der Typ des SR-Inhalts. Wird verwendet, um ISO-Bibliotheken von anderen SRs zu unterscheiden. Für Speicher-Repositories, die eine Bibliothek von ISOs speichern, muss der Inhaltstyp auf iso gesetzt werden. In anderen Fällen empfiehlt es sich, diesen Parameter entweder auf leer oder auf den Zeichenfolgenbenutzer zu setzen. Schreibgeschützt
shared True, wenn diese SR von mehreren Citrix Hypervisor or-Servern gemeinsam genutzt werden kann; andernfalls False Lese-/Schreibzugriff
other-config Liste der Schlüssel/Wert-Paare, die zusätzliche Konfigurationsparameter für die SR angeben Kartenparameter mit Lese-/Schreibzugriff
host Der Hostname des Speicher-Repositorys Schreibgeschützt
virtual-allocation Summe der Werte virtueller Größe aller VDIs in diesem Speicher-Repository (in Byte) Schreibgeschützt
sm-config SM-abhängige Daten Schreibgeschützte Kartenparameter
blobs Binärer Datenspeicher Schreibgeschützt

sr-create

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]

Erstellt einen SR auf dem Datenträger, führt ihn in die Datenbank ein und erstellt eine PBD, die den SR an den Citrix Hypervisor or-Server anfügt. Wenn auf festgelegtshared isttrue , wird für jeden Citrix Hypervisor or-Server im Pool eine PBD erstellt. Wenn nicht angegeben oder auf festgelegtshared istfalse , wird eine PBD nur für den mit angegebenen Citrix Hypervisor or-Server erstellthost-uuid .

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

sr-data-source-forget

sr-data-source-forget data-source=data_source

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

sr-data-source-list

sr-data-source-list"

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

sr-data-source-query

sr-data-source-query data-source=data_source

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

sr-data-source-record

sr-data-source-record  data-source=data_source

Zeichnen Sie die angegebene Datenquelle für einen SR auf.

sr-destroy

sr-destroy uuid=sr_uuid

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

sr-enable-database-replication

sr-enable-database-replication uuid=sr_uuid

Aktiviert die XAPI-Datenbankreplikation auf die angegebene (gemeinsam genutzte) SR.

sr-disable-database-replication

sr-disable-database-replication uuid=sr_uuid

Deaktiviert die XAPI-Datenbankreplikation auf die angegebene SR.

sr-forget

sr-forget uuid=sr_uuid

Der XAPI-Agent vergisst eine bestimmte SR auf dem Citrix Hypervisor or-Server. Wenn der XAPI-Agent einen SR vergisst, wird der SR getrennt, und Sie können nicht auf VDIs zugreifen, aber er bleibt auf dem Quellmedium intakt (die Daten gehen nicht verloren).

sr-introduce

sr-introduce name-label=name physical-size=physical_size type=type content-type=content_type uuid=sr_uuid

Platziert einfach einen SR-Datensatz in die Datenbank. device-config Hiermit können Sie zusätzliche Parameter in Form angebendevice-config:parameter_key=parameter_value , z. B.:

xe sr-introduce device-config:device=/dev/sdb1

Hinweis:

Dieser Befehl wird nie im normalen Betrieb verwendet. Dieser erweiterte Vorgang kann nützlich sein, wenn ein SR nach der Erstellung als freigegeben neu konfiguriert werden muss oder um die Wiederherstellung von verschiedenen Ausfallszenarien zu erleichtern.

sr-probe

sr-probe type=type [host-uuid=host_uuid] [device-config:config_name=value]

Führt einen Backend-spezifischen Scan mit den bereitgestelltendevice-config Schlüsseln durch. Wenn der für das SR-Back-End abgeschlossendevice-config ist, gibt dieser Befehl eine Liste der SRs zurück, die auf dem Gerät vorhanden sind. Wenn diedevice-config Parameter nur teilweise sind, wird ein Back-End-spezifischer Scan durchgeführt, der Ergebnisse zurückgibt, die Sie bei der Verbesserung der verbleibendendevice-config Parameter leiten. Die Scan-Ergebnisse werden als Backend-spezifisches XML zurückgegeben, das auf der CLI gedruckt wird.

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

sr-probe-ext

sr-probe-ext type=type [host-uuid=host_uuid] [device-config:=config] [sm-config:-sm_config]

Führen Sie eine Speichersonde durch. Die Device-Config-Parameter können z.B. durch device-config:devs=/dev/sdb1 angegeben werden. Im Gegensatz zu sr-probe gibt dieser Befehl Ergebnisse für jeden SR-Typ in demselben lesbaren Format zurück.

sr-scan

sr-scan uuid=sr_uuid

Erzwingen Sie einen SR-Scan, indem Sie die XAPI-Datenbank mit VDIs synchronisieren, die im zugrunde liegenden Speichersubstrat vorhanden sind.

sr-update

sr-update uuid=uuid

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

lvhd-enable-thin-provisioning

lvhd-enable-thin-provisioning  sr-uuid=sr_uuid initial-allocation=initial_allocation allocation-quantum=allocation_quantum

Aktivieren Sie Thin-Provisioning auf einem LVHD SR.

Betreff Befehle

Befehle für die Arbeit mit Themen.

session-subject-identifier-list

session-subject-identifier-list

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

session-subject-identifier-logout

session-subject-identifier-logout subject-identifier=subject_identifier

Melden Sie sich alle extern authentifizierten Sitzungen ab, die einer Benutzer-Betreff-ID zugeordnet sind.

session-subject-identifier-logout-all

session-subject-identifier-logout-all

Melden Sie sich alle extern authentifizierten Sitzungen ab.

subject-add

subject-add subject-name=subject_name

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

subject-remove

subject-remove subject-uuid=subject_uuid

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

subject-role-add

subject-role-add uuid=uuid [role-name=role_name] [role-uuid=role_uuid]

Hinzufügen einer Rolle zu einem Betreff.

subject-role-remove

subject-role-remove uuid=uuid [role-name=role_name] [role-uuid=role_uuid]

Entfernen einer Rolle aus einem Betreff.

secret-create

secret-create value=value

Erstelle ein Geheimnis.

secret-destroy

secret-destroy uuid=uuid

Zerstöre ein Geheimnis.

Aufgabenbefehle

Befehle zum Arbeiten mit lang laufenden asynchronen Aufgaben. Bei diesen Befehlen handelt es sich um Aufgaben wie Starten, Beenden und Anhalten einer virtuellen Maschine. Die Aufgaben bestehen in der Regel aus einer Reihe anderer atomarer Teilaufgaben, die gemeinsam den angeforderten Vorgang ausführen.

Die Aufgabenobjekte können mit dem Standardbefehl (xe task-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

Vorgangsparameter

Aufgaben haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die Aufgabe Schreibgeschützt
name-label Der Name der Aufgabe Schreibgeschützt
name-description Die Beschreibungszeichenfolge der Aufgabe Schreibgeschützt
resident-on Die eindeutige Bezeichner/Objektreferenz des Hosts, auf dem die Aufgabe ausgeführt wird Schreibgeschützt
status Status der Aufgabe Schreibgeschützt
progress Wenn der Vorgang noch ausstehend ist, enthält dieses Feld den geschätzten Prozentsatz, der abgeschlossen ist, von 0 bis 1. Wenn die Aufgabe erfolgreich oder erfolglos abgeschlossen wurde, ist der Wert 1. Schreibgeschützt
type Wenn die Aufgabe erfolgreich abgeschlossen wurde, enthält dieser Parameter den Typ des codierten Ergebnisses. Der Typ ist der Name der Klasse, deren Referenz sich im Ergebnisfeld befindet. Andernfalls ist der Wert dieses Parameters nicht definiert Schreibgeschützt
result Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält dieses Feld den Ergebniswert, entweder Void oder einen Objektreferenz. Andernfalls ist der Wert dieses Parameters nicht definiert. Schreibgeschützt
error_info Wenn der Task fehlgeschlagen ist, enthält dieser Parameter den Satz der zugeordneten Fehlerzeichenfolgen. Andernfalls ist der Wert dieses Parameters nicht definiert Schreibgeschützt
allowed_operations Liste der in diesem Zustand zulässigen Vorgänge Schreibgeschützt
created Zeitpunkt der Erstellung der Aufgabe Schreibgeschützt
finished Zeitaufgabe abgeschlossen (d. h. erfolgreich oder fehlgeschlagen). Wenn der Aufgabenstatus ausstehend ist, hat der Wert dieses Feldes keine Bedeutung Schreibgeschützt
subtask_of Enthält die UUID der Aufgaben, die dieser Task eine Teilaufgabe von Schreibgeschützt
subtasks Enthält die UUIDs aller Teilaufgaben dieser Aufgabe Schreibgeschützt

task-cancel

task-cancel [uuid=task_uuid]

Die angegebene Aufgabe soll abbrechen und zurückgeben.

Vorlagenbefehle

Befehle zum Arbeiten mit VM-Vorlagen.

Vorlagen sind im Wesentlichen VMs mit demis-a-template Parameter auftrue . 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 ausgeliefert, bei denen es sich um generische „rohe“ VMs handelt, die eine Installations-CD des Betriebssystemherstellers starten können (z. B. RHEL, CentOS, SLES, Windows). Sie können VMs erstellen, 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 standardmäßigen Objektlistenbefehl (xe template-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

Hinweis:

Vorlagen können nicht direkt in VMs konvertiert werden, indem deris-a-template Parameter auf festgelegt wirdfalse . Das Festlegen desis-a-template Parameters auffalse wird nicht unterstützt und führt zu einer virtuellen Maschine, die nicht gestartet werden kann.

VM-Vorlagenparameter

Vorlagen haben die folgenden Parameter:

  • uuid ( schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die Vorlage
  • name-label ( Lese-/Schreibzugriff) der Name der Vorlage
  • name-description ( Lese-/Schreibzugriff) der Beschreibungszeichenfolge der Vorlage
  • user-version ( Lese-/Schreibzeichenfolge) für Ersteller von VMs und Vorlagen, um Versionsinformationen zu setzen
  • is-a-template ( read/write) true, wenn diese VM eine 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 VMs konvertiert werden.
  • is-control-domain ( schreibgeschützt) true, wenn dies eine Steuerdomäne ist (Domäne 0 oder eine Treiberdomäne)
  • power-state ( schreibgeschützt) Stromzustand. Der Wert wird immer für eine Vorlage angehalten
  • memory-dynamic-max ( schreibgeschützt) dynamischer maximaler Speicher in Byte. Derzeit nicht verwendet, aber wenn geändert, muss die folgende Einschränkung beachtet werden:memory_static_max>=memory_dynamic_max>=```````memory_dynamic_min>=memory_static_min```` .`
  • memory-dynamic-min ( Lese-/Schreibzugriff) dynamischer Mindestspeicher in Bytes. Derzeit nicht verwendet, aber wenn geändert,memory-dynamic-max müssen die gleichen Einschränkungen für eingehalten werden.
  • memory-static-max ( Lese-/Schreibzugriff) statisch festgelegter (absoluter) maximaler Speicher in Bytes. Dieses Feld ist der Hauptwert, der verwendet wird, um die Speichermenge zu bestimmen, die einer VM zugewiesen ist.
  • memory-static-min ( Lese-/Schreibzugriff) statisch festgelegter (absoluter) Mindestspeicher in Bytes. Dieses Feld stellt den absoluten Mindestspeicher dar undmemory-static-min muss kleiner sein alsmemory-static-max . 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)
  • -Konfigurationsparameter VCPUs-params (Lese-/Schreibzuordnungsparameter) für die ausgewählte vCPU-Richtlinie.

    Sie können das Anheften einer vCPU optimieren mit:

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

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

    Sie können auch die vCPU-Priorität (xen-Scheduling) mit den Parametern cap und weight optimieren. Zum Beispiel:

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

    Eine VM, die auf dieser Vorlage mit einem Gewicht von 512 basiert, erhält doppelt so viel CPU wie eine Domain mit einem Gewicht von 256 auf einem beanspruchten Host. Die zulässigen Gewichtungen liegen zwischen 1 und 65535 und der Standardwert ist 256.

    Die Kappe behebt optional die maximale CPU-Menge, die eine VM auf Basis dieser Vorlage belegen kann, selbst wenn der Citrix Hypervisor or-Server über Leerlauf-CPU-Zyklen verfügt. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 ist 4 CPUs usw. Der Standardwert 0 bedeutet, dass keine obere Obergrenze vorhanden ist.

  • VCPUs-max ( Lese-/Schreibzugriff) maximale Anzahl von vCPUs
  • VCPUs-at-startup ( Lese-/Schreibzugriff) Startnummer von vCPUs
  • actions-after-crash ( Lese-/Schreibvorgang) -Aktion, die ausgeführt wird, wenn eine auf dieser Vorlage basierende VM abstürzt
  • console-uuids ( schreibgeschützte Parameter) virtuelle Konsolengeräte
  • platform ( Lese-/Schreibzuordnungsparameter) plattformspezifische Konfiguration

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

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

    So deaktivieren Sie die Emulation eines seriellen Ports für HVM-Gäste:

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

    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
    
  • Liste der in diesem Zustand zulässigen Operationen allowed-operations (read only set parameter)
  • current-operations ( Read Only Set Parameter) Liste der Vorgänge, die derzeit in dieser Vorlage ausgeführt werden
  • allowed-VBD-devices ( read only set parameter) Liste der verfügbaren VBD-Bezeichner, die durch ganze Zahlen im Bereich 0—15 dargestellt werden. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (aber möglicherweise nicht funktionieren).
  • allowed-VIF-devices ( read only set parameter) Liste der zur Verwendung verfügbaren VIF-Bezeichner, dargestellt durch ganze Zahlen im Bereich 0—15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (aber möglicherweise nicht funktionieren).
  • HVM-boot-policy ( Lese-/Schreibzugriff) die Boot-Richtlinie für HVM-Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge.
  • HVM-boot-params ( Lese-/Schreibzuordnungsparameter) steuert der Orderschlüssel die HVM-Gaststartreihenfolge, die als Zeichenfolge dargestellt wird, wobei jedes Zeichen eine Boot-Methode ist: d für die CD/DVD, c für die Root-Diskette und n für den Netzwerk-PXE-Start. Der Standardwert ist dc.
  • PV-kernel ( Lese-/Schreibzugriff) Pfad zum Kernel
  • PV-ramdisk ( Lese-/Schreibzugriff) Pfad zum initrd
  • PV-args ( Lese-/Schreibzeichenfolge) von Kernel-Befehlszeilenargumenten
  • PV-legacy-args ( Lese-/Schreibzeichenfolge), um Legacy-VMs basierend auf dieser Vorlage booten zu lassen
  • PV-bootloader ( Lese-/Schreibzugriff) Name oder Pfad zum Bootloader
  • PV-bootloader-args ( Lese-/Schreib-) Zeichenfolge mit verschiedenen Argumenten für den Bootloader
  • last-boot-CPU-flags ( schreibgeschützt) beschreibt die CPU-Flags, auf denen eine VM, die auf dieser Vorlage basiert, zuletzt gestartet wurde; nicht für eine Vorlage aufgefüllt
  • resident-on ( schreibgeschützt) der Citrix Hypervisor or-Server, auf dem sich eine auf dieser Vorlage basierende VM befindet. Erscheint wie not in database für eine Vorlage
  • affinity ( Lese-/Schreibzugriff) des Citrix Hypervisor or-Servers, auf dem eine VM basierend auf dieser Vorlage Vorgabe ausgeführt werden kann. Wird vom xe vm-start Befehl verwendet, um zu entscheiden, wo die VM ausgeführt werden soll.
  • other-config ( Lese-/Schreibzuordnungsparameter) Liste der Schlüssel/Wert-Paare, die zusätzliche Konfigurationsparameter für die Vorlage angeben
  • start-time ( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu dem die Metriken für eine VM auf der Grundlage dieser Vorlage gelesen wurden, in der FormyyyymmddThh:mm:ss z , wobei z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT). Legen Sie für eine Vorlage auf 1 Jan 1970 Z (Anfang der Unix/POSIX-Epoche) fest
  • install-time ( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu dem die Metriken für eine VM auf der Grundlage dieser Vorlage gelesen wurden, in der FormyyyymmddThh:mm:ss z , wobei z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT). Legen Sie für eine Vorlage auf 1 Jan 1970 Z (Anfang der Unix/POSIX-Epoche) fest
  • memory-actual ( schreibgeschützt) der tatsächliche Speicher, der von einer VM verwendet wird, basierend auf dieser Vorlage; 0 für eine Vorlage
  • VCPUs-number ( schreibgeschützt) die Anzahl der virtuellen CPUs, die einer VM basierend auf dieser Vorlage zugewiesen sind; 0 für eine Vorlage
  • VCPUs-Utilization ( Read Only Map-Parameter) Liste der virtuellen CPUs und deren Gewichtung schreibgeschützte Map-Parameter OS-Version der Version des Betriebssystems für eine VM basierend auf dieser Vorlage. Erscheint wie not in database für eine Vorlage
  • PV-drivers-version ( schreibgeschützte Zuordnungsparameter) die Versionen der paravirtualisierten Treiber für eine VM basierend auf dieser Vorlage. Erscheint wie not in database für eine Vorlage
  • PV-drivers-detected ( schreibgeschützt) für die neueste Version der paravirtualisierten Treiber für eine VM basierend auf dieser Vorlage. Erscheint wie not in database für eine Vorlage
  • memory ( schreibgeschützte Zuordnungsparameter) Memory-Metriken, die vom Agenten auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint wie not in database für eine Vorlage
  • disks ( schreibgeschützte Zuordnungsparameter) Datenträgermetriken, die vom Agenten auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint wie not in database für eine Vorlage
  • networks ( schreibgeschützte Zuordnungsparameter) Netzwerkmetriken, die vom Agenten auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint wie not in database für eine Vorlage
  • other ( schreibgeschützte Zuordnungsparameter) andere Metriken, die vom Agenten auf einer VM basierend auf dieser Vorlage gemeldet werden. Erscheint wie not in database für eine Vorlage
  • guest-metrics-last-updated ( schreibgeschützt) Zeitstempel, wenn der In-Gast-Agent das letzte Schreiben in diese Felder durchgeführt hat. In der FormyyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT)
  • actions-after-shutdown ( Lese-/Schreibvorgang) -Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
  • actions-after-reboot ( Lese-/Schreibvorgang) -Aktion, die nach dem Neustart der VM ausgeführt werden soll
  • possible-hosts ( schreibgeschützt) Liste der Hosts, die möglicherweise die VM hosten könnten
  • HVM-shadow-multiplier ( Lese-/Schreib-) Multiplikator angewendet auf die Menge an Schatten, die dem Gast zur Verfügung gestellt wird
  • dom-id ( schreibgeschützt) Domain-ID (falls verfügbar, andernfalls -1)
  • recommendations ( schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
  • xenstore-data ( Lese-/Schreibzuordnungsparameter) -Daten, die in den xenstore-Baum (/local/domain/domid /vmdata) eingefügt werden, nachdem die VM erstellt wurde.
  • is-a-snapshot ( schreibgeschützt) True, wenn es sich bei dieser Vorlage um einen VM-Snapshot handelt
  • snapshot_of ( schreibgeschützt) die UUID der VM, die diese Vorlage ein Snapshot von
  • snapshots ( schreibgeschützt) die UUIDs aller Snapshots, die aus dieser Vorlage erstellt wurden
  • snapshot_time ( schreibgeschützt) der Zeitstempel des letzten VM-Snapshots
  • memory-target ( schreibgeschützt) die Zielmenge des Speichersatzes für diese Vorlage
  • blocked-operations ( Kartenparameter mit Lese-/Schreibzugriff) listet die Vorgänge auf, die für diese Vorlage nicht ausgeführt werden können
  • last-boot-record ( schreibgeschützt) Datensatz der letzten Boot-Parameter für diese Vorlage im XML-Format
  • ha-always-run ( read/write) True, wenn eine Instanz dieser Vorlage immer auf einem anderen Host neu gestartet wird, wenn ein Fehler des Hosts auftritt, auf dem er sich befindet. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den ha-restartpriority Parameter.
  • ha-restart-priority ( schreibgeschützt) Neustart oder Best-Effort-Lese-/Schreib-BLOBs binärer Datenspeicher
  • live ( schreibgeschützt), die nur für eine laufende VM relevant ist.

template-export

template-export template-uuid=uuid_of_existing_template filename=filename_for_new_template

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

template-uninstall

template-uninstall template-uuid=template_uuid [--force]

Deinstallieren Sie eine benutzerdefinierte Vorlage. Dieser Vorgang zerstört die VDIs, die von dieser Vorlage als „Eigentum“ gekennzeichnet sind.

Aktualisierungsbefehle

Der folgende Abschnitt enthält Update-Befehle für Citrix Hypervisor Server.

Die Aktualisierungsobjekte können mit dem Befehl zur Standardobjektauflistung (xe update-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

Aktualisierungsparameter

Citrix Hypervisor -Serverupdates verfügen über die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für das Update Schreibgeschützt
host Die Liste der Hosts, auf die dieses Update angewendet wird Schreibgeschützt
host-uuid Der eindeutige Bezeichner für die Abfrage des Citrix Hypervisor or-Servers Schreibgeschützt
name-label Der Name des Updates Schreibgeschützt
name-description Die Beschreibungszeichenfolge des Updates Schreibgeschützt
applied Gibt an, ob die Aktualisierung angewendet wurde; true oder false Schreibgeschützt
installation-size Die Größe der Aktualisierung in Bytes Schreibgeschützt
after-apply-guidance Gibt an, ob der XAPI-Toolstack oder der Host einen Neustart erfordert Schreibgeschützt
version Die Version des Updates Schreibgeschützt

update-upload

update-upload file-name=update_filename

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

update-precheck

update-precheck uuid=update_uuid host-uuid=host_uuid

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

update-destroy

update-destroy uuid=update_file_uuid

Löscht eine Update-Datei, die nicht aus dem Pool angewendet wurde. Kann verwendet werden, um eine Update-Datei zu löschen, die nicht auf die Hosts angewendet werden kann.

update-apply

update-apply host-uuid=host_uuid uuid=update_file_uuid

Wenden Sie die angegebene Update-Datei an.

update-pool-apply

update-pool-apply uuid=update_uuid

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

update-introduce

update-introduce vdi-uuid=vdi_uuid

Update VDI einführen.

update-pool-clean

update-pool-clean uuid=uuid

Entfernt die Dateien des Updates von allen Hosts im Pool.

Benutzerbefehle

user-password-change

user-password-change old=old_password new=new_password

Ändert das Kennwort des angemeldeten Benutzers. Das alte Kennwortfeld ist nicht aktiviert, da Sie Supervisor-Berechtigungen benötigen, um diesen Befehl zu verwenden.

VBD-Befehle

Befehle zum Arbeiten mit VBDs (Virtual Block Devices).

Ein 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 an die VM binden (ist es bootfähig, seine Lese-/Schreibmetriken usw.). Der VDI enthält Informationen zu den physikalischen Attributen des virtuellen Laufwerks (welcher Typ von SR, ob der Datenträger gemeinsam verwendet werden kann, ob das Medium schreibgeschützt oder schreibgeschützt ist usw.).

Die VBD-Objekte können mit dem Standard-Objektlistenbefehl (xe vbd-list) aufgelistet werden, und die Parameter werden mit den Standardparameterbefehlen manipuliert. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

VBD-Parameter

VBDs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für die VBD Schreibgeschützt
vm-uuid Die eindeutige Bezeichner/Objektreferenz für die VM, an die diese VBD angehängt ist Schreibgeschützt
vm-name-label Der Name der VM, an die diese VBD angehängt ist Schreibgeschützt
vdi-uuid Die eindeutige Bezeichner/Objektreferenz für den VDI, dem diese VBD zugeordnet ist Schreibgeschützt
vdi-name-label Der Name des VDI, dem diese VBD zugeordnet ist Schreibgeschützt
empty Wenntruedieser VBD ein leeres Laufwerk darstellt Schreibgeschützt
device Das Gerät, das vom Gast gesehen wird, zum Beispielhda Schreibgeschützt
userdevice Gerätenummervbd-create, die durch den Geräteparameter angegeben werden, z. B. 0 für hda, 1 für hdb usw. Lese-/Schreibzugriff
bootable True, wenn diese VBD bootfähig ist Lese-/Schreibzugriff
mode Der Modus, in dem der VBD mit Lese-/Schreibzugriff
type Wie die VBD auf der VM angezeigt wird, z. B. auf Festplatte oder CD Lese-/Schreibzugriff
currently-attached True, wenn die VBD auf diesem Host angehängt ist, andernfalls false Schreibgeschützt
storage-lock True, wenn eine Sperre auf Speicherebene erworben wurde Schreibgeschützt
status-code Fehler-/Erfolgscode, der mit dem letzten Anfügevorgang verknüpft ist Schreibgeschützt
status-detail Fehler-/Erfolgsinformationen, die mit dem Status des letzten Anfügevorgangs verknüpft sind Schreibgeschützt
qos_algorithm_type Der zu verwendende QoS-Algorithmus Lese-/Schreibzugriff
qos_algorithm_params Parameter für den gewählten QoS-Algorithmus Kartenparameter mit Lese-/Schreibzugriff
qos_supported_algorithms Unterstützte QoS-Algorithmen für diese VBD Schreibgeschützte Parameter
io_read_kbs Durchschnittliche Leserate in kB pro Sekunde für diese VBD Schreibgeschützt
io_write_kbs Durchschnittliche Schreibrate in kB pro Sekunde für diese VBD Schreibgeschützt
allowed-operations Liste der in diesem Zustand zulässigen Vorgänge. Diese Liste ist nur beratend, und der Serverstatus hat sich möglicherweise geändert, wenn dieses Feld von einem Client gelesen wird. Schreibgeschützte Parameter
current-operations Verknüpft jede der ausgeführten Tasks, die dieses Objekt verwenden (per Verweis), mit einer current_operation-Enumeration, die die Art der Aufgabe beschreibt. Schreibgeschützte Parameter
unpluggable True, wenn diese VBD Hot Unplug unterstützt Lese-/Schreibzugriff
attachable True, wenn das Gerät angeschlossen werden kann Schreibgeschützt
other-config Zusätzliche Konfiguration Kartenparameter mit Lese-/Schreibzugriff

vbd-create

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]

Erstellen Sie eine VBD auf einer VM.

Die zulässigen Werte für dasdevice Feld sind ganze Zahlen 0—15, und die Zahl muss für jede VM eindeutig sein. Die aktuell zulässigen Werte können imallowed-VBD-devices Parameter auf der angegebenen VM angezeigt werden. Dies wird wieuserdevice in denvbd Parametern gesehen.

Wenn dertype istDisk ,vdi-uuid ist erforderlich. Der Modus kannRO oderRW für einen Datenträger sein.

Wenn dertype istCD ,vdi-uuid ist optional. Wenn kein VDI angegeben wird, wird eine leere VBD für die CD erstellt. Der Modus mussRO für eine CD sein.

vbd-destroy

vbd-destroy uuid=uuid_of_vbd

Zerstören Sie die angegebene VBD.

Wenn derother-config:owner Parameter für die VBD auf gesetzt isttrue , wird auch der zugehörige VDI zerstört.

vbd-eject

vbd-eject uuid=uuid_of_vbd

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

vbd-insert

vbd-insert uuid=uuid_of_vbd vdi-uuid=uuid_of_vdi_containing_media

Legen Sie neue Medien in das Laufwerk ein, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn das Medium einen Wechseldatentyp hat (eine physische CD oder ein ISO). Andernfalls VBD_NOT_REMOVABLE_MEDIA wird eine Fehlermeldung zurückgegeben.

vbd-plug

vbd-plug uuid=uuid_of_vbd

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

vbd-unplug

vbd-unplug uuid=uuid_of_vbd

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

VDI-Befehle

Befehle zum Arbeiten mit VDIs (Virtual Disk Images).

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

Die VDI-Objekte können mit dem Standard-Objektlistenbefehl (xe vdi-list) aufgelistet werden und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

VDI-Parameter

VDIs haben die folgenden Parameter:

Parametername Beschreibung Typ
uuid Die eindeutige Bezeichner/Objektreferenz für den VDI Schreibgeschützt
name-label Der Name des VDI Lese-/Schreibzugriff
name-description Die Beschreibungszeichenfolge des VDI Lese-/Schreibzugriff
allowed-operations Eine Liste der in diesem Zustand zulässigen Vorgänge Schreibgeschützte Parameter
current-operations Eine Liste der Vorgänge, die derzeit auf diesem VDI ausgeführt werden Schreibgeschützte Parameter
sr-uuid SR, in dem sich der VDI befindet Schreibgeschützt
vbd-uuids Eine Liste der VBDs, die sich auf diesen VDI beziehen Schreibgeschützte Parameter
crashdump-uuids Liste der Absturzabbilder, die auf diesen VDI verweisen Schreibgeschützte Parameter
virtual-size Größe der Festplatte, wie der VM dargestellt, in Bytes. Je nach Speicher-Backend-Typ kann die Größe nicht exakt eingehalten werden Schreibgeschützt
physical-utilisation Menge des physischen Speicherplatzes, den der VDI auf der SR belegt, in Byte Schreibgeschützt
type Typ des VDI, z. B. System oder Benutzer Schreibgeschützt
sharable True, wenn dieser VDI freigegeben werden kann Schreibgeschützt
read-only True, wenn dieser VDI nur schreibgeschützt bereitgestellt werden kann Schreibgeschützt
storage-lock True, wenn dieser VDI auf Speicherebene gesperrt ist Schreibgeschützt
parent Verweist auf den übergeordneten VDI, wenn dieser VDI Teil einer Kette ist Schreibgeschützt
missing True, wenn der SR-Scanvorgang diesen VDI als nicht vorhanden gemeldet hat Schreibgeschützt
other-config Zusätzliche Konfigurationsinformationen für diesen VDI Kartenparameter mit Lese-/Schreibzugriff
sr-name-label Name des enthaltenden Speicher-Repositorys Schreibgeschützt
location Standortinformationen Schreibgeschützt
managed True, wenn der VDI verwaltet wird Schreibgeschützt
xenstore-data Daten, die in den xenstore-Baum (/local/domain/0/backend/vbd/domid/device-id/smdata) eingefügt werden sollen, nachdem der VDI angehängt wurde. Die SM-Back-Ends setzen dieses Feld normalerweise aufvdi_attach. Schreibgeschützte Kartenparameter
sm-config SM-abhängige Daten Schreibgeschützte Kartenparameter
is-a-snapshot True, wenn es sich bei diesem VDI um einen VM-Speicher-Snapshot handelt Schreibgeschützt
snapshot_of Die UUID des Speichers dieses VDI ist ein Snapshot von Schreibgeschützt
snapshots Die UUIDs aller Snapshots dieses VDI Schreibgeschützt
snapshot_time Der Zeitstempel des Snapshot-Vorgangs, der diesen VDI erstellt hat Schreibgeschützt
metadata-of-pool Die uuid des Pools, der diese Metadaten-VDI erstellt hat Schreibgeschützt
metadata-latest Flag, das angibt, ob der VDI die neuesten bekannten Metadaten für diesen Pool enthält Schreibgeschützt
cbt-enabled Flag, das angibt, ob die geänderte Blockverfolgung für den VDI aktiviert ist Lese-/Schreibzugriff

vdi-clone

vdi-clone uuid=uuid_of_the_vdi [driver-params:key=value]

Erstellen Sie eine neue, beschreibbare Kopie des angegebenen VDI, die direkt verwendet werden kann. Es ist eine Variantevdi-copy , die High-Speed-Image-Klon-Einrichtungen verfügbar machen kann, wo sie existieren.

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

vdi-copy

vdi-copy uuid=uuid_of_the_vdi sr-uuid=uuid_of_the_destination_sr

Kopieren Sie einen VDI in eine angegebene SR.

vdi-create

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

Erstellen Sie einen VDI.

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

Hinweis:

SR-Typen, die Thin Provisioning von Festplatten unterstützen (z. B. lokale VHD und NFS), erzwingen keine virtuelle Zuweisung von Festplatten. Achten Sie bei der übermäßigen Zuweisung von virtuellem Festplattenspeicher auf einem SR auf große Sorgfalt. Wenn ein überlasteter SR voll wird, muss der Speicherplatz entweder auf dem SR-Zielsubstrat oder durch Löschen nicht verwendeter VDIs in der SR zur Verfügung gestellt werden.

Einige SR-Typen können denvirtual-size Wert aufrunden, um ihn durch eine konfigurierte Blockgröße teilbar zu machen.

vdi-data-destroy

vdi-data-destroy uuid=uuid_of_vdi

Löschen Sie die Daten, die mit dem angegebenen VDI verknüpft sind, behalten Sie jedoch die geänderten Block-Tracking-Metadaten bei.

Hinweis:

Wenn Sie die geänderte Blockverfolgung verwenden, um inkrementelle Sicherungen des VDI zu erstellen, stellen Sie sicher, dass Sie denvdi-data-destroy Befehl verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie diese Option vdi-destroy nicht für Snapshots von VDIs, bei denen die Blockverfolgung aktiviert wurde.

vdi-destroy

vdi-destroy uuid=uuid_of_vdi

Zerstören Sie den angegebenen VDI.

Hinweis:

Wenn Sie die geänderte Blockverfolgung verwenden, um inkrementelle Sicherungen des VDI zu erstellen, stellen Sie sicher, dass Sie denvdi-data-destroy Befehl verwenden, um Snapshots zu löschen, aber die Metadaten beizubehalten. Verwenden Sie diese Optionvdi-destroy nicht für Snapshots von VDIs, bei denen die Blockverfolgung aktiviert wurde.

Bei lokalen VHD- und NFS-SR-Typen wird Speicherplatz nicht sofort freigegebenvdi-destroy, sondern regelmäßig während eines Speicher-Repository-Scanvorgangs. Wenn Sie die Bereitstellung gelöschter Speicherplatz erzwingen müssen, rufen Sie [sr-scan] (#sr -scan) manuell auf.

vdi-disable-cbt

vdi-disable-cbt uuid=uuid_of_vdi

Deaktivieren Sie die geänderte Blockverfolgung für den VDI.

vdi-enable-cbt

vdi-enable-cbt uuid=uuid_of_vdi

Aktivieren Sie die geänderte Blockverfolgung für den VDI.

Hinweis:

Sie können die geänderte Blockverfolgung nur auf lizenzierten Instanzen von Citrix Hypervisor Premium Edition aktivieren.

vdi-export

vdi-export uuid=uuid_of_vdi filename=filename_to_export_to [format=format] [base=uuid_of_base_vdi] [--progress]

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

  • raw
  • vhd

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

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

vdi-forget

vdi-forget uuid=uuid_of_vdi

Entfernt bedingungslos einen VDI-Eintrag aus der Datenbank, ohne das Speicher-Back-End zu berühren. Im normalen Betrieb sollten Sie stattdessen [vdi-destroy] (#vdi -destroy) verwenden.

vdi-import

vdi-import uuid=uuid_of_vdi filename=filename_to_import_from [format=format] [--progress]

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

  • raw
  • vhd

vdi-introduce

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]

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

vdi-list-changed-blocks

vdi-list-changed-blocks vdi-from-uuid=first-vdi-uuid vdi-to-uuid=second-vdi-uuid

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

Weitere Informationen finden Sie unter Blockverfolgung geändert.

vdi-pool-migrate

vdi-pool-migrate uuid=VDI_uuid sr-uuid=destination-sr-uuid

Migrieren Sie einen VDI zu einer bestimmten SR, während der VDI an einen laufenden Gast angeschlossen ist. (Massenspeicher-Live-Migration)

Weitere Informationen finden Sie unter Migrieren von VMs.

vdi-resize

vdi-resize uuid=vdi_uuid disk-size=new_size_for_disk

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

vdi-snapshot

vdi-snapshot uuid=uuid_of_the_vdi [driver-params=params]

Erzeugt eine Lese-/Schreibversion eines VDIs, die als Referenz für Backup- oder Vorlagenerstellungszwecke oder beides verwendet werden kann. Verwenden Sie den Snapshot, um eine Sicherung durchzuführen, anstatt Backup-Software innerhalb der VM zu installieren und auszuführen. Die VM wird weiterhin ausgeführt, während externe Sicherungssoftware den Inhalt des Snapshots auf das Sicherungsmedium streamt. Ebenso kann ein Snapshot als „Goldbild“ verwendet werden, auf dem eine Vorlage basiert. Eine Vorlage kann mit beliebigen VDIs erstellt werden.

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

Ein Klon eines Snapshots sollte immer einen beschreibbaren VDI erzeugen.

vdi-unlock

vdi-unlock uuid=uuid_of_vdi_to_unlock [force=true]

Versucht, die angegebenen VDIs zu entsperren. Wenn an den Befehl übergebenforce=true wird, erzwingt es die Entsperrung.

vdi-update

vdi-update uuid=uuid

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 Befehl zur Standardobjektauflistung (xe vif-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

VIF-Parameter

VIFs haben die folgenden Parameter:

  • uuid ( schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die VIF
  • vm-uuid ( schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die VM, auf der sich diese VIF befindet
  • vm-name-label ( schreibgeschützt) der Name der VM, auf der sich diese VIF befindet
  • allowed-operations ( schreibgeschützter Parameter) eine Liste der in diesem Zustand zulässigen Operationen
  • current-operations ( schreibgeschützter Parameter) eine Liste der Vorgänge, die derzeit auf diesem VIF ausgeführt werden
  • device ( schreibgeschützte) Ganzzahlbeschriftung dieses VIF, die die Reihenfolge angibt, in der VIF-Back-Ends erstellt wurden
  • MAC ( schreibgeschützte) MAC-Adresse von VIF, wie sie der VM zugänglich gemacht wird
  • MTU ( schreibgeschützt) Maximale Übertragungseinheit des VIF in Byte.

    Dieser Parameter ist schreibgeschützt, aber Sie können die MTU-Einstellung mit demmtu Schlüssel mit dem Parameterother-config map überschreiben. 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
    
  • currently-attached ( schreibgeschützt) true, wenn das Gerät angeschlossen ist
  • qos_algorithm_type ( Lese-/Schreib-) QoS-Algorithmus zu verwenden
  • qos_algorithm_params ( Lese-/Schreibzugriffsparameter) für den gewählten QoS-Algorithmus
  • qos_supported_algorithms ( read only set parameter) unterstützte QoS-Algorithmen für diese VIF
  • MAC-autogenerated ( schreibgeschützt) True, wenn die MAC-Adresse des VIF automatisch generiert wurde
  • other-config ( Lese-/Schreibzuordnungsparameter) zusätzlichekey:value Konfigurationspaare
  • other-config:ethtoolrx ( Lese-/Schreibzugriff) auf ein gesetzt, um Empfangsprüfsumme zu aktivieren, aus, um zu deaktivieren
  • other-config:ethtooltx ( Lese-/Schreibzugriff) auf ein gesetzt, um die Prüfsumme der Übertragung zu aktivieren, aus, um zu deaktivieren
  • other-config:ethtoolsg ( Lese-/Schreibzugriff) auf ein gesetzt, um Scatter sammeln zu aktivieren, aus, um zu deaktivieren
  • other-config:ethtooltso ( Lese-/Schreibzugriff) auf ein gesetzt, um TCP-Segmentierungsabladung zu aktivieren, aus, um zu deaktivieren
  • other-config:ethtoolufo ( Lese-/Schreibzugriff) auf ein gesetzt, um die udp-Fragmentabladung zu aktivieren, aus, um zu deaktivieren
  • other-config:ethtoolgso ( Lese-/Schreibzugriff) auf ein gesetzt, um generische Segmentierungsabladung zu aktivieren, aus, um zu deaktivieren
  • other-config:promiscuous ( read/write) true auf ein VIF, um auf der Brücke promiscuous zu sein, so dass es den gesamten Verkehr über die Brücke sieht. Nützlich, um ein Intrusion Detection System (IDS) oder ähnliches in einer VM auszuführen.
  • network-uuid ( schreibgeschützt) die eindeutige Bezeichner/Objektreferenz des virtuellen Netzwerks, mit dem diese VIF verbunden 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 diese VIF
  • io_write_kbs ( schreibgeschützt) durchschnittliche Schreibrate in KB/s für diese VIF
  • locking_mode ( Lese-/Schreibzugriff) Beeinflusst die VIFs Fähigkeit, Datenverkehr zu/aus einer Liste von MAC- und IP-Adressen zu filtern. Benötigt zusätzliche Parameter.
  • locking_mode:default ( Lese-/Schreibzugriff) variiert je nach Standardsperrmodus für das VIF-Netzwerk.

    Wenn der Standardsperrmodus auf festgelegt istdisabled, wendet Citrix Hypervisor eine Filterregel an, sodass die VIF keinen Datenverkehr senden oder empfangen kann. Wenn der Standardsperrmodus auf eingestellt istunlocked, entfernt Citrix Hypervisor alle Filterregeln, die dem VIF zugeordnet sind. Weitere Informationen finden Sie unter Netzwerkbefehle.

  • locking_mode:locked ( Lese-/Schreibzugriff) Auf der VIF ist nur Datenverkehr zulässig, der an die angegebene MAC- und IP-Adressen gesendet wird. Wenn keine IP-Adressen angegeben werden, ist kein Datenverkehr zulässig.
  • locking_mode:unlocked ( Lese-/Schreibzugriff) Es werden keine Filter auf Datenverkehr angewendet, der zum VIF oder aus dem VIF geht.
  • locking_mode:disabled ( Lese-/Schreibzugriff) Citrix Hypervisor wendet eine Filterregel an, sodass die VIF den gesamten Datenverkehr löscht.

vif-create

vif-create vm-uuid=uuid_of_the_vm device=see below network-uuid=uuid_of_network_to_connect_to [mac=mac_address]

Erstellen eines VIF auf einer VM.

Die entsprechenden Werte für dasdevice Feld sind im Parameterallowed-VIF-devices auf der angegebenen VM aufgeführt. Bevor dort VIFs vorhanden sind, sind die zulässigen Werte ganze Zahlen von 0-15.

Dermac Parameter ist die Standard-MAC-Adresse im Formularaa:bb:cc:dd:ee:ff . Wenn Sie es nicht angegeben lassen, wird eine entsprechende zufällige MAC-Adresse erstellt. Sie können auch explizit eine zufällige MAC-Adresse festlegen, indem Sie angebenmac=random.

vif-destroy

vif-destroy uuid=uuid_of_vif

Zerstöre ein VIF.

vif-move

vif-move uuid=uuid network-uuid=network_uuid

Verschieben Sie die VIF in ein anderes Netzwerk.

vif-plug

vif-plug uuid=uuid_of_vif

Versuchen Sie, die VIF anzuhängen, während sich die VM im ausgeführten Zustand befindet.

vif-unplug

vif-unplug uuid=uuid_of_vif

Versucht, die VIF von der VM zu trennen, während sie ausgeführt wird.

vif-configure-ipv4

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

vif-configure-ipv4 uuid=uuid_of_vif mode=static address=CIDR_address gateway=gateway_address

Zum Beispiel:

VIF.configure_ipv4(vifObject,"static", " 192.168.1.10/24", " 192.168.1.1")

Säubern Sie die IPv4-Einstellungen wie folgt:

vif-configure-ipv4 uuid=uuid_of_vif mode=none

vif-configure-ipv6

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

vif-configure-ipv6 uuid=uuid_of_vif mode=static address=IP_address gateway=gateway_address

Zum Beispiel:

VIF.configure_ipv6(vifObject,"static", "fd06:7768:b9e5:8b00::5001/64", "fd06:7768:b9e5:8b00::1")

Säubern Sie IPv6-Einstellungen wie folgt:

vif-configure-ipv6 uuid=uuid_of_vif mode=none

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 zugeordnetes virtuelles Netzwerk verfügen. Weitere Informationen finden Sie unter PIF-Befehle. Verwenden Sie zum Beispiel, um VLANs aufzulistenxe pif-list.

vlan-create

vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network

Erstellen Sie ein VLAN auf dem Citrix Hypervisor or-Server.

pool-vlan-create

pool-vlan-create pif-uuid=uuid_of_pif vlan=vlan_number network-uuid=uuid_of_network

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

vlan-destroy

vlan-destroy uuid=uuid_of_pif_mapped_to_vlan

Zerstören Sie ein VLAN. Erfordert die UUID der PIF, die das VLAN darstellt.

VM-Befehle

Befehle zum Steuern von VMs und deren Attributen.

VM-Selektoren

Mehrere der hier aufgeführten Befehle verfügen über einen gemeinsamen Mechanismus zum Auswählen einer oder mehrerer VMs, auf denen der Vorgang ausgeführt werden soll. Der einfachste Weg ist die Bereitstellung des Argumentsvm=name_or_uuid. Eine einfache Möglichkeit, die UUID einer tatsächlichen VM zu erhalten, besteht beispielsweise darin, ausgeführt zu werdenxe vm-list power-state=running. ( Ruft die vollständige Liste der Felder ab, die mit dem Befehl abgeglichen werden könnenxe vm-list params=all.) Wenn Sie beispielsweise festlegen, werden VMspower-state=haltedausgewählt, derenpower-stateParameter gleich halted. 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 Befehl zur Standardobjektauflistung (xe vm-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

VM-Parameter

VMs verfügen über die folgenden Parameter:

Hinweis:

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

  • appliance ( Lese-/Schreibzugriff) die Appliance/vApp, zu der die VM gehört
  • uuid ( schreibgeschützt) die eindeutige Bezeichner/Objektreferenz für die VM
  • name-label ( Lese-/Schreibzugriff) der Name der VM
  • name-description ( Lese-/Schreibzugriff) der Beschreibungszeichenfolge der VM
  • order start order ( Lese-/Schreibzugriff) für vApp-Start/Herunterfahren und für den Start nach HA-Failover
  • version ( schreibgeschützt), wie oft diese VM wiederhergestellt wurde. Wenn Sie eine neue VM mit einer älteren Version überschreiben möchten, rufen Sievm-recover
  • user-version ( Lese-/Schreibzeichenfolge) für Ersteller von VMs und Vorlagen, um Versionsinformationen zu setzen
  • is-a-template ( Lese-/Schreibzugriff) False, es sei denn, diese VM ist eine Vorlage. 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 VMs konvertiert werden.
  • is-control-domain ( schreibgeschützt) True, wenn dies eine Steuerdomäne ist (Domäne 0 oder eine Treiberdomäne)
  • power-state ( schreibgeschützt) Stromzustand
  • start-delay ( Lese-/Schreibzugriff) die Verzögerung zu warten, bevor ein Aufruf zum Starten der VM zurückgibt
  • shutdown-delay ( Lese-/Schreibzugriff) die Verzögerung zu warten, bevor ein Aufruf zum Herunterfahren der VM zurückgibt
  • memory-dynamic-max ( Lese-/Schreibzugriff) dynamisches Maximum in Bytes
  • memory-dynamic-min ( Lese-/Schreibzugriff) dynamisches Minimum in Bytes
  • memory-static-max ( Lese-/Schreibzugriff) statisch (absolutes) Maximum in Bytes festgelegt. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
  • memory-static-min ( Lese-/Schreibzugriff) statisch festgelegtes (absolutes) Minimum in Bytes. 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
  • -Konfigurationsparameter VCPUs-params (Lese-/Schreibzuordnungsparameter) für die ausgewählte vCPU-Richtlinie.

    Sie können das Anheften einer vCPU mit

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

    Die ausgewählte VM wird dann nur auf physischen CPUs 1, 2 und 3 ausgeführt. Sie können auch die vCPU-Priorität (xen-Scheduling) mit den Parametern cap und weight optimieren. Zum Beispiel:

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

    Eine VM mit einem Gewicht von 512 erhalten doppelt so viel CPU wie eine Domäne mit einem Gewicht von 256 auf einem angekommenCitrix Hypervisor or-Server. Die zulässigen Gewichtungen liegen zwischen 1 und 65535 und der Standardwert ist 256. Die Kappe behebt optional die maximale CPU-Menge, die eine VM belegen kann, selbst wenn der Citrix Hypervisor or-Server über Leerlauf-CPU-Zyklen verfügt. Die Obergrenze wird in Prozent einer physischen CPU ausgedrückt: 100 ist 1 physische CPU, 50 ist eine halbe CPU, 400 ist 4 CPUs usw. Der Standardwert 0 bedeutet, dass keine obere Obergrenze vorhanden ist.

  • VCPUs-max ( Lese-/Schreibzugriff) maximale Anzahl virtueller CPUs.
  • VCPUs-at-startup ( Lese-/Schreibzugriff) Startnummer virtueller CPUs
  • actions-after-crash ( Lese-/Schreibvorgang), die ausgeführt werden soll, wenn die VM abstürzt. Für PV-Gäste gelten folgende Parameter:
    • preserve ( nur zur Analyse)
    • coredump_and_restart ( Record a coredump und VM neu starten)
    • coredump_and_destroy ( Notieren Sie einen Coredump und lassen Sie VM angehalten)
    • restart ( kein Coredump und Neustart der VM)
    • destroy ( kein Coredump und VM angehalten lassen)
  • console-uuids ( schreibgeschützte Parameter) virtuelle Konsolengeräte
  • platform ( Lese-/Schreibzuordnungsparameter) plattformspezifische Konfiguration

    So deaktivieren Sie Virtual Desktop Agent (VDA), um Windows 10 in den Tablet-Modus zu wechseln:

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

    So aktivieren Sie VDA, um Windows 10 in den Tablet-Modus zu wechseln:

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

    So überprüfen Sie den aktuellen Status:

     xe vm-param-get uuid=<vm_uuid> param-name=platform param-key=acpi_laptop_slate
    
  • Liste der in diesem Zustand zulässigen Operationen allowed-operations (read only set parameter)
  • current-operations ( schreibgeschützter Parameter) eine Liste der Vorgänge, die derzeit auf der VM ausgeführt werden
  • allowed-VBD-devices ( read only set parameter) Liste der verfügbaren VBD-Bezeichner, die durch ganze Zahlen im Bereich 0—15 dargestellt werden. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (aber möglicherweise nicht funktionieren).
  • allowed-VIF-devices ( read only set parameter) Liste der zur Verwendung verfügbaren VIF-Bezeichner, dargestellt durch ganze Zahlen im Bereich 0—15. Diese Liste ist nur informativ, und andere Geräte können verwendet werden (aber möglicherweise nicht funktionieren).
  • HVM-boot-policy ( Lese-/Schreibzugriff) die Boot-Richtlinie für HVM-Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge.
  • HVM-boot-params ( Lese-/Schreibzuordnungsparameter) steuert der Orderschlüssel die HVM-Gaststartreihenfolge, die als Zeichenfolge dargestellt wird, wobei jedes Zeichen eine Boot-Methode ist: d für die CD/DVD, c für die Root-Diskette und n für den Netzwerk-PXE-Start. Der Standardwert ist dc.
  • HVM-shadow-multiplier ( Lese-/Schreibzugriff) Gleitkommawert, der den Umfang des Schattenspeicher-Overhead steuert, um der VM zu gewähren. Der Standardwert ist 1.0 (der Mindestwert), und nur fortgeschrittene Benutzer sollten diesen Wert ändern.
  • PV-kernel ( Lese-/Schreibzugriff) Pfad zum Kernel
  • PV-ramdisk ( Lese-/Schreibzugriff) Pfad zum initrd
  • PV-args ( Lese-/Schreibzeichenfolge) von Kernel-Befehlszeilenargumenten
  • PV-legacy-args ( Lese-/Schreibzeichenfolge), um ältere VMs zu starten
  • PV-bootloader ( Lese-/Schreibzugriff) Name oder Pfad zum Bootloader
  • PV-bootloader-args ( Lese-/Schreib-) Zeichenfolge mit verschiedenen Argumenten für den Bootloader
  • last-boot-CPU-flags ( schreibgeschützt) beschreibt die CPU-Flags, auf denen die VM zuletzt gestartet wurde
  • resident-on ( schreibgeschützt) der Citrix Hypervisor or-Server, auf dem sich eine VM befindet
  • affinity ( Lese-/Schreibzugriff) Der Citrix Hypervisor or-Server, auf dem die VM bevorzugt ausgeführt werden soll. Wird vom xe vm-start Befehl verwendet, um zu entscheiden, wo die VM ausgeführt werden soll.
  • other-config ( Kartenparameter mit Lese-/Schreibzugriff) Eine Liste von Schlüssel/Wert-Paaren, die zusätzliche Konfigurationsparameter für die VM angeben. Zum Beispiel wird eine VM automatisch nach dem Host-Boot gestartet, wenn derother-config Parameter das Schlüssel/Wert-Paarauto_poweron: true enthält
  • start-time ( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu dem die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat die Form yyyymmddThh:mm:ss z, wobei z der einzelne Buchstabe militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT)
  • install-time ( schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu dem die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat die Form yyyymmddThh:mm:ss z, wobei z der einzelne Buchstabe 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 PV (paravirtual) oder HVM (Hardware Virtual Machine) Linux-VM zugewiesen sind. Diese Nummer kann sich von unterscheidenVCPUS-max und kann geändert werden, ohne die VM mit demvm-vcpu-hotplug Befehl neu zu starten. Weitere Informationen finden Sie unter [vm-vcpu-hotplug] (#vm -vcpu-hotplug). Windows VMs werden immer mit der Anzahl der vCPUs ausgeführt VCPUsmax und müssen neu gestartet werden, um diesen Wert zu ändern. Die Leistung sinkt stark, wenn Sie einen Wert festlegenVCPUs-number , der größer ist als die Anzahl der physischen CPUs auf dem Citrix Hypervisor or-Server.
  • VCPUs-Utilization ( Read Only Map-Parameter) eine Liste der virtuellen CPUs und deren Gewicht
  • os-version ( schreibgeschützte Zuordnungsparameter) die Version des Betriebssystems für die VM
  • PV-drivers-version ( schreibgeschützte Zuordnungsparameter) die Versionen der paravirtualisierten Treiber für die VM
  • PV-drivers-detected ( schreibgeschützt) für die neueste Version der paravirtualisierten Treiber für die VM
  • memory ( schreibgeschützte Zuordnungsparameter) Memory-Metriken, die vom Agent auf der VM gemeldet werden
  • disks ( schreibgeschützte Zuordnungsparameter) Datenträgermetriken, die vom Agent auf der VM gemeldet werden
  • networks ( schreibgeschützte Zuordnungsparameter) Netzwerkmetriken, die vom Agent auf der VM gemeldet werden
  • other ( schreibgeschützte Zuordnungsparameter) andere Metriken, die vom Agent auf der VM gemeldet werden
  • guest-metrics-lastupdated ( schreibgeschützt) Zeitstempel, wenn der In-Gast-Agent das letzte Schreiben in diese Felder durchgeführt hat. Der Zeitstempel ist in der FormyyyymmddThh:mm:ss z, wobei z der einzelne Buchstabe militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT)
  • actions-after-shutdown ( Lese-/Schreibvorgang) -Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
  • actions-after-reboot ( Lese-/Schreibvorgang) -Aktion, die nach dem Neustart der VM ausgeführt werden soll
  • possible-hosts potenzielle Hosts dieser VM schreibgeschützt
  • dom-id ( schreibgeschützt) Domain-ID (falls verfügbar, andernfalls -1)
  • recommendations ( schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
  • xenstore-data ( Lese-/Schreibzuordnungsparameter) Daten, die in den xenstore-Baum (/local/domain/domid /vm-data) eingefügt werden, nachdem die VM erstellt wurde
  • is-a-snapshot ( schreibgeschützt) True, wenn diese VM ein Snapshot ist
  • snapshot_of ( schreibgeschützt) die UUID der VM, von der dieser Snapshot ist
  • 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 Zielmenge des Arbeitsspeichers für diese VM
  • blocked-operations ( Lese-/Schreibzuordnungsparameter) listet die Vorgänge auf, die auf dieser VM nicht ausgeführt werden können
  • last-boot-record ( schreibgeschützt) Datensatz der letzten Boot-Parameter für diese Vorlage im XML-Format
  • ha-always-run ( Lese-/Schreibzugriff) True, wenn diese VM immer auf einem anderen Host neu gestartet wird, wenn ein Ausfall des Hosts vorliegt, auf dem er sich befindet. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den ha-restart-priority Parameter.
  • ha-restart-priority ( Lese-/Schreibzugriff) Neustart oder best-effort
  • blobs ( schreibgeschützter) binärer Datenspeicher
  • live ( schreibgeschützt) True, wenn die VM ausgeführt wird. False, wenn HA den Verdacht hat, dass die VM nicht ausgeführt wird.

vm-assert-can-be-recovered

vm-assert-can-be-recovered uuid [database] vdi-uuid

Prüft, ob Speicher verfügbar ist, um diese VM wiederherzustellen.

vm-call-plugin

vm-call-plugin vm-uuid=vm_uuid plugin=plugin fn=function [args:key=value]

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

vm-cd-add

vm-cd-add cd-name=name_of_new_cd device=integer_value_of_an_available_vbd [vm-selector=vm_selector_value...]

Fügen Sie der ausgewählten VM eine neue virtuelle CD hinzu. Derdevice Parameter sollte aus dem Wert desallowed-VBD-devices Parameters der VM ausgewählt werden.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-cd-eject

vm-cd-eject [vm-selector=vm_selector_value...]

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 Befehlxe vbd-eject und geben Sie die UUID der VBD an.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-cd-insert

vm-cd-insert cd-name=name_of_cd [vm-selector=vm_selector_value...]

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 denxe vbd-insert Befehl 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 mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts VM-Parameter aufgeführten sein.

vm-cd-list

vm-cd-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]

Listet CDs auf, die mit den angegebenen VMs verbunden sind.

Die VM oder 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 VM-Parameter aufgeführten sein.

Sie können auch auswählen, welche VBD- und VDI-Parameter aufgelistet werden sollen.

vm-cd-remove

vm-cd-remove cd-name=name_of_cd [vm-selector=vm_selector_value...]

Entfernen Sie eine virtuelle CD von den angegebenen VMs.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-checkpoint

vm-checkpoint new-name-label=name_label [new-name-description=description]

Überprüfen Sie eine vorhandene VM und verwenden Sie den schnellen Festplatten-Snapshot-Vorgang auf Speicherebene, sofern verfügbar.

vm-clone

vm-clone new-name-label=name_for_clone [new-name-description=description_for_clone] [vm-selector=vm_selector_value...]

Klonen Sie eine vorhandene VM mit dem schnellen Festplattenklonvorgang auf Speicherebene, sofern verfügbar. Geben Sie den Namen und die optionale Beschreibung für die resultierende geklonte VM mit dennew-name-label Argumentennew-name-description und an.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-compute-maximum-memory

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...]

Berechnen Sie die maximale Menge an statischem Speicher, die einer vorhandenen VM zugewiesen werden kann, wobei die Gesamtmenge des physischen Arbeitsspeichers als Obergrenze verwendet wird. Der optionale Parameterapproximate reserviert genügend zusätzlichen Speicher in der Berechnung, um später zusätzliche vCPUs in die VM hinzuzufügen.

Zum Beispiel:

xe vm-compute-maximum-memory vm=testvm total=`xe host-list params=memory-free --minimal`

Dieser Befehl verwendet den Wert des vommemory-free Befehl zurückgegebenenxe host-list Parameters, um den maximalen Speicher der VM mit dem Namen festzulegentestvm .

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-compute-memory-overhead

vm-compute-memory-overhead

Berechnet den Virtualisierungsspeicher-Overhead einer VM.

vm-copy

vm-copy new-name-label=name_for_copy [new-name-description=description_for_copy] [sr-uuid=uuid_of_sr] [vm-selector=vm_selector_value...]

Kopieren Sie eine vorhandene VM, ohne den schnellen Festplattenklonvorgang auf Speicherebene zu verwenden (auch wenn diese Option verfügbar ist). Die Disk-Images der kopierten VM sind garantiert vollständige Images, d. h. nicht Teil einer Copy-on-Write-Kette (CoW).

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

Geben Sie die Ziel-SR für die resultierende kopierte VM mit der ansr-uuid. Wenn dieser Parameter nicht angegeben wird, ist das Ziel dieselbe SR, in der sich die ursprüngliche VM befindet.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-copy-bios-strings

vm-copy-bios-strings host-uuid=host_uuid

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

vm-crashdump-list

vm-crashdump-list [vm-selector=vm selector value...]

Listen Sie Crashdumps auf, die den angegebenen VMs zugeordnet sind.

Wenn Sie das optionale Argument verwendenparams, 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. Wennparams 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 mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts VM-Parameter aufgeführten sein.

vm-data-source-list

vm-data-source-list [vm-selector=vm selector value...]

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

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

Datenquellen haben zwei Parameter —standard undenabled —, die Sie in der Ausgabe dieses Befehls sehen können. Wenn eine Datenquelle auf enabled festgelegt ist true, werden die Metriken derzeit in der Performance-Datenbank aufgezeichnet. Wenn eine Datenquelle aufstandard festgelegt isttrue , werden die Metriken standardmäßig in der Performance-Datenbank aufgezeichnet (undenabled ist auchtrue auf diese Datenquelle). Wenn eine Datenquelle aufstandard festgelegt istfalse , werden die Metriken *nicht* standardmäßig in der Performance-Datenbank aufgezeichnet (undenabled ist auch auf falsefür diese Datenquelle).

Führen Sie den vm-data-source-record Befehl aus, um Datenquellen-Metriken in der Performance-Datenbank aufzuzeichnen. Dieser Befehl wird enabled auf festgelegt true. Um zu stoppen, führen Sie den aus vm-data-source-forget. Dieser Befehl wird enabled auf festgelegt false.

vm-data-source-record

vm-data-source-record data-source=name_description_of_data-source [vm-selector=vm selector value...]

Zeichnen Sie die angegebene Datenquelle für eine VM auf.

Dieser Vorgang schreibt die Informationen aus der Datenquelle in die Datenbank für persistente Performance-Metriken der angegebenen VMs. Aus Performance-Gründen unterscheidet sich diese Datenbank von der normalen Agent-Datenbank.

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

vm-data-source-forget

vm-data-source-forget data-source=name_description_of_data-source [vm-selector=vm selector value...]

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

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

vm-data-source-query

vm-data-source-query data-source=name_description_of_data-source [vm-selector=vm_selector_value...]

Zeigt die angegebene Datenquelle für eine VM an.

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

vm-destroy

vm-destroy uuid=uuid_of_vm

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

vm-disk-add

vm-disk-add disk-size=size_of_disk_to_add device=uuid_of_device [vm-selector=vm_selector_value...]

Fügen Sie einen Datenträger zu den angegebenen VMs hinzu. Select dendevice Parameter aus dem Wert desallowed-VBD-devices Parameters der VMs.

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

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-disk-list

vm-disk-list [vbd-params] [vdi-params] [vm-selector=vm_selector_value...]

Listet Datenträger auf, die mit den angegebenen VMs verbunden sind. Dievbd-params Parametervdi-params und steuern die Felder der jeweiligen Objekte, die ausgegeben werden sollen. Geben Sie die Parameter als kommagetrennte Liste oder den speziellen Schlüsselall für die vollständige Liste an.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-disk-remove

vm-disk-remove device=integer_label_of_disk [vm-selector=vm_selector_value...]

Entfernen Sie einen Datenträger von den angegebenen VMs und zerstören Sie ihn.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-export

vm-export filename=export_filename [metadata=true|false] [vm-selector=vm_selector_value...]

Exportieren Sie die angegebenen VMs (einschließlich Disk-Images) in eine Datei auf dem lokalen Computer. Geben Sie mithilfe desfilename Parameters den Dateinamen an, in den die VM exportiert werden soll. Nach der Konvention sollte der Dateiname eine.xva Erweiterung haben.

Wenn dermetadata Parameter lautettrue , 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 die VM-Informationen neu erstellt werden können. Weitere Informationen finden Sie unter vm-Import.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-import

vm-import filename=export_filename [metadata=true|false] [preserve=true|false][sr-uuid=destination_sr_uuid]

Importieren Sie eine VM aus einer zuvor exportierten Datei. Wenn auf festgelegtpreserve isttrue , bleibt die MAC-Adresse der ursprünglichen VM erhalten. Dersr-uuid bestimmt die Ziel-SR, in die die VM importiert werden soll. Wenn dieser Parameter nicht angegeben wird, wird der Standard-SR verwendet.

Derfilename Parameter kann auch auf eine VM im XVA-Format verweisen, bei der es sich um das Legacy-Exportformat von Citrix Hypervisor 3.2 handelt. Dieses Format wird von einigen Drittanbietern verwendet, um virtuelle Appliances bereitzustellen. Das XVA-Format verwendet ein Verzeichnis, um die VM-Datenfilename zu speichern. Legen Sie daher auf das Stammverzeichnis des XVA-Exports und nicht auf eine eigentliche Datei. Nachfolgende Exporte des importierten Legacy-Gastes werden automatisch auf das neue Dateiname-basierte Format aktualisiert, in dem viel mehr Daten über die Konfiguration der VM gespeichert werden.

Hinweis:

Das ältere verzeichnisbasierte XVA-Format behält nicht alle VM-Attribute vollständig bei. Insbesondere importierte VMs verfügen standardmäßig über keine virtuellen Netzwerkschnittstellen. Wenn eine Vernetzung erforderlich ist, erstellen Sie eine mitvif-create undvif-plug .

Wenn dies der Fallmetadata isttrue , können Sie einen zuvor exportierten Satz von Metadaten ohne zugehörige Datenträgerblöcke importieren. Nur-Metadatenimport schlägt fehl, wenn keine VDIs gefunden werden können (benannt nach SR undVDI.location), es sei denn, die--forceOption ist angegeben. In diesem Fall wird der Import unabhängig fortgesetzt. Wenn Datenträger gespiegelt oder außerhalb des Bandes verschoben werden können, ist der Import/Export von Metadaten eine schnelle Möglichkeit, VMs zwischen separaten Pools zu verschieben. Beispielsweise als Teil eines Disaster Recovery-Plans.

Hinweis:

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

vm-install

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]

Installieren oder Klonen einer virtuellen Maschine aus einer Vorlage. Geben Sie den Vorlagennamen entweder mit demtemplate-uuid Argumenttemplate oder an. Geben Sie einen SR mit demsr-uuid Argumentsr-name-label oder an. Geben Sie an, ob BIOS-gesperrte Medien mit demcopy-bios-strings-from Argument installiert werden sollen.

Hinweis:

Bei der Installation von einer Vorlage mit vorhandenen Datenträgern werden standardmäßig neue Datenträger in derselben SR wie diese vorhandenen Datenträger erstellt. Wo der SR es unterstützt, sind diese Festplatten schnelle Kopien. Wenn in der Befehlszeile ein anderer SR angegeben wird, werden dort die neuen Datenträger erstellt. In diesem Fall ist eine schnelle Kopie nicht möglich und die Festplatten sind vollständige Kopien.

Wenn Sie aus einer Vorlage installieren, die keine vorhandenen Datenträger enthält, werden alle neuen Datenträger in der angegebenen SR oder die Poolstandard-SR erstellt, wenn keine SR angegeben wird.

vm-is-bios-customized

vm-is-bios-customized

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

vm-memory-balloon

vm-memory-balloon target=target

Legen Sie das Speicherziel für eine ausgeführte VM fest. Der angegebene Wert muss innerhalb des Bereichs liegen, der durch die Werte memory_dynamic_min und memory_dynamic_max der VM definiert wird.

vm-memory-dynamic-range-set

vm-memory-dynamic-range-set min=min max=max

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 passen.

vm-memory-limits-set

vm-memory-limits-set static-min=static_min static-max=static_max dynamic-min=dynamic_min dynamic-max=dynamic_max

Konfigurieren Sie die Speichergrenzen einer VM.

vm-memory-set

vm-memory-set memory=memory

Konfigurieren Sie die Speicherzuweisung einer VM.

vm-memory-shadow-multiplier-set

vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]

Legen Sie den Schattenspeichermultiplikator für die angegebene VM fest.

Dies ist eine erweiterte Option, die die Menge des Schattenspeichers ändert, der einer hardwareunterstützten VM zugewiesen ist.

Bei einigen speziellen Anwendungsarbeitsauslastungen wie Citrix Virtual Apps ist zusätzlicher Schattenspeicher erforderlich, um die volle Leistung zu erzielen.

Dieser Speicher wird als Overhead betrachtet. Es ist von den normalen Speicherberechnungen für die Buchhaltung Speicher zu einer VM getrennt. Wenn dieser Befehl aufgerufen wird, verringert sich die Menge des freien Hostspeichers entsprechend dem Multiplikator und dasHVM_shadow_multiplier Feld wird mit dem Wert aktualisiert, den Xen der VM zugewiesen hat. Wenn nicht genügend Speicher für den Citrix Hypervisor Server frei ist, wird ein Fehler zurückgegeben.

Die VMs, auf denen dieser Vorgang ausgeführt werden soll, werden mit dem Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren.

vm-memory-static-range-set

vm-memory-static-range-set min=min max=max

Konfigurieren Sie den statischen Speicherbereich einer VM. Der statische Speicherbereich definiert harte Unter- und Obergrenzen für den Speicher einer VM. Diese Felder können nur geändert werden, wenn eine VM angehalten wird. Der statische Bereich muss den Dynamikbereich umfassen.

vm-memory-target-set

vm-memory-target-set target=target

Legen Sie das Speicherziel für eine angehalten oder ausgeführte VM fest. Der angegebene Wert muss innerhalb des Bereichs liegen, der durch die Werte memory_static_min und memory_static_max der VM definiert wird.

vm-memory-target-wait

vm-memory-target-wait

Warten Sie, bis eine ausgeführte VM ihr aktuelles Speicherziel erreicht hat.

vm-migrate

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:=vif_uuid] [vdi=vdi_uuid]

Mit diesem Befehl werden die angegebenen VMs zwischen physischen Hosts migriert. Derhost Parameter kann entweder der Name oder die UUID des Citrix Hypervisor or-Servers sein. Zum Beispiel, um die VM auf einen anderen Host im Pool zu migrieren, auf dem sich die VM-Festplatten auf Speicher befinden, der von beiden Hosts gemeinsam genutzt wird:

xe vm-migrate uuid=vm_uuid host-uuid=host_uuid

So verschieben Sie VMs zwischen Hosts im selben Pool, die keinen Speicher gemeinsam nutzen (Storage Livemigration):

xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78 \
    remote-username=username remote-password=password \
    host-uuid=desination_host_uuid vdi=vdi_uuid

Sie können die SR auswählen, in der jeder VDI gespeichert wird:

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
    vdi1:vdi_1_uuid=destination_sr_uuid \
    vdi2:vdi_2_uuid=destination_sr2_uuid \
    vdi3:vdi_3_uuid=destination_sr3_uuid

Darüber hinaus können Sie auswählen, welches Netzwerk die VM nach der Migration angeschlossen werden soll:

xe vm-migrate uuid=vm_uuid \
    vdi1:vdi_1_uuid=destination_sr_uuid \
    vdi2:vdi_2_uuid=destination_sr2_uuid \
    vdi3:vdi_3_uuid=destination_sr3_uuid \
    vif:vif_uuid=network_uuid

Für die Pool-Migration:

xe vm-migrate uuid=vm_uuid remote-master=12.34.56.78
    remote-username=username remote-password=password \
    host-uuid=desination_host_uuid vdi=vdi_uuid

Weitere Informationen zu Speicher-Livemigration, Live-Migration und Live-VDI-Migration finden Sie unterMigrieren von VMs.

Standardmäßig wird die VM auf dem anderen Host angehalten, migriert und fortgesetzt. Derlive Parameter wählt die Live-Migration aus. Bei der Livemigration wird die VM während der Migration ausgeführt, wodurch die Ausfallzeit von virtuellen Rechnern auf weniger als eine Sekunde reduziert wird. Unter bestimmten Umständen, wie z. B. extrem speicherintensive Arbeitslasten in der VM, wird die Livemigration wieder in den Standardmodus versetzt und die VM für kurze Zeit angehalten, bevor die Speicherübertragung abgeschlossen wird.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-pause

vm-pause

Eine ausgeführte VM anhalten. Beachten Sie, dass dieser Vorgang den zugeordneten Speicher nicht freigibt (siehevm-suspend).

vm-query-services

vm-query-services

Fragen Sie die Systemdienste ab, die von den angegebenen VMs angeboten werden.

vm-reboot

vm-reboot [vm-selector=vm_selector_value...] [force=true]

Starten Sie die angegebenen VMs neu.

Die VM oder 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 VM-Parameter aufgeführten sein.

Verwenden Sie dasforce Argument, um einen ungrassigen Neustart zu verursachen. Wo das Herunterfahren dem Ziehen des Steckers auf einem physischen Server ähnlich ist.

vm-recover

vm-recover vm-uuid [database] [vdi-uuid] [force]

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

vm-reset-powerstate

vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}

Die VM oder 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 VM-Parameter aufgeführten sein.

Dies ist ein erweiterter Befehl, der nur verwendet werden kann, wenn ein Mitgliedshost in einem Pool ausfällt. Sie können diesen Befehl verwenden, um den Poolmaster zu erzwingen, den Energiezustand der VMs zurückzusetzenhalted. Im Wesentlichen erzwingt dieser Befehl die Sperre für die VM und ihre Festplatten, so dass sie als nächstes auf einem anderen Pool-Host gestartet werden kann. Dieser Aufruf erfordert, dass das force-Flag angegeben wird, und schlägt fehl, wenn es sich nicht in der Befehlszeile befindet.

vm-resume

vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]

Setzen Sie die angegebenen VMs fort.

Die VM oder 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 VM-Parameter aufgeführten sein.

Wenn sich die VM in einem gemeinsam genutzten SR in einem Hostpool befindet, geben Sie mit demon Argument an, auf welchem Pool-Mitglied sie gestartet werden soll. Standardmäßig bestimmt das System einen geeigneten Host, der eines der Mitglieder des Pools sein kann.

vm-retrieve-wlb-recommendations

vm-retrieve-wlb-recommendations

Rufen Sie die Arbeitslastausgleichsempfehlungen für die ausgewählte VM ab.

vm-shutdown

vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]

Fahren Sie die angegebene VM herunter.

Die VM oder 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 VM-Parameter aufgeführten sein.

Verwenden Sie dasforce Argument, um ein ungleichtes Herunterfahren zu verursachen, ähnlich dem Ziehen des Steckers auf einem physischen Server.

vm-snapshot

vm-snapshot new-name-label=name_label [new-name-description+name_description]

Snapshot einer vorhandenen VM, sofern verfügbar, unter Verwendung eines schnellen Festplatten-Snapshot-Vorgangs auf Speicherebene.

vm-snapshot-with-quiesce

vm-snapshot-with-quiesce new-name-label=name_label [new-name-description+name_description]

Snapshot einer vorhandenen VM mit Stillstand, wobei der schnelle Festplatten-Snapshot-Vorgang auf Speicherebene verwendet wird, sofern verfügbar.

vm-start

vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]

Starten Sie die angegebenen VMs.

Die VM oder 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 VM-Parameter aufgeführten sein.

Wenn sich die VMs in einem gemeinsam genutzten SR in einem Hostpool befinden, geben Sie mit demon Argument an, auf welchem Pool-Mitglied die VMs gestartet werden sollen. Standardmäßig bestimmt das System einen geeigneten Host, der eines der Mitglieder des Pools sein kann.

vm-suspend

vm-suspend [vm-selector=vm_selector_value...]

Anhalten der angegebenen VM.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-uninstall

vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]

Deinstallieren Sie eine VM, indem Sie ihre Festplatten (die VDIs, die als RW gekennzeichnet sind und nur mit dieser VM verbunden sind) sowie deren Metadatendatensatz löschen. Um nur die VM-Metadaten zu zerstören, verwenden Siexe vm-destroy.

Die VM oder 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 VM-Parameter aufgeführten sein.

vm-unpause

vm-unpause

Heben Sie die Unterbrechung einer angehaltenen VM auf.

vm-vcpu-hotplug

vm-vcpu-hotplug new-vcpus=new_vcpu_count [vm-selector=vm_selector_value...]

Passen Sie die Anzahl der vCPUs dynamisch an, die für eine laufende PV- oder HVM-Linux-VM verfügbar sind. Die Anzahl der vCPUs wird durch den Parameter begrenztVCPUs-max. Windows VMs werden immer mit der Anzahl der vCPUs ausgeführt VCPUs-max und müssen neu gestartet werden, um diesen Wert zu ändern.

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

Hinweis:

Wenn Sie Linux-VMs ohne installierte Citrix VM Tools ausführen, führen Sie den folgenden Befehl auf der VM aus,root um sicherzustellen, dass die neu installierten Hot-Plug-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

vm-vif-list [vm-selector=vm_selector_value...]

Listet die VIFs der angegebenen VMs auf.

Die VM oder VMs, auf denen dieser Vorgang ausgeführt wird, werden mithilfe des Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Die Selektoren arbeiten beim Filtern auf den VM-Datensätzen und nicht auf den VIF-Werten. Optionale Argumente können eine beliebige Anzahl der am Anfang dieses Abschnitts VM-Parameter aufgeführten sein.

Geplante Snapshots

Befehle zum Steuern von VM Shceduled Snapshots und deren Attribute.

Die vmss-Objekte können mit dem Befehl zur Standardobjektauflistung (xe vmss-list) und mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle

vmss-create

vmss-create enabled=True/False name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule

Erstellt einen Snapshot-Zeitplan im Pool.

Zum 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

Snapshot-Zeitpläne haben die folgenden Parameter:

Parametername Beschreibung Typ
name-label Name des Snapshot-Zeitplans. Lese-/Schreibzugriff
name-description Beschreibung des Snapshot-Zeitplans. Lese-/Schreibzugriff
type Festplatten-Snapshot; Speicher-Snapshot; Stillgestellter Snapshot Lese-/Schreibzugriff
frequency Stündlich; Täglich; Wöchentlich Lese-/Schreibzugriff
retained-snapshots Zu behaltende Snapshots. Reichweite: 1-10 Lese-/Schreibzugriff
schedule schedule:days ( Montag bis Sonntag),schedule:hours (0 bis 23),schedule:minutes (0, 15, 30, 45) Lese-/Schreibzugriff

vmss-destroy

vmss-destroy uuid=uuid

Zerstört einen Snapshot-Zeitplan im Pool.

USB-Durchgang

USB-Passthrough aktivieren/deaktivieren

pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false

USB-Pass-Through aktivieren/deaktivieren.

pusb-scan

pusb-scan host-uuid=host_uuid

Scannen Sie PUSB und aktualisieren Sie.

vusb-create

vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid

Erstellt einen virtuellen USB im Pool. Starten Sie die VM, um den USB an die VM zu übergeben.

vusb-unplug

vusb-unplug uuid=vusb_uuid

Entsteckt USB von VM.

vusb-destroy

vusb-destroy uuid=vusb_uuid

Entfernt die virtuelle USB-Liste von VM.