Befehlszeilenschnittstelle

Die xe-CLI ermöglicht Ihnen das Skripting und die Automatisierung von Systemverwaltungsaufgaben. Verwenden Sie die CLI, um XenServer® in eine bestehende IT-Infrastruktur zu integrieren.

Erste Schritte mit der xe-CLI

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

Auf Ihrem XenServer-Host

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

• Gehen Sie in XenCenter zur Registerkarte Konsole für den Host, auf dem Sie den Befehl ausführen möchten.
• Stellen Sie eine SSH-Verbindung zum Host her, auf dem Sie den Befehl ausführen möchten.

Unter Windows

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

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

Unter Linux

Auf RPM-basierten Distributionen (wie Red Hat) können Sie den eigenständigen xe-Befehl aus dem RPM namens client_install/xapi-xe-BUILD.x86_64.rpm auf der Haupt-XenServer-Installations-ISO installieren.

Um von der RPM zu installieren, verwenden Sie den folgenden Befehl:

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

Sie können Parameter in der Befehlszeile verwenden, um den XenServer-Host, den Benutzernamen und das Kennwort zu definieren, die bei der Ausführung 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>"
<!--NeedCopy-->

Hinweis:

Die Remote-xe-CLI unter Linux kann hängen bleiben, wenn versucht wird, Befehle über eine sichere Verbindung auszuführen und diese Befehle eine Dateiübertragung beinhalten. In diesem Fall können Sie den Parameter --no-ssl verwenden, um den Befehl über eine unsichere Verbindung zum XenServer-Host auszuführen.

Hilfe zu xe-Befehlen erhalten

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

xe help command
<!--NeedCopy-->

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

xe help
<!--NeedCopy-->

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

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

Grundlegende xe-Syntax

Die grundlegende Syntax aller XenServer xe CLI-Befehle lautet:

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

Jeder spezifische Befehl enthält seine eigenen Argumente, die die Form argument=value haben. Einige Befehle haben erforderliche Argumente, und die meisten haben eine Reihe optionaler Argumente. Typischerweise 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 zum Verbinden und Authentifizieren verwendet. Diese Argumente haben ebenfalls die Form argument=argument_value.

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

Ein password-file-Argument kann anstelle des Passworts direkt angegeben werden. In diesem Fall versucht der xe-Befehl, das Passwort aus der angegebenen Datei zu lesen und verwendet dieses Passwort zur Verbindung. (Alle nachgestellten CRs und LFs am Ende der Datei werden entfernt.) Diese Methode ist sicherer, als das Passwort direkt in der Befehlszeile anzugeben.

Das optionale Argument port kann verwendet werden, um den Agent-Port auf dem Remote-XenServer-Host anzugeben (Standard ist 443).

Beispiel: Auf dem lokalen XenServer-Host:

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

Beispiel: Auf einem Remote-XenServer-Host:

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

Für Remote-Verbindungsargumente ist auch eine Kurzschreibweise verfügbar:

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

Beispiel: Auf einem Remote-XenServer-Host:

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

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

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

Nach Ausführung dieses Befehls müssen Sie die Remote-XenServer-Host-Parameter nicht mehr in jedem xe-Befehl angeben, den Sie ausführen.

Die Verwendung der Umgebungsvariablen XE_EXTRA_ARGS ermöglicht auch die Tab-Vervollständigung von xe-Befehlen, wenn diese auf einem Remote-XenServer-Host ausgeführt werden, was standardmäßig deaktiviert ist.

Sonderzeichen und Syntax

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

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

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

Wenn Sie die CLI auf Ihrem XenServer-Host verwenden, verfügen Befehle über eine Tab-Vervollständigungsfunktion, die der Funktion in der Standard-Linux-Bash-Shell ähnelt. Wenn Sie beispielsweise xe vm-l eingeben und dann die Taste TAB drücken, wird der Rest des Befehls angezeigt. Wenn mehr als ein Befehl mit vm-l beginnt, listet ein erneutes Drücken von TAB die Möglichkeiten auf. Diese Funktion ist nützlich, wenn Sie Objekt-UUIDs in Befehlen angeben.

Hinweis:

Die Tab-Vervollständigung funktioniert normalerweise nicht, wenn Befehle auf einem entfernten XenServer-Host ausgeführt werden. Wenn Sie jedoch die Variable XE_EXTRA_ARGS auf dem Computer festlegen, auf dem Sie die Befehle eingeben, wird die Tab-Vervollständigung aktiviert. Weitere Informationen finden Sie unter Grundlegende xe-Syntax.

Befehlstypen

Die CLI-Befehle können in zwei Hälften unterteilt werden. Low-Level-Befehle befassen sich mit der Auflistung und Parameterbearbeitung von API-Objekten. High-Level-Befehle werden verwendet, um auf einer abstrakteren Ebene mit VMs oder Hosts zu interagieren.

Die Low-Level-Befehle sind:

• class-list

• class-param-get

• class-param-set

• class-param-list

• class-param-add

• class-param-remove

• class-param-clear

Wobei class eines 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 von class verfügt über den vollständigen Satz von class-param-action-Befehlen. Einige Werte von class verfügen über einen kleineren Satz von Befehlen.

Parametertypen

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

Die meisten Parameter nehmen einen einzelnen Wert an. Zum Beispiel enthält der name-label-Parameter einer VM einen einzelnen Zeichenfolgenwert. In der Ausgabe von Parameterlistenbefehlen, wie z. B. xe vm-param-list, gibt ein Wert in Klammern an, ob Parameter Lese-/Schreibzugriff (RW) oder Nur-Lesezugriff (RO) haben. Die Ausgabe von xe vm-param-list auf einer angegebenen VM könnte die folgenden Zeilen enthalten:

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

Der erste Parameter, user-version, ist beschreibbar und hat den Wert 1. Der zweite, is-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 map-Parameter ist eine Menge von Schlüssel-Wert-Paaren. Betrachten Sie als Beispiel den folgenden Auszug aus der Beispielausgabe von xe vm-param-list auf einer angegebenen VM:

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

Der platform-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 vor dem RW zeigt an, dass dieser Parameter ein Map-Parameter ist und lesbar und beschreibbar ist. Der allowed-operations-Parameter enthält eine Liste, die eine Menge von Elementen bildet. Das S vor dem RO zeigt an, dass dies ein Set-Parameter ist und lesbar, aber nicht beschreibbar ist.

Um nach einem Map-Parameter zu filtern oder einen Map-Parameter festzulegen, verwenden Sie einen Doppelpunkt (:) zur Trennung des Map-Parameternamens und des Schlüssel-Wert-Paares. Um beispielsweise den Wert des foo-Schlüssels des other-config-Parameters einer VM auf baa zu setzen, lautet der Befehl:

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

Befehle für Parameter auf niedriger Ebene

Es gibt mehrere Befehle zum Bearbeiten 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 nimmt einen uuid-Parameter an, um das jeweilige Objekt anzugeben. Da diese Befehle als Low-Level-Befehle gelten, müssen sie die UUID und nicht das VM-Namenslabel verwenden.

• xe class-param-list uuid=uuid

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

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

  Gibt den Wert eines bestimmten Parameters zurück. Bei einem Kartenparameter ruft die Angabe des Param-Schlüssels den Wert ab, der diesem Schlüssel in der Karte zugeordnet ist. Wenn der Param-Schlüssel nicht angegeben wird oder wenn der Parameter ein Satz ist, gibt der Befehl eine Zeichenfolgendarstellung des Satzes oder der Karte zurück.

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

  Legt den Wert eines oder mehrerer Parameter fest.

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

  Fügt entweder einem Karten- oder einem Satzparameter hinzu. Für einen Kartenparameter fügen Sie Schlüssel-Wert-Paare mit der Syntax key=value hinzu. Wenn der Parameter ein Satz ist, fügen Sie Schlüssel mit der Syntax param-key=key hinzu.

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

• xe 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 class auf. Standardmäßig listet dieser Befehlstyp alle Objekte auf und gibt eine Untermenge der Parameter aus. Dieses Verhalten kann auf folgende Weisen geändert werden:

• Er kann die Objekte filtern, sodass nur eine Untermenge ausgegeben wird.
• Die ausgegebenen Parameter können geändert werden.

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

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

Alternativ können Sie alle Parameter mit folgender Syntax auflisten:

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

Der Befehl „list“ zeigt einige Parameter nicht an, deren Berechnung aufwendig ist. Diese Parameter werden beispielsweise wie folgt angezeigt:

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

Um diese Felder zu erhalten, verwenden Sie entweder den Befehl class-param-list oder class-param-get.

Um die Liste zu filtern, gleicht die CLI Parameterwerte mit den in der Befehlszeile angegebenen Werten ab und druckt nur Objekte, die alle angegebenen Einschränkungen erfüllen. Zum Beispiel:

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

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

Sie können die Liste auch nach dem Wert von Schlüsseln in Maps oder nach dem Vorhandensein von Werten in einem Set filtern. Die Syntax zum Filtern basierend auf Schlüsseln in Maps ist map-name:key=value. Die Syntax zum Filtern basierend auf vorhandenen Werten in einem Set ist set-name:contains=value.

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

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

Geheimnisse

XenServer bietet einen Geheimnis-Mechanismus, um zu verhindern, dass Passwörter im Klartext in der Befehlszeilenhistorie oder in API-Objekten gespeichert werden. XenCenter verwendet diese Funktion automatisch, und sie kann auch über die xe CLI für jeden Befehl verwendet werden, der ein Passwort erfordert.

Hinweis:

Passwort-Geheimnisse können nicht verwendet werden, um sich von einer Remote-Instanz der xe CLI bei einem XenServer-Host zu authentifizieren.

Um ein Geheimnisobjekt zu erstellen, führen Sie den folgenden Befehl auf Ihrem XenServer-Host aus.

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

Ein Geheimnis wird erstellt und auf dem XenServer-Host gespeichert. Der Befehl gibt die UUID des Geheimnisobjekts aus. Zum Beispiel 99945d96-5890-de2a-3899-8c04ef2521db. Hängen Sie _secret an den Namen des Passwortarguments an, um diese UUID an jeden Befehl zu übergeben, der ein Passwort erfordert.

Beispiel: Auf dem XenServer-Host, auf dem Sie das Geheimnis erstellt haben, können Sie den folgenden Befehl ausführen:

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

Befehlsverlauf

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

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

xe-Befehlsreferenz

Dieser Abschnitt gruppiert die Befehle nach den Objekten, die der Befehl anspricht. Diese Objekte sind alphabetisch aufgelistet.

Appliance-Befehle

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

Appliance-Parameter

Appliance-Befehle haben die folgenden Parameter:

appliance-assert-can-be-recovered

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

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

appliance-create

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

Erstellt eine Appliance/vApp. Zum Beispiel:

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

VMs zur Appliance hinzufügen:

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

appliance-destroy

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

Zerstört eine Appliance/vApp. Zum Beispiel:

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

appliance-recover

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

Stellt eine VM-Appliance/vApp aus der in der bereitgestellten VDI enthaltenen Datenbank wieder her.

appliance-shutdown

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

Fährt alle VMs in einer Appliance/vApp herunter. Zum Beispiel:

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

appliance-start

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

Startet eine Appliance/vApp. Zum Beispiel:

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

Audit-Befehle

Audit-Befehle laden alle verfügbaren Datensätze der RBAC-Auditdatei im Pool herunter. Wenn der optionale Parameter since vorhanden ist, lädt er nur die Datensätze ab diesem spezifischen Zeitpunkt herunter.

audit-log-get Parameter

audit-log-get hat die folgenden Parameter

audit-log-get

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

Um beispielsweise Audit-Datensätze des Pools seit einem präzisen Millisekunden-Zeitstempel abzurufen, führen Sie den folgenden Befehl aus:

Führen Sie den folgenden Befehl aus:

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

Bonding-Befehle

Befehle für die Arbeit mit Netzwerk-Bonds, zur Ausfallsicherheit bei physischem Schnittstellen-Failover. Weitere Informationen finden Sie unter Netzwerk.

Das Bond-Objekt ist ein Referenzobjekt, das Master- und Member-PIFs miteinander verbindet. Die Master-PIF ist die Bonding-Schnittstelle, die als übergeordnete PIF verwendet werden muss, um auf den Bond zu verweisen. Die Member-PIFs sind eine Reihe von zwei oder mehr physischen Schnittstellen, die zu der übergeordneten Bonded-Schnittstelle kombiniert wurden.

Bond-Parameter

Bonds haben die folgenden Parameter:

bond-create

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

Erstellt eine gebundene Netzwerkschnittstelle im angegebenen Netzwerk aus einer Liste vorhandener PIF-Objekte. Der Befehl schlägt in einem der folgenden Fälle fehl:

• Wenn PIFs bereits in einem anderen Bond sind
• Wenn ein Mitglied ein VLAN-Tag gesetzt hat
• Wenn die referenzierten PIFs nicht auf demselben XenServer-Host sind
• Wenn weniger als 2 PIFs bereitgestellt werden

bond-destroy

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

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

bond-set-mode

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

Bond-Modus ändern.

CD-Befehle

Befehle zum Arbeiten mit physischen CD/DVD-Laufwerken auf XenServer-Hosts.

CD-Parameter

CDs haben die folgenden Parameter:

cd-list

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

Listet die CDs und ISOs (CD-Image-Dateien) auf dem XenServer-Host oder -Pool und filtert nach dem optionalen Argument params.

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

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

GFS2-Cluster-Befehle

Befehle für die Arbeit mit GFS2-Cluster-Pools.

GFS2-Cluster-Pools sind Ressourcen-Pools, bei denen die Clustering-Funktion aktiviert ist. Verwenden Sie diese Pools mit GFS2-SRs. Weitere Informationen finden Sie unter GFS2-Cluster-Pools

Die Cluster- und Cluster-Host-Objekte können mit den Standard-Objektlistungsbefehlen (xe cluster-list und xe cluster-host-list) aufgelistet werden, und die Parameter können mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-Level-Parameterbefehle. Befehle für die Arbeit mit GFS2-Cluster-Pools.

GFS2-Cluster-Parameter

GFS2-Cluster haben die folgenden Parameter:

Die Hosts innerhalb des GFS2-Clusters (cluster-host) haben die folgenden Parameter:

cluster-host-destroy

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

Einen GFS2-Cluster-Host zerstören, wodurch der GFS2-Cluster effektiv verlassen wird.

cluster-host-disable

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

GFS2-Cluster-Mitgliedschaft für einen aktivierten GFS2-Cluster-Host deaktivieren.

cluster-host-enable

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

GFS2-Cluster-Mitgliedschaft für einen deaktivierten GFS2-Cluster-Host aktivieren.

cluster-host-force-destroy

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

Ein GFS2-Cluster-Host-Objekt zwangsweise zerstören, wodurch der GFS2-Cluster effektiv verlassen wird.

cluster-pool-create

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

Pool-weiten GFS2-Cluster erstellen.

cluster-pool-destroy

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

Pool-weiten GFS2-Cluster zerstören. Der Pool existiert weiterhin, ist aber nicht mehr GFS2-geclustert und kann keine GFS2-SRs mehr verwenden.

cluster-pool-force-destroy

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

Poolweiten GFS2-Cluster zwangsweise zerstören.

cluster-pool-resync

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

Einen GFS2-Cluster über einen Pool hinweg neu synchronisieren.

Konsolenbefehle

Befehle zum Arbeiten mit Konsolen.

Die Konsolenobjekte können mit dem Standardbefehl zur Objektlistung (xe console-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Befehle für Low-Level-Parameter.

Konsolenparameter

Konsolen haben die folgenden Parameter:

console

xe console
<!--NeedCopy-->

An eine bestimmte Konsole anhängen.

Diagnosebefehle

Befehle zum Sammeln von Diagnoseinformationen von XenServer.

diagnostic-compact

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

Führt eine Haupt-GC-Sammlung und Heap-Kompaktierung durch.

diagnostic-db-stats

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

Datenbankstatistiken ausgeben.

diagnostic-gc-stats

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

GC-Statistiken ausgeben.

diagnostic-license-status

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

Hilft bei der Diagnose von poolweiten Lizenzierungsproblemen.

diagnostic-net-stats

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

Netzwerkstatistiken ausgeben.

diagnostic-timing-stats

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

Zeitstatistiken ausgeben.

diagnostic-vdi-status

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

Fragt den Sperr- und Freigabestatus eines VDI ab.

diagnostic-vm-status

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

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

Befehle zur Notfallwiederherstellung

Befehle zur Wiederherstellung von VMs nach einem Notfall

drtask-create

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

Erstellt eine Notfallwiederherstellungsaufgabe. Zum Beispiel, um eine iSCSI-SR zur Vorbereitung der Notfallwiederherstellung zu verbinden:

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

Hinweis:

Der Befehl sr-whitelist listet zulässige SR-UUIDs auf. Der Befehl drtask-create führt nur eine SR ein und verbindet sich mit ihr, die eine der zulässigen UUIDs besitzt.

drtask-destroy

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

Zerstört eine Notfallwiederherstellungsaufgabe und vergisst die eingeführte SR.

vm-assert-can-be-recovered

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

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

appliance-assert-can-be-recovered

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

Prüft, ob der Speicher (der die Appliance-/vAPP-Festplatte enthält) sichtbar ist.

appliance-recover

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

Stellt eine Appliance/vAPP aus der Datenbank wieder her, die in der bereitgestellten VDI enthalten ist.

vm-recover

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

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

sr-enable-database-replication

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

Aktiviert die XAPI-Datenbankreplikation auf dem angegebenen (gemeinsamen) SR.

sr-disable-database-replication

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

Deaktiviert die XAPI-Datenbankreplikation auf dem angegebenen SR.

Anwendungsbeispiel

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

Am primären Standort die Datenbankreplikation aktivieren:

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

Nach einem Notfall am sekundären Standort mit dem SR verbinden. Der Befehl device-config hat die gleichen Felder wie sr-probe.

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

Suchen Sie nach Datenbank-VDIs auf dem SR:

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

Fragen Sie eine Datenbank-VDI nach vorhandenen VMs ab:

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

VM wiederherstellen:

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

DR-Aufgabe zerstören. Alle SRs, die durch die DR-Aufgabe eingeführt und nicht von VMs benötigt werden, werden zerstört:

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

Ereignisbefehle

Befehle zum Arbeiten mit Ereignissen.

Ereignisklassen

Ereignisklassen sind in der folgenden Tabelle aufgeführt:

event-wait

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

Blockiert andere Befehle, bis ein Objekt existiert, das die in der Befehlszeile angegebenen Bedingungen erfüllt. Das Argument x=y bedeutet „warte, bis Feld x den Wert y annimmt“ und x=/=y bedeutet „warte, bis Feld x einen beliebigen Wert außer y annimmt.“

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

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

Blockiert andere Befehle, bis eine VM namens myvm sich im power-state Status “running” befindet.

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

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

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

Der Klassenname kann eine der Ereignisklassen sein, die am Anfang dieses Abschnitts aufgeführt sind. Die Parameter können beliebige der Parameter sein, die im CLI-Befehl class-param-list aufgeführt sind.

GPU-Befehle

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

Die GPU-Objekte können mit den Standardbefehlen zur Objektlistung aufgelistet werden: xe pgpu-list, xe gpu-group-list und xe vgpu-list. Die Parameter können mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands.

Parameter für physische GPUs

Physische GPUs (pGPUs) haben die folgenden Parameter:

pgpu-disable-dom0-access

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

Deaktivieren Sie den PGPU-Zugriff auf dom0.

pgpu-enable-dom0-access

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

Aktivieren Sie den PGPU-Zugriff auf dom0.

GPU-Gruppenparameter

GPU-Gruppen haben die folgenden Parameter:

GPU-Gruppen-Operationen

Befehle zum Arbeiten mit GPU-Gruppen

gpu-group-create

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

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

gpu-group-destroy

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

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

gpu-group-get-remaining-capacity

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

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

gpu-group-param-set

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

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

Parameter für virtuelle GPUs

Virtuelle GPUs haben die folgenden Parameter:

Parameter des virtuellen GPU-Typs

Hinweis:

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

Virtuelle GPU-Typen haben die folgenden Parameter:

Virtuelle GPU-Vorgänge

vgpu-create

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

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

vgpu-destroy

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

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
<!--NeedCopy-->

Die Verwendung von false deaktiviert die VNC-Konsole für eine VM, da es disablevnc=1 an den Display-Emulator weiterleitet. Standardmäßig ist VNC aktiviert.

Host-Befehle

Befehle zur Interaktion mit dem XenServer-Host.

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

Die XenServer-Host-Objekte können mit den Standardbefehlen zur Objektlistung aufgelistet werden: xe host-list, xe host-cpu-list und xe host-crashdump-list). Die Parameter können mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands.

Host-Selektoren

Mehrere der hier aufgeführten Befehle verfügen über einen gemeinsamen Mechanismus zur Auswahl eines oder mehrerer XenServer-Hosts, auf denen der Vorgang ausgeführt werden soll. Am einfachsten ist es, das Argument host=uuid_or_name_label anzugeben. Sie können XenServer auch angeben, indem Sie die vollständige Liste der Hosts nach den Werten von Feldern filtern. Wenn Sie beispielsweise enabled=true angeben, werden alle XenServer-Hosts ausgewählt, deren Feld enabled gleich true ist. Wenn mehrere XenServer-Hosts übereinstimmen und der Vorgang auf mehreren XenServer-Hosts ausgeführt werden kann, müssen Sie --multiple angeben, 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 xe host-list params=all ausführen. Wenn keine Parameter zur Auswahl von XenServer-Hosts angegeben werden, wird der Vorgang auf allen XenServer-Hosts ausgeführt.

Host-Parameter

XenServer-Hosts haben die folgenden Parameter:

XenServer-Hosts enthalten einige andere Objekte, die ebenfalls Parameterlisten haben.

CPUs auf XenServer-Hosts haben die folgenden Parameter:

Absturzabbilder auf XenServer-Hosts haben die folgenden Parameter:

host-all-editions

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

Eine Liste aller verfügbaren Editionen abrufen

host-apply-edition

xe host-apply-edition [host-uuid=host_uuid] [edition=premium-per-socket|standard-per-socket|cloud]
<!--NeedCopy-->

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

Informationen zur anfänglichen Lizenzkonfiguration finden Sie auch unter license-server-address und license-server-port.

Editionswerte umfassen „cloud“, „free“, „premium-per-socket“ und „standard-per-socket“. Zukünftig wird nur noch „cloud“ unterstützt.

host-backup

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

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

Wichtig:

Obwohl der Befehl xe host-backup funktioniert, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines spezifischen Hostnamens), sollten Sie ihn nicht auf diese Weise verwenden. Dies würde die Partition der Steuerdomäne mit der Sicherungsdatei füllen. Verwenden Sie den Befehl nur von einem entfernten Off-Host-Computer aus, auf dem Sie genügend Speicherplatz für die Sicherungsdatei haben.

host-bugreport-upload

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

Einen neuen Fehlerbericht erstellen (mit xen-bugtool, einschließlich aller optionalen Dateien) und auf die Support-FTP-Site oder einen anderen Speicherort hochladen.

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

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

host-call-plugin

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

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

host-compute-free-memory

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

Berechnet die Menge des freien Speichers auf dem Host.

host-compute-memory-overhead

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

Berechnet den Virtualisierungsspeicher-Overhead eines Hosts.

host-cpu-info

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

Listet Informationen über die physischen CPUs des Hosts auf.

host-crashdump-destroy

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

Löscht einen Host-Crashdump, der durch seine UUID angegeben ist, vom XenServer-Host.

host-crashdump-upload

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

Lädt einen Crashdump auf die Support-FTP-Site oder einen anderen Speicherort hoch. Wenn optionale Parameter nicht 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: Laden Sie auf diese Ziel-URL hoch.

host-declare-dead

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

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

Warnung:

Dieser Aufruf ist gefährlich und kann zu Datenverlust führen, wenn der Host nicht tatsächlich ausgefallen ist.

host-disable

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

Deaktiviert die angegebenen XenServer-Hosts, wodurch verhindert wird, dass neue VMs auf ihnen gestartet werden. Diese Aktion bereitet die XenServer-Hosts auf das Herunterfahren oder den Neustart vor. Nachdem dieser Host neu gestartet wurde und alle Bedingungen für die Aktivierung erfüllt sind (z. B. Speicher verfügbar ist), wird der Host automatisch wieder aktiviert.

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

host-disable-display

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

Deaktiviert die Anzeige für den Host.

host-disable-local-storage-caching

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

Deaktiviert das lokale Speichercaching auf dem angegebenen Host.

host-dmesg

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

Ruft einen Xen dmesg (die Ausgabe des Kernel-Ringpuffers) von den angegebenen XenServer-Hosts ab.

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

host-emergency-ha-disable

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

Deaktiviert HA auf dem lokalen Host. Nur zu verwenden, um einen Pool mit einer fehlerhaften HA-Einrichtung wiederherzustellen.

host-emergency-management-reconfigure

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

Konfigurieren Sie die Verwaltungsschnittstelle dieses XenServer-Hosts neu. Verwenden Sie diesen Befehl nur, wenn sich der XenServer-Host im Notfallmodus befindet. Notfallmodus bedeutet, dass der Host Mitglied eines Ressourcenpools ist, dessen Pool-Koordinator aus dem Netzwerk verschwunden ist und nach mehreren Wiederholungsversuchen nicht kontaktiert werden kann.

host-emergency-reset-server-certificate

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

Installiert ein selbstsigniertes Zertifikat auf dem XenServer-Host, auf dem der Befehl ausgeführt wird.

host-enable

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

Aktiviert die angegebenen XenServer-Hosts, wodurch neue VMs auf ihnen gestartet werden können.

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

host-enable-display

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

Anzeige für den Host aktivieren.

host-enable-local-storage-caching

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

Aktiviert das lokale Speichercaching auf dem angegebenen Host.

host-evacuate

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

Migriert alle laufenden VMs live auf andere geeignete Hosts in einem Pool. Deaktivieren Sie zuerst den Host mit dem Befehl host-disable.

Wenn der evakuierte Host der Pool-Koordinator ist, muss ein anderer Host als Pool-Koordinator ausgewählt werden. Um den Pool-Koordinator bei deaktiviertem HA zu ändern, verwenden Sie den Befehl pool-designate-new-master. Weitere Informationen finden Sie unter pool-designate-new-master.

Bei aktiviertem HA besteht Ihre einzige Möglichkeit darin, den XenServer-Host herunterzufahren, wodurch HA zufällig einen neuen Pool-Koordinator wählt. Weitere Informationen finden Sie unter host-shutdown.

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

host-forget

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

Der XAPI-Agent vergisst den angegebenen XenServer-Host, ohne ihn explizit zu kontaktieren.

Verwenden Sie den Parameter --force, um nicht zur Bestätigung aufgefordert zu werden, dass Sie diesen Vorgang wirklich ausführen möchten.

Warnung:

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

Dieser Befehl ist nützlich, wenn der XenServer-Host, der „vergessen“ werden soll, nicht mehr aktiv ist. Wenn der XenServer-Host jedoch aktiv und Teil des Pools ist, verwenden Sie stattdessen xe pool-eject.

host-get-server-certificate

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

Rufen Sie das installierte Server-TLS-Zertifikat ab.

host-get-sm-diagnostics

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

Anzeigen von SM-Diagnoseinformationen pro Host.

host-get-system-status

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

Laden Sie Systemstatusinformationen in die angegebene Datei herunter. Der optionale Parameter entries ist eine durch Kommas getrennte Liste von Systemstatuseinträgen, die dem XML-Fragment der Funktionen entnommen sind, das vom Befehl host-get-system-status-capabilities zurückgegeben wird. Weitere Informationen finden Sie unter host-get-system-status-capabilities. Wenn nicht angegeben, werden alle Systemstatusinformationen in der Datei gespeichert. Der Parameter output kann tar.bz2 (Standard) oder zip sein. Wenn dieser Parameter nicht angegeben ist, wird die Datei im Format tar.bz2 gespeichert.

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

host-get-system-status-capabilities

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

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

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

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

• key Eine eindeutige Kennung für die Capability.
• content-type Kann entweder text/plain oder application/data sein. Zeigt an, ob eine Benutzeroberfläche die Einträge zur menschlichen Nutzung rendern kann.
• default-checked Kann entweder ja oder nein sein. Zeigt an, ob eine Benutzeroberfläche diesen Eintrag standardmäßig auswählt.
• min-size, max-size Zeigt einen ungefähren Bereich für die Größe dieses Eintrags in Bytes an. -1 bedeutet, dass die Größe unwichtig ist.
• min-time, max-time Zeigt einen ungefähren Bereich für die Zeit in Sekunden an, die zum Sammeln dieses Eintrags benötigt wird. -1 bedeutet, dass die Zeit unwichtig ist.

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

  • no: keine PII in diesen Einträgen enthalten
  • yes: PII ist wahrscheinlich oder sicher in diesen Einträgen enthalten
  • maybe: Sie sollten diese Einträge möglicherweise auf PII prüfen
  • if_customized Wenn die Dateien unverändert sind, enthalten sie keine PII. Da wir jedoch die Bearbeitung dieser Dateien fördern, könnten durch solche Anpassungen PII eingeführt worden sein. Dieser Wert wird insbesondere für die Netzwerk-Skripte in der Kontrolldomäne verwendet.

  Passwörter dürfen niemals in Fehlerberichten enthalten sein, unabhängig von einer PII-Deklaration.

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

host-get-thread-diagnostics

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

Anzeige der Thread-Diagnoseinformationen pro Host.

host-get-vms-which-prevent-evacuation

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

Gibt eine Liste von VMs zurück, die die Evakuierung eines bestimmten Hosts verhindern, und zeigt die Gründe für jede einzelne an.

host-is-in-emergency-mode

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

Gibt true zurück, wenn sich der Host, mit dem die CLI kommuniziert, im Notfallmodus befindet, andernfalls false. Dieser CLI-Befehl funktioniert direkt auf Pool-Mitglieds-Hosts, auch wenn kein Pool-Koordinator vorhanden ist.

host-license-view

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

Zeigt den Inhalt der XenServer-Hostlizenz an.

host-logs-download

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

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

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

Wichtig:

Obwohl der Befehl xe host-logs-download funktioniert, wenn er auf dem lokalen Host ausgeführt wird (d. h. ohne Angabe eines spezifischen Hostnamens), sollten Sie ihn nicht auf diese Weise verwenden. Dies würde die Partition der Steuerdomäne mit der Kopie der Protokolle überladen. Verwenden Sie den Befehl nur von einem entfernten, externen Computer aus, auf dem Sie Platz für die Kopie der Protokolle haben.

host-management-disable

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

Deaktiviert den Host-Agenten, der auf einer externen Management-Netzwerkschnittstelle lauscht, und trennt alle verbundenen API-Clients (wie XenCenter). Dieser Befehl arbeitet direkt auf dem XenServer-Host, mit dem die CLI verbunden ist. Der Befehl wird nicht an den Pool-Koordinator weitergeleitet, wenn er auf einen Mitglieds-XenServer-Host angewendet wird.

Warnung:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl extern verwenden. Nachdem dieser Befehl ausgeführt wurde, können Sie sich nicht mehr remote über das Netzwerk mit der Steuerdomäne verbinden, um den Host-Agenten wieder zu aktivieren.

host-management-reconfigure

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

Konfiguriert den XenServer-Host neu, um die angegebene Netzwerkschnittstelle als seine Verwaltungsschnittstelle zu verwenden, welche die Schnittstelle ist, die zur Verbindung mit dem XenCenter verwendet wird. Der Befehl überschreibt den MANAGEMENT_INTERFACE-Schlüssel in /etc/xensource-inventory.

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

Wenn die UUID eines PIF-Objekts angegeben wird, bestimmt der XenServer-Host, welche IP-Adresse er sich selbst neu zuweisen soll. Er darf sich nicht im Notfallmodus befinden, wenn dieser Befehl ausgeführt wird.

Warnung:

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

host-power-on

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

Schaltet die Stromversorgung von XenServer-Hosts ein, bei denen die Funktion Host Power On aktiviert ist. Bevor Sie diesen Befehl verwenden, aktivieren Sie host-set-power-on auf dem Host.

host-reboot

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

Startet die angegebenen XenServer-Hosts neu. Die angegebenen Hosts müssen zuerst mit dem Befehl xe host-disable deaktiviert werden, andernfalls wird eine Fehlermeldung HOST_IN_USE angezeigt.

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

Wenn die angegebenen XenServer-Hosts Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren behandelt, und der Pool stellt sich wieder her, wenn die XenServer-Hosts zurückkehren. Die anderen Mitglieder und der Pool-Koordinator funktionieren weiterhin.

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

• Sie machen eines der Mitglieder zum Pool-Koordinator

• Der ursprüngliche Pool-Koordinator wird neu gestartet und ist wieder online.

  Wenn der Pool-Koordinator wieder online ist, verbinden sich die Mitglieder wieder und synchronisieren sich mit dem Pool-Koordinator.

host-restore

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

Stellen Sie ein Backup namens file-name der XenServer-Host-Steuerungssoftware wieder her. Die Verwendung des Wortes „Wiederherstellen“ bedeutet hier keine vollständige Wiederherstellung im üblichen Sinne, sondern lediglich, dass die komprimierte Sicherungsdatei entpackt und auf die sekundäre Partition ausgepackt wurde. Nachdem Sie ein xe host-restore durchgeführt haben, müssen Sie die Installations-CD booten und deren Option „Aus Backup wiederherstellen“ verwenden.

Die Hosts, auf denen dieser Vorgang ausgeführt werden soll, werden über den Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben). Optionale Argumente können beliebig viele der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

host-send-debug-keys

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

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

host-server-certificate-install

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

Installieren Sie ein TLS-Zertifikat auf einem XenServer-Host.

host-set-hostname-live

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

Ändern Sie den Hostnamen des durch host-uuid angegebenen XenServer-Hosts. Dieser Befehl legt sowohl den Hostnamen in der Steuerdomänendatenbank als auch den tatsächlichen Linux-Hostnamen des XenServer-Hosts dauerhaft fest. Der Wert von host-name ist nicht derselbe wie der Wert des Feldes name_label.

host-set-power-on-mode

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

Verwenden Sie dies, um die Funktion Host Power On auf XenServer-Hosts zu aktivieren, die mit Remote-Stromversorgungslösungen kompatibel sind. Bei Verwendung des Befehls host-set-power-on müssen Sie den Typ der Energieverwaltungslösung auf dem Host angeben (d. h. den Power-on-Modus). Geben Sie dann Konfigurationsoptionen mithilfe des Arguments power-on-config und der zugehörigen Schlüssel-Wert-Paare an.

Um die Secrets-Funktion zum Speichern Ihres Passworts zu verwenden, geben Sie den Schlüssel "power_on_password_secret" an. Weitere Informationen finden Sie unter Secrets.

host-shutdown

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

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

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

Wenn die angegebenen XenServer-Hosts Mitglieder eines Pools sind, wird der Verbindungsverlust beim Herunterfahren behandelt, und der Pool stellt sich wieder her, wenn die XenServer-Hosts zurückkehren. Die anderen Mitglieder und der Pool-Koordinator funktionieren weiterhin.

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

• Sie machen eines der Mitglieder zum Pool-Koordinator

• Der ursprüngliche Pool-Koordinator wird neu gestartet und ist wieder online.

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

Wenn HA für den Pool aktiviert ist, wird eines der Mitglieder automatisch zum Pool-Koordinator ernannt. Wenn HA deaktiviert ist, müssen Sie den gewünschten XenServer-Host manuell mit dem Befehl pool-designate-new-master als Pool-Koordinator festlegen. Weitere Informationen finden Sie unter pool-designate-new-master.

host-sm-dp-destroy

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

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

host-sync-data

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

Synchronisieren Sie die auf dem Pool-Koordinator gespeicherten Daten mit dem benannten Host. Dies schließt die Datenbankdaten nicht ein).

host-syslog-reconfigure

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

Konfigurieren Sie den syslog-Daemon auf den angegebenen XenServer-Hosts neu. Dieser Befehl wendet die Konfigurationsinformationen an, die im Host-Parameter logging definiert sind.

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

host-data-source-list

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

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

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

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

• Wenn eine Datenquelle enabled auf true gesetzt hat, werden die Metriken derzeit in der Leistungsdatenbank aufgezeichnet.
• Wenn eine Datenquelle standard auf true gesetzt hat, werden die Metriken standardmäßig in der Leistungsdatenbank aufgezeichnet. Der Wert von enabled ist für diese Datenquelle ebenfalls auf true gesetzt.
• Wenn eine Datenquelle standard auf false gesetzt hat, werden die Metriken nicht standardmäßig in der Leistungsdatenbank aufgezeichnet. Der Wert von enabled ist für diese Datenquelle ebenfalls auf false gesetzt.

Um die Aufzeichnung von Datenquellenmetriken in der Leistungsdatenbank zu starten, führen Sie den Befehl host-data-source-record aus. Dieser Befehl setzt enabled auf true. Zum Beenden führen Sie host-data-source-forget aus. Dieser Befehl setzt enabled auf false.

host-data-source-record

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

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

Dieser Vorgang schreibt die Informationen aus der Datenquelle in die persistente Leistungsmetrikdatenbank der angegebenen Hosts. Aus Leistungsgründen ist diese Datenbank von der normalen Agenten-Datenbank getrennt.

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

host-data-source-forget

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

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

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

host-data-source-query

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

Die angegebene Datenquelle für einen Host anzeigen.

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

Nachrichtenbefehle

Befehle für die Arbeit mit Nachrichten. Nachrichten werden erstellt, um Benutzer über wichtige Ereignisse zu informieren, und werden in XenCenter als Warnungen angezeigt.

Die Nachrichtenobjekte können mit dem Standardbefehl zur Objektlistung (xe message-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level-Parameterbefehle

Nachrichtenparameter

message-create

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

Erstellt eine Nachricht.

message-destroy

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

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

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

Netzwerkbefehle

Befehle für die Arbeit mit Netzwerken.

Die Netzwerkobjekte können mit dem Standardbefehl zur Objektlistung (xe network-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

Netzwerkparameter

Netzwerke haben die folgenden Parameter:

network-create

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

Erstellt ein Netzwerk.

network-destroy

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

Zerstört ein vorhandenes Netzwerk.

SR-IOV-Befehle

Befehle für die Arbeit mit SR-IOV.

Die network-sriov-Objekte können mit dem Standardbefehl zur Objektlistung (xe network-sriov-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

SR-IOV-Parameter

SR-IOV hat die folgenden Parameter:

network-sriov-create

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

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

network-sriov-destroy

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

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

SR-IOV VF zuweisen

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

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

SDN-Controller-Befehle

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

sdn-controller-forget

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

Einen SDN-Controller einführen.

sdn-controller-introduce

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

Einen SDN-Controller entfernen.

Tunnelbefehle

Befehle für die Arbeit mit Tunneln.

tunnel-create

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

Einen neuen Tunnel auf einem Host erstellen.

tunnel-destroy

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

Einen Tunnel zerstören.

Patch-Befehle

Befehle für die Arbeit mit Patches.

patch-apply

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

Wendet den zuvor hochgeladenen Patch auf den angegebenen Host an.

patch-clean

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

Löscht eine zuvor hochgeladene Patch-Datei.

patch-destroy

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

Entfernt einen nicht angewendeten Patch-Eintrag und zugehörige Dateien vom Host.

patch-pool-apply

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

Wendet den zuvor hochgeladenen Patch auf alle Hosts im Pool an.

patch-pool-clean

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

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

patch-precheck

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

Führt die im Patch enthaltenen Vorabprüfungen aus, der zuvor auf den angegebenen Host hochgeladen wurde.

patch-upload

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

Laden Sie eine Patch-Datei auf den Host hoch.

PBD-Befehle

Befehle für die Arbeit mit PBDs (Physische Blockgeräte). PBDs sind die Softwareobjekte, über die der XenServer-Host auf Speicher-Repositories (SRs) zugreift.

Die PBD-Objekte können mit dem Standardbefehl zur Objektlistung (xe pbd-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Befehle für Parameter auf niedriger Ebene

PBD-Parameter

PBDs haben die folgenden Parameter:

pbd-create

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

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

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

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

pbd-destroy

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

Zerstören Sie die angegebene PBD.

pbd-plug

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

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

pbd-unplug

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

Versuchen Sie, die PBD vom XenServer-Host zu trennen.

PIF-Befehle

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

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

PIF-Parameter

PIFs haben die folgenden Parameter:

Hinweis:

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

pif-forget

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

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

pif-introduce

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

Erstellt ein PIF-Objekt, das eine physische Schnittstelle auf dem angegebenen XenServer-Host darstellt.

pif-plug

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

Versucht, die angegebene physische Schnittstelle hochzufahren.

pif-reconfigure-ip

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

Ändern Sie die IP-Adresse des PIF. Für eine statische IP-Konfiguration setzen Sie den Parameter mode auf static, wobei die Parameter gateway, IP und netmask auf die entsprechenden Werte gesetzt werden. Um DHCP zu verwenden, setzen Sie den Parameter mode auf DHCP und lassen Sie die statischen Parameter undefiniert.

Hinweis:

Die Verwendung statischer IP-Adressen auf physischen Netzwerkschnittstellen, die mit einem Port an einem Switch verbunden sind, der das Spanning Tree Protocol mit deaktiviertem (oder nicht unterstütztem) STP Fast Link verwendet, führt zu einer Zeitspanne, in der kein Datenverkehr stattfindet.

pif-reconfigure-ipv6

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

Konfiguriert die IPv6-Adresseinstellungen auf einem PIF neu.

pif-scan

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

Suchen Sie auf Ihrem XenServer-Host nach neuen physischen Schnittstellen.

pif-set-primary-address-type

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

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

pif-unplug

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

Versuchen Sie, die angegebene physische Schnittstelle herunterzufahren.

Pool-Befehle

Befehle für die Arbeit mit Pools. Ein Pool ist ein Aggregat aus einem oder mehreren XenServer-Hosts. Ein Pool verwendet einen oder mehrere gemeinsam genutzte Speicher-Repositories, sodass die auf einem Host im Pool ausgeführten VMs in nahezu Echtzeit auf einen anderen Host im Pool migriert werden können. Diese Migration erfolgt, während die VM noch läuft, ohne dass sie heruntergefahren und neu gestartet werden muss.

Jeder XenServer-Host ist standardmäßig ein Pool, der aus einem einzigen Mitglied besteht. Wenn Ihr XenServer-Host einem Pool beigetreten ist, wird er als Mitglied bezeichnet. Wenn der Pool, dem der Host beigetreten ist, aus einem einzigen Mitglied besteht, wird dieses Mitglied zum Pool-Koordinator. Wenn der Pool, dem der Host beigetreten ist, bereits mehrere Mitglieder hat, ist eines dieser Mitglieder bereits der Pool-Koordinator und bleibt dies auch, wenn der neue Host dem Pool beitritt.

Das Singleton-Pool-Objekt kann mit dem Standardbefehl zur Objektlistung (xe pool-list) aufgelistet werden. Seine Parameter können mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

Pool-Parameter

Pools haben die folgenden Parameter:

pool-apply-edition

xe pool-apply-edition edition=cloud|standard-per-socket|premium-per-socket [uuid=uuid] [license-server-address=address] [license-server-port=port]
<!--NeedCopy-->

Eine Edition auf den gesamten Pool anwenden. Editionswerte umfassen „cloud“, „standard-per-socket“ und „premium-per-socket“. Zukünftig wird nur „cloud“ unterstützt.

pool-certificate-install

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

Ein TLS-Zertifikat poolweit installieren.

pool-certificate-list

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

Alle installierten TLS-Zertifikate in einem Pool auflisten.

pool-certificate-sync

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

TLS-Zertifikate und Zertifikatsperrlisten vom Pool-Koordinator mit den anderen Pool-Mitgliedern synchronisieren.

pool-certificate-uninstall

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

Ein TLS-Zertifikat deinstallieren.

pool-crl-install

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

Eine TLS-Zertifikatsperrliste poolweit installieren.

pool-crl-list

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

Alle installierten TLS-Zertifikatsperrlisten auflisten.

pool-crl-uninstall

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

Eine TLS-Zertifikatsperrliste deinstallieren.

pool-deconfigure-wlb

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

Die Konfiguration für den Workload-Ausgleich dauerhaft entfernen.

pool-designate-new-master

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

Weisen Sie den angegebenen XenServer-Mitgliedshost an, der Koordinator (früher „Master“ genannt) eines vorhandenen Pools zu werden. Dieser Befehl führt eine geordnete Übergabe der Rolle des Pool-Koordinators an einen anderen Host im Ressourcenpool durch. Dieser Befehl funktioniert nur, wenn der aktuelle Pool-Koordinator online ist. Er ist kein Ersatz für die unten aufgeführten Notfallmodus-Befehle.

pool-disable-external-auth

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

Deaktiviert die externe Authentifizierung auf allen Hosts in einem Pool.

pool-disable-local-storage-caching

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

Deaktivieren Sie das lokale Speichercaching im gesamten Pool.

pool-disable-redo-log

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

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

pool-dump-database

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

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

pool-enable-external-auth

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

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

pool-enable-local-storage-caching

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

Aktivieren Sie das lokale Speichercaching im gesamten Pool.

pool-enable-redo-log

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

Aktivieren Sie das Redo-Log auf dem angegebenen SR, falls es verwendet wird, es sei denn, HA ist aktiviert.

pool-eject

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

Weisen Sie den angegebenen XenServer-Host an, einen vorhandenen Pool zu verlassen.

pool-emergency-reset-master

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

Weisen Sie einen Pool-Mitgliedshost an, seine Pool-Koordinatoradresse auf den neuen Wert zurückzusetzen und zu versuchen, eine Verbindung herzustellen. Führen Sie diesen Befehl nicht auf Pool-Koordinatoren aus.

pool-emergency-transition-to-master

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

Weisen Sie einen XenServer-Mitgliedshost an, der Pool-Koordinator (früher „Pool-Master“ genannt) zu werden. Der XenServer-Host akzeptiert diesen Befehl nur, nachdem der Host in den Notfallmodus gewechselt ist. Notfallmodus bedeutet, dass er Mitglied eines Pools ist, dessen Koordinator aus dem Netzwerk verschwunden ist und nach mehreren Wiederholungsversuchen nicht kontaktiert werden kann.

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

pool-ha-enable

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

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

pool-ha-disable

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

Deaktiviert die Hochverfügbarkeitsfunktion auf dem Ressourcenpool.

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

Berechnen Sie die maximale Anzahl von Host-Ausfällen, die unter der aktuellen Pool-Konfiguration toleriert werden können.

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

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

Berechnen Sie die maximale Anzahl von Host-Ausfällen, die mit den bereitgestellten, vorgeschlagenen geschützten VMs toleriert werden können.

pool-initialize-wlb

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

Initialisieren Sie den Lastausgleich für den aktuellen Pool mit dem Ziel-Workload-Balancing-Server.

pool-join

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

Weisen Sie Ihren XenServer-Host an, einem vorhandenen Pool beizutreten.

pool-management-reconfigure

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

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

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

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

Warnung:

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

pool-recover-slaves

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

Weisen Sie den Pool-Koordinator an, zu versuchen, die Adresse aller Mitglieder zurückzusetzen, die sich derzeit im Notfallmodus befinden. Dieser Befehl wird typischerweise verwendet, nachdem pool-emergency-transition-to-master verwendet wurde, um eines der Mitglieder als neuen Pool-Koordinator festzulegen.

pool-restore-database

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

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

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

pool-retrieve-wlb-configuration

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

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

pool-retrieve-wlb-diagnostics

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

Ruft Diagnosedaten vom Workload Balancing-Server ab.

pool-retrieve-wlb-recommendations

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

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

pool-retrieve-wlb-report

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

Ruft Berichte vom Workload Balancing-Server ab.

pool-secret-rotate

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

Rotieren Sie das Pool-Geheimnis.

Das Pool-Geheimnis ist ein Geheimnis, das unter den XenServer-Hosts in einem Pool geteilt wird und es dem Host ermöglicht, seine Zugehörigkeit zu einem Pool nachzuweisen. Benutzer mit der Rolle Pool-Administrator können dieses Geheimnis sehen, wenn sie sich über SSH mit dem Host verbinden. Rotieren Sie das Pool-Geheimnis, wenn einer dieser Benutzer Ihr Unternehmen verlässt oder seine Rolle als Pool-Administrator verliert.

pool-send-test-post

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

Senden Sie den angegebenen Body an den angegebenen Host und Port, unter Verwendung von HTTPS, und geben Sie die Antwort aus. Dies wird zum Debuggen der TLS-Schicht verwendet.

pool-send-wlb-configuration

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

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

pool-sync-database

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

Erzwingen Sie die Synchronisierung der Pooldatenbank auf allen Hosts im Ressourcenpool. Dieser Befehl ist im Normalbetrieb nicht erforderlich, da die Datenbank regelmäßig automatisch repliziert wird. Der Befehl kann jedoch nützlich sein, um sicherzustellen, dass Änderungen nach der Durchführung einer Reihe wichtiger CLI-Operationen schnell repliziert werden.

Festlegen https-only

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

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

PVS-Beschleuniger-Befehle

Befehle für die Arbeit mit dem PVS-Beschleuniger.

pvs-cache-storage-create

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

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

pvs-cache-storage-destroy

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

Entfernen Sie einen PVS-Cache.

pvs-proxy-create

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

Konfigurieren Sie eine VM/VIF zur Verwendung eines PVS-Proxys.

pvs-proxy-destroy

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

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

pvs-server-forget

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

PVS-Server vergessen.

pvs-server-introduce

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

Neuen PVS-Server einführen.

pvs-site-forget

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

PVS-Site vergessen.

pvs-site-introduce

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

Neue PVS-Site einführen.

Storage Manager-Befehle

Befehle zur Steuerung von Storage Manager-Plug-Ins.

Die Storage Manager-Objekte können mit dem Standardbefehl zur Objektlistung (xe sm-list) aufgelistet werden. Die Parameter können mit den Standard-Parameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-level parameter commands

SM-Parameter

SMs haben die folgenden Parameter:

SSH-Zugriff auf Hosts und Pools verwalten

Übersicht

In XenServer 8.4 ist der SSH-Zugriff auf dom0 jetzt standardmäßig aktiviert. Diese Version führt die Möglichkeit ein, den SSH-Zugriff programmatisch entweder über die XenAPI oder die Befehlszeilenschnittstelle (CLI) von xe zu steuern.

Diese Verbesserung ermöglicht es Administratoren, den SSH-Zugriff sowohl auf einzelnen Hosts als auch auf gesamten Pools zu verwalten, wodurch die manuelle Interaktion mit jeder Serverkonsole entfällt.

Vorteile

• Automatisierte Verwaltung: SSH auf einzelnen Hosts oder über einen gesamten Pool programmatisch aktivieren oder deaktivieren.

• Reduzierter Verwaltungsaufwand: Der manuelle Verwaltungsaufwand für die Verwaltung des SSH-Zugriffs wird erheblich reduziert.

• Verbesserte Workflows: Automatisierungsskripte verbessern und Sicherheits-Workflows stärken, indem die SSH-Steuerung in bestehende Verwaltungssysteme integriert wird.

Kompatibilität und Einschränkungen

• Keine zusätzlichen Anforderungen: Diese Funktion erfordert keine zusätzliche Konfiguration oder spezifische Kompatibilitätsanpassungen.

• Dienstverhalten: Das Deaktivieren von SSH stoppt und deaktiviert den sshd-Dienst auf dem/den angegebenen Host(s).

• Bestehende Sitzungen: Alle bestehenden SSH-Sitzungen bleiben auch nach dem Deaktivieren des Dienstes aktiv und ununterbrochen.

• Neue Verbindungen: Neue Verbindungsversuche werden abgelehnt, sobald SSH deaktiviert ist.

• Poolweite Operationen: Operationen, die über einen gesamten Pool hinweg ausgeführt werden, werden fortgesetzt, auch wenn ein oder mehrere Hosts innerhalb des Pools einen Fehler aufweisen.

Es wird eine Zusammenfassungsnachricht bereitgestellt, die alle fehlgeschlagenen Operationen detailliert.

CLI-Konfiguration

SSH auf einem Host aktivieren

xe host-enable-ssh host=<host_uuid_or_name_label>
<!--NeedCopy-->

Dieser Befehl startet und aktiviert den sshd Dienst auf dem angegebenen Host. Gültige host Selektoren finden Sie unter Host-Selektoren .

SSH auf einem Host deaktivieren

xe host-disable-ssh host=<host_uuid_or_name_label>
<!--NeedCopy-->

Dieser Befehl stoppt und deaktiviert den sshd-Dienst auf dem angegebenen Host.

SSH auf allen Hosts in einem Pool aktivieren

xe pool-enable-ssh
<!--NeedCopy-->

Dieser Befehl startet und aktiviert den sshd-Dienst auf allen Hosts im aktuellen Pool.

SSH auf allen Hosts in einem Pool deaktivieren

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

Dieser Befehl stoppt und deaktiviert den sshd-Dienst auf allen Hosts im aktuellen Pool.

Beispielausgabe (Operation auf Poolebene)

xe pool-enable-ssh

Some of hosts failed to enable SSH access.
hosts: d734ff47-f429-4bd4-93f7-245cffbdc79e (genus-35-003d)
<!--NeedCopy-->

Wenn ein Host ausfällt, verarbeitet der Befehl die verbleibenden Hosts weiter und meldet Fehler am Ende.

Snapshot-Befehle

Befehle für die Arbeit mit Snapshots.

snapshot-clone

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

Erstellen Sie eine neue Vorlage durch Klonen eines vorhandenen Snapshots, wobei, falls verfügbar, ein schneller Festplattenklonvorgang auf Speicherebene verwendet wird.

snapshot-copy

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

Erstellen Sie eine neue Vorlage, indem Sie eine vorhandene VM kopieren, jedoch ohne die schnelle Datenträger-Klonoperation auf Speicherebene zu verwenden (selbst wenn diese verfügbar ist). Die Datenträger-Images der kopierten VM sind garantiert ‘vollständige Images’ – d.h. sie sind nicht Teil einer CoW-Kette.

snapshot-destroy

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

Zerstören Sie einen Snapshot. Dadurch bleibt der mit dem Snapshot verbundene Speicher intakt. Um auch den Speicher zu löschen, verwenden Sie snapshot-uninstall.

snapshot-disk-list

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

Listen Sie die Datenträger auf der/den ausgewählten VM(s) auf.

snapshot-export-to-template

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

Exportieren Sie einen Snapshot in die Datei Dateiname.

snapshot-reset-powerstate

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

Erzwingen Sie den VM-Stromzustand auf ‘angehalten’ nur in der Management-Toolstack-Datenbank. Dieser Befehl wird verwendet, um einen Snapshot wiederherzustellen, der als ‘angehalten’ markiert ist. Dies ist ein potenziell gefährlicher Vorgang: Sie müssen sicherstellen, dass Sie das Speicher-Image nicht mehr benötigen. Sie können Ihren Snapshot danach nicht mehr fortsetzen.

snapshot-revert

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

Setzen Sie eine vorhandene VM auf einen früheren Checkpoint- oder Snapshot-Zustand zurück.

snapshot-uninstall

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

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

SR-Befehle

Befehle zum Steuern von SRs (Speicher-Repositories).

Die SR-Objekte können mit dem Standardbefehl zur Objektlistung (xe sr-list) aufgelistet und ihre Parameter mit den Standard-Parameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Low-level-Parameterbefehle.

SR-Parameter

SRs haben die folgenden Parameter:

sr-create

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

Erstellt einen SR auf der Festplatte, führt ihn in die Datenbank ein und erstellt eine PBD, die den SR mit dem XenServer-Host verbindet. Wenn shared auf true gesetzt ist, wird für jeden XenServer-Host im Pool eine PBD erstellt. Wenn shared nicht angegeben oder auf false gesetzt ist, wird eine PBD nur für den mit host-uuid angegebenen XenServer-Host erstellt.

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

sr-data-source-forget

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

Beendet die Aufzeichnung der angegebenen Datenquelle für ein SR und löscht alle aufgezeichneten Daten.

sr-data-source-list

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

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

sr-data-source-query

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

Fragt den zuletzt gelesenen Wert aus einer SR-Datenquelle ab.

sr-data-source-record

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

Zeichnet die angegebene Datenquelle für ein SR auf.

sr-destroy

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

Zerstört das angegebene SR auf dem XenServer-Host.

sr-enable-database-replication

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

Aktiviert die XAPI-Datenbankreplikation auf das angegebene (freigegebene) SR.

sr-disable-database-replication

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

Deaktiviert die XAPI-Datenbankreplikation auf das angegebene SR.

sr-forget

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

Der XAPI-Agent vergisst einen angegebenen SR auf dem XenServer-Host. Wenn der XAPI-Agent einen SR vergisst, wird der SR getrennt und Sie können nicht auf VDIs darauf zugreifen, aber er bleibt auf dem Quellmedium intakt (die Daten gehen nicht verloren).

sr-introduce

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

Fügt lediglich einen SR-Eintrag in die Datenbank ein. Verwenden Sie device-config, um zusätzliche Parameter in der Form device-config:parameter_key=parameter_value anzugeben, zum Beispiel:

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

Hinweis:

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

sr-probe

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

Führt einen Scan des Backends durch, wobei die bereitgestellten device-config Schlüssel verwendet werden. Wenn die device-config für das SR-Backend vollständig ist, gibt dieser Befehl eine Liste der auf dem Gerät vorhandenen SRs zurück, falls vorhanden. Wenn die device-config Parameter nur teilweise vorhanden sind, wird ein Backend-spezifischer Scan durchgeführt, der Ergebnisse liefert, die Sie bei der Verbesserung der verbleibenden device-config Parameter anleiten. Die Scan-Ergebnisse werden als Backend-spezifisches XML zurückgegeben und auf der CLI ausgegeben.

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

sr-probe-ext

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

Führt eine Speicherprüfung durch. Die device-config-Parameter können beispielsweise durch device-config:devs=/dev/sdb1 angegeben werden. Im Gegensatz zu sr-probe gibt dieser Befehl Ergebnisse im selben menschenlesbaren Format für jeden SR-Typ zurück.

sr-scan

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

Erzwingt einen SR-Scan, der die XAPI-Datenbank mit den im zugrunde liegenden Speichersubstrat vorhandenen VDIs synchronisiert.

sr-update

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

Aktualisiert die Felder des SR-Objekts in der Datenbank.

lvhd-enable-thin-provisioning

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

Aktivieren Sie Thin Provisioning auf einem LVHD SR.

Subjekt-Befehle

Befehle für die Arbeit mit Subjekten.

session-subject-identifier-list

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

Gibt eine Liste aller Benutzer-Subjekt-IDs aller extern authentifizierten bestehenden Sitzungen zurück.

session-subject-identifier-logout

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

Meldet alle extern authentifizierten Sitzungen ab, die einer Benutzer-Subjekt-ID zugeordnet sind.

session-subject-identifier-logout-all

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

Meldet alle extern authentifizierten Sitzungen ab.

subject-add

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

Fügt ein Subjekt zur Liste der Subjekte hinzu, die auf den Pool zugreifen können.

subject-remove

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

Entfernt ein Subjekt aus der Liste der Subjekte, die auf den Pool zugreifen können.

subject-role-add

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

Fügen Sie einem Subjekt eine Rolle hinzu.

subject-role-remove

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

Entfernen Sie eine Rolle von einem Subjekt.

secret-create

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

Erstellen Sie ein Geheimnis.

secret-destroy

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

Zerstören Sie ein Geheimnis.

Aufgabenbefehle

Befehle für die Arbeit mit langlaufenden asynchronen Aufgaben. Diese Befehle sind Aufgaben wie das Starten, Stoppen und Anhalten einer virtuellen Maschine. Die Aufgaben bestehen typischerweise aus einer Reihe anderer atomarer Unteraufgaben, die zusammen die angeforderte Operation ausführen.

Die Aufgabenobjekte können mit dem Standardbefehl zur Objektlistung (xe task-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

Aufgabenparameter

Aufgaben haben die folgenden Parameter:

task-cancel

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

Weist die angegebene Aufgabe an, abzubrechen und zurückzukehren.

Vorlagenbefehle

Befehle für die Arbeit mit VM-Vorlagen.

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

Die Vorlagenobjekte können mit dem Standardbefehl zur Objektlistung (xe template-list) aufgelistet und die Parameter mit den Standardparameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Befehle für Low-Level-Parameter

Hinweis:

Vorlagen können nicht direkt in VMs umgewandelt werden, indem der Parameter is-a-template auf false gesetzt wird. Das Setzen des Parameters is-a-template auf false wird nicht unterstützt und führt zu einer VM, die nicht gestartet werden kann.

VM-Vorlagenparameter

Vorlagen haben die folgenden Parameter:

• uuid (schreibgeschützt) der eindeutige Bezeichner/Objektreferenz für die Vorlage
• name-label (Lese-/Schreibzugriff) der Name der Vorlage
• name-description (Lese-/Schreibzugriff) die Beschreibungszeichenfolge der Vorlage
• user-version (Lese-/Schreibzugriff) Zeichenfolge für Ersteller von VMs und Vorlagen zur Angabe von Versionsinformationen

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

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

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

• is-control-domain (schreibgeschützt) true, wenn dies eine Kontrolldomäne ist (Domäne 0 oder eine Treiberdomäne)
• power-state (schreibgeschützt) aktueller Energiezustand. Der Wert ist für eine Vorlage immer angehalten.
• memory-dynamic-max (schreibgeschützt) dynamischer maximaler Speicher in Bytes. Derzeit ungenutzt, 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 ungenutzt, aber wenn geändert, müssen die gleichen Einschränkungen für memory-dynamic-max beachtet werden.
• memory-static-max (Lese-/Schreibzugriff) statisch festgelegter (absoluter) maximaler Speicher in Bytes. Dieses Feld ist der Hauptwert, der zur Bestimmung der einer VM zugewiesenen Speichermenge verwendet wird.
• memory-static-min (Lese-/Schreibzugriff) statisch festgelegter (absoluter) Mindestspeicher in Bytes. Dieses Feld stellt den absoluten Mindestspeicher dar, und memory-static-min muss kleiner sein als memory-static-max. Dieser Wert wird im Normalbetrieb nicht verwendet, aber die vorherige Einschränkung muss beachtet werden.
• suspend-VDI-uuid (schreibgeschützt) die VDI, auf der ein Suspend-Image gespeichert ist (hat keine Bedeutung für eine Vorlage)
• VCPUs-params (Lese-/Schreib-Map-Parameter) Konfigurationsparameter für die ausgewählte vCPU-Richtlinie.
• VCPUs-max (Lese-/Schreibzugriff) maximale Anzahl von vCPUs
• VCPUs-at-startup (Lese-/Schreibzugriff) Startanzahl von vCPUs
• actions-after-crash (Lese-/Schreibzugriff) Aktion, die ausgeführt werden soll, wenn eine auf dieser Vorlage basierende VM abstürzt
• console-uuids (schreibgeschützter Set-Parameter) virtuelle Konsolengeräte

• platform (Lese-/Schreib-Map-Parameter) plattformspezifische Konfiguration

  So deaktivieren Sie die Emulation eines parallelen Ports für Gäste:

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

  So deaktivieren Sie die Emulation eines seriellen Ports:

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

  So deaktivieren Sie die Emulation eines USB-Controllers und eines USB-Tablet-Geräts:

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

• allowed-operations (schreibgeschützter Set-Parameter) Liste der in diesem Zustand zulässigen Operationen
• current-operations (Nur-Lese-Satzparameter) Liste der Operationen, die derzeit für diese Vorlage ausgeführt werden
• allowed-VBD-devices (Nur-Lese-Satzparameter) Liste der verfügbaren VBD-Bezeichner, dargestellt durch Ganzzahlen im Bereich von 0–254. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
• allowed-VIF-devices (Nur-Lese-Satzparameter) Liste der verfügbaren VIF-Bezeichner, dargestellt durch Ganzzahlen im Bereich von 0–6. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
• HVM-boot-policy (Lese-/Schreibzugriff) die Startrichtlinie für Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge.
• HVM-boot-params (Lese-/Schreib-Map-Parameter) der Reihenfolgeschlüssel steuert die Startreihenfolge des Gastes, dargestellt als Zeichenfolge, wobei jedes Zeichen eine Startmethode ist: d für die CD/DVD, c für die Root-Festplatte 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-/Schreibzugriff) Zeichenfolge von Kernel-Befehlszeilenargumenten
• PV-legacy-args (Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um Legacy-VMs, die auf dieser Vorlage basieren, zu starten
• PV-bootloader (Lese-/Schreibzugriff) Name oder Pfad des Bootloaders
• PV-bootloader-args (Lese-/Schreibzugriff) Zeichenfolge von verschiedenen Argumenten für den Bootloader
• last-boot-CPU-flags (Nur-Lese-Zugriff) beschreibt die CPU-Flags, mit denen eine auf dieser Vorlage basierende VM zuletzt gestartet wurde; nicht für eine Vorlage ausgefüllt
• resident-on (Nur-Lese-Zugriff) der XenServer-Host, auf dem eine auf dieser Vorlage basierende VM resident ist. Wird als not in database für eine Vorlage angezeigt
• affinity (Lese-/Schreibzugriff) der XenServer-Host, auf dem eine auf dieser Vorlage basierende VM bevorzugt ausgeführt wird. Wird vom xe vm-start-Befehl verwendet, um zu entscheiden, wo die VM ausgeführt werden soll. Auch als Home-Server bekannt.
• groups (Lese-/Schreibzugriff) die VM-Gruppe, zu der diese VM gehört. Eine VM-Gruppe definiert, wo XenServer versucht, die VM zu starten oder zu evakuieren.
• other-config (Lese-/Schreib-Map-Parameter) Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die Vorlage angeben
• start-time (nur lesbar) Zeitstempel des Datums und der Uhrzeit, zu dem die Metriken für eine auf dieser Vorlage basierende VM gelesen wurden, in der Form yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC(GMT). Für eine Vorlage auf 1 Jan 1970 Z (Beginn der Unix/POSIX-Epoche) gesetzt
• install-time (nur lesbar) Zeitstempel des Datums und der Uhrzeit, zu dem die Metriken für eine auf dieser Vorlage basierende VM gelesen wurden, in der Form yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC (GMT). Für eine Vorlage auf 1 Jan 1970 Z (Beginn der Unix/POSIX-Epoche) gesetzt
• memory-actual (nur lesbar) der tatsächlich von einer auf dieser Vorlage basierenden VM verwendete Arbeitsspeicher; 0 für eine Vorlage
• VCPUs-number (nur lesbar) die Anzahl der virtuellen CPUs, die einer auf dieser Vorlage basierenden VM zugewiesen sind; 0 für eine Vorlage
• VCPUs-Utilization (Nur-Lese-Map-Parameter) Liste der virtuellen CPUs und deren Gewicht Nur-Lese-Map-Parameter os-version die Version des Betriebssystems für eine auf dieser Vorlage basierende VM. Erscheint als not in database für eine Vorlage
• PV-drivers-version (Nur-Lese-Map-Parameter) die Versionen der paravirtualisierten Treiber für eine auf dieser Vorlage basierende VM. Erscheint als not in database für eine Vorlage
• PV-drivers-detected (nur lesbar) Flag für die neueste Version der paravirtualisierten Treiber für eine auf dieser Vorlage basierende VM. Erscheint als not in database für eine Vorlage
• memory (Nur-Lese-Map-Parameter) Speichermetriken, die vom Agenten auf einer auf dieser Vorlage basierenden VM gemeldet werden. Erscheint als not in database für eine Vorlage
• disks (Nur-Lese-Map-Parameter) Festplattenmetriken, die vom Agenten auf einer auf dieser Vorlage basierenden VM gemeldet werden. Erscheint als not in database für eine Vorlage
• networks (Nur-Lese-Map-Parameter) Netzwerkmetriken, die vom Agenten auf einer auf dieser Vorlage basierenden VM gemeldet werden. Erscheint als not in database für eine Vorlage
• other (Nur-Lese-Map-Parameter) andere Metriken, die vom Agenten auf einer auf dieser Vorlage basierenden VM gemeldet werden. Erscheint als not in database für eine Vorlage
• guest-metrics-last-updated (nur lesbar) Zeitstempel, wann der In-Guest-Agent die letzte Schreiboperation auf diese Felder durchgeführt hat. In der Form yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC (GMT)
• actions-after-shutdown (Lese-/Schreibzugriff) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
• actions-after-reboot (Lese-/Schreibzugriff) Aktion, die nach dem Neustart der VM ausgeführt werden soll
• possible-hosts (schreibgeschützt) Liste der Hosts, die die VM potenziell hosten können
• HVM-shadow-multiplier (Lese-/Schreibzugriff) Multiplikator, der auf die Menge des Schattens angewendet wird, die dem Gast zur Verfügung gestellt wird
• dom-id (schreibgeschützt) Domänen-ID (falls verfügbar, sonst -1)
• recommendations (schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
• xenstore-data (Lese-/Schreib-Map-Parameter) Daten, die nach dem Erstellen der VM in den xenstore Baum (/local/domain/*domid*/vmdata) eingefügt werden sollen.
• is-a-snapshot (schreibgeschützt) Der Wert ist wahr, wenn diese Vorlage ein VM-Snapshot ist
• snapshot_of (schreibgeschützt) die UUID der VM, von der diese Vorlage ein Snapshot ist
• snapshots (schreibgeschützt) die UUIDs aller Snapshots, die von dieser Vorlage erstellt wurden
• snapshot_time (schreibgeschützt) der Zeitstempel des zuletzt erstellten VM-Snapshots
• memory-target (schreibgeschützt) die für diese Vorlage festgelegte Zielspeichermenge
• blocked-operations (Lese-/Schreib-Map-Parameter) listet die Operationen auf, die für diese Vorlage nicht ausgeführt werden können
• last-boot-record (schreibgeschützt) Aufzeichnung der letzten Boot-Parameter für diese Vorlage, im XML-Format
• ha-always-run (Lese-/Schreibzugriff) Der Wert ist wahr, wenn eine Instanz dieser Vorlage immer auf einem anderen Host neu gestartet wird, falls der Host, auf dem sie sich befindet, ausfällt. 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ärdatenspeicher
• live (schreibgeschützt) nur für eine laufende VM relevant.

template-export

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

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

template-uninstall

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

Deinstallieren Sie eine benutzerdefinierte Vorlage. Dieser Vorgang zerstört die VDIs, die als „im Besitz“ dieser Vorlage markiert sind.

Update-Befehle

Der folgende Abschnitt enthält XenServer Host-Update-Befehle.

Die Update-Objekte können mit dem Standardbefehl zur Objektlistung (xe update-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

Update-Parameter

XenServer Host-Updates haben die folgenden Parameter:

update-upload

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

Laden Sie eine angegebene Update-Datei auf den XenServer-Host hoch. Dieser Befehl bereitet ein Update zur Anwendung vor. Bei Erfolg wird die UUID des hochgeladenen Updates ausgegeben. Wenn das Update bereits hochgeladen wurde, wird stattdessen ein UPDATE_ALREADY_EXISTS Fehler zurückgegeben und der Patch wird nicht erneut hochgeladen.

update-precheck

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

Führen Sie die in dem angegebenen Update enthaltenen Vorabprüfungen auf dem angegebenen XenServer-Host aus.

update-destroy

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

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

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

Wendet die angegebene Updatedatei an.

update-pool-apply

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

Wendet das angegebene Update auf alle XenServer-Hosts im Pool an.

update-introduce

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

Update-VDI einführen.

update-pool-clean

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

Entfernt die Updatedateien von allen Hosts im Pool.

Benutzerbefehle

user-password-change

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

Ändert das Passwort des angemeldeten Benutzers. Das Feld für das alte Passwort wird nicht überprüft, da Sie zur Verwendung dieses Befehls Supervisor-Berechtigungen benötigen.

VBD-Befehle

Befehle für die Arbeit mit VBDs (Virtual Block Devices).

Ein VBD ist ein Softwareobjekt, das eine VM mit dem VDI verbindet, das den Inhalt der virtuellen Festplatte darstellt. Das VBD verfügt über die Attribute, die das VDI an die VM binden (ist es bootfähig, seine Lese-/Schreibmetriken usw.). Das VDI enthält die Informationen zu den physikalischen Attributen der virtuellen Festplatte (welcher SR-Typ, ob die Festplatte gemeinsam nutzbar ist, ob das Medium Lese-/Schreibzugriff oder nur Lesezugriff hat usw.).

Die VBD-Objekte können mit dem Standardbefehl zur Objektlistung (xe vbd-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

VBD-Parameter

VBDs haben die folgenden Parameter:

vbd-create

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

Erstellen Sie eine VBD auf einer VM.

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

Wenn type Disk ist, ist vdi-uuid erforderlich. Der Modus kann RO oder RW für eine Festplatte sein.

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

vbd-destroy

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

Zerstören Sie die angegebene VBD.

Wenn der Parameter other-config:owner der VBD auf true gesetzt ist, wird die zugehörige VDI ebenfalls zerstört.

vbd-eject

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

Entfernen Sie die Medien aus dem Laufwerk, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn die Medien von einem entfernbaren Typ sind (eine physische CD oder eine ISO). Andernfalls wird eine Fehlermeldung VBD_NOT_REMOVABLE_MEDIA zurückgegeben.

vbd-insert

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

Legen Sie neue Medien in das Laufwerk ein, das durch eine VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn die Medien von einem entfernbaren Typ sind (eine physische CD oder ein ISO). Andernfalls wird eine Fehlermeldung VBD_NOT_REMOVABLE_MEDIA zurückgegeben.

vbd-plug

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

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

vbd-unplug

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

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

VDI-Befehle

Befehle für die Arbeit mit VDIs (virtuellen Festplatten-Images).

Ein VDI ist ein Softwareobjekt, das den Inhalt der virtuellen Festplatte darstellt, die von einer VM gesehen wird. Dies unterscheidet sich von der VBD, die ein Objekt ist, das eine VM an das VDI bindet. Das VDI enthält Informationen zu den physischen Attributen der virtuellen Festplatte (welcher SR-Typ, ob die Festplatte gemeinsam genutzt werden kann, ob die Medien Lese-/Schreib- oder Nur-Lese-Zugriff haben usw.). Die VBD enthält die Attribute, die das VDI an die VM binden (ist es bootfähig, seine Lese-/Schreibmetriken usw.).

Die VDI-Objekte können mit dem Standardbefehl zur Objektlistung (xe vdi-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

VDI-Parameter

VDIs haben die folgenden Parameter:

vdi-clone

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

Erstellen Sie eine neue, beschreibbare Kopie des angegebenen VDI, die direkt verwendet werden kann. Es ist eine Variante von vdi-copy, die Hochgeschwindigkeits-Image-Klonfunktionen bereitstellen kann, wo diese vorhanden sind.

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

vdi-copy

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

Kopieren Sie eine VDI auf einen angegebenen SR.

vdi-create

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

Erstellen Sie eine VDI.

Der Parameter virtual-size kann in Bytes oder unter Verwendung der IEC-Standard-Suffixe KiB, MiB, GiB und TiB angegeben werden.

Hinweis:

SR-Typen, die Thin Provisioning von Datenträgern unterstützen (wie Local VHD und NFS), erzwingen keine virtuelle Zuweisung von Datenträgern. Seien Sie äußerst vorsichtig, wenn Sie virtuellen Speicherplatz auf einem SR überprovisionieren. Wenn ein überprovisionierter SR voll wird, muss Speicherplatz entweder auf dem SR-Zielsubstrat oder durch Löschen ungenutzter VDIs im SR freigegeben werden.

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

vdi-data-destroy

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

Zerstören Sie die mit der angegebenen VDI verbundenen Daten, aber behalten Sie die Metadaten der geänderten Blockverfolgung bei.

Hinweis:

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

vdi-destroy

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

Zerstören Sie die angegebene VDI.

Hinweis:

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

Bei lokalen VHD- und NFS-SR-Typen wird Speicherplatz nicht sofort auf vdi-destroy freigegeben, sondern periodisch während eines Speicher-Repository-Scanvorgangs. Wenn Sie gelöschten Speicherplatz erzwingen müssen, um ihn verfügbar zu machen, rufen Sie sr-scan manuell auf.

vdi-disable-cbt

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

Changed Block Tracking für das VDI deaktivieren.

vdi-enable-cbt

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

Changed Block Tracking für das VDI aktivieren.

Hinweis:

Sie können Changed Block Tracking nur auf lizenzierten Instanzen von XenServer Premium Edition aktivieren.

vdi-export

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

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

• raw
• vhd

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

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

vdi-forget

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

Entfernt bedingungslos einen VDI-Eintrag aus der Datenbank, ohne das Speicher-Backend zu berühren. Im Normalbetrieb verwenden Sie stattdessen vdi-destroy.

vdi-import

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

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

• raw
• vhd

vdi-introduce

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

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

vdi-list-changed-blocks

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

Vergleicht zwei VDIs und gibt die Liste der Blöcke zurück, die sich zwischen den beiden geändert haben, als base64-kodierte Zeichenfolge. Dieser Befehl funktioniert nur für VDIs, bei denen die Änderungsblockverfolgung aktiviert ist.

Weitere Informationen finden Sie unter Geänderte Blockverfolgung.

vdi-pool-migrate

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

Migriert eine VDI zu einem angegebenen SR, während die VDI an einen laufenden Gast angehängt ist. (Speicher-Live-Migration)

Weitere Informationen finden Sie unter VMs migrieren.

vdi-resize

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

Ändert die Größe der VDI, die durch die UUID angegeben ist.

vdi-snapshot

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

Erzeugt eine Lese-/Schreibversion eines VDI, die als Referenz für Sicherungs- oder Vorlagenerstellungszwecke oder beides verwendet werden kann. Verwenden Sie den Snapshot, um eine Sicherung durchzuführen, anstatt Sicherungssoftware in der VM zu installieren und auszuführen. Die VM läuft weiter, während externe Sicherungssoftware den Inhalt des Snapshots auf das Sicherungsmedium streamt. Ähnlich kann ein Snapshot als „Gold-Image“ verwendet werden, auf dem eine Vorlage basiert. Eine Vorlage kann mit beliebigen VDIs erstellt werden.

Verwenden Sie den optionalen driver-params-Map-Parameter, um zusätzliche herstellerspezifische Konfigurationsinformationen an den Backend-Speichertreiber zu übergeben, auf dem das VDI basiert. Weitere Informationen finden Sie in der Dokumentation des Speichertreiberherstellers.

Ein Klon eines Snapshots erzeugt immer ein beschreibbares VDI.

vdi-unlock

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

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

vdi-update

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

Aktualisiert die Felder des VDI-Objekts in der Datenbank.

VIF-Befehle

Befehle zum Arbeiten mit VIFs (virtuellen Netzwerkschnittstellen).

Die VIF-Objekte können mit dem Standardobjektlistungsbefehl (xe vif-list) aufgelistet und die Parameter mit den Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

VIF-Parameter

VIFs haben die folgenden Parameter:

• uuid (schreibgeschützt) der eindeutige Bezeichner/Objektreferenz für das VIF
• vm-uuid (schreibgeschützt) der eindeutige Bezeichner/Objektreferenz für die VM, auf der sich dieses VIF befindet
• vm-name-label (schreibgeschützt) der Name der VM, auf der sich dieses VIF befindet
• allowed-operations (schreibgeschützter Satzparameter) eine Liste der in diesem Zustand zulässigen Operationen
• current-operations (schreibgeschützter Satzparameter) eine Liste der Operationen, die derzeit auf diesem VIF ausgeführt werden
• device (schreibgeschützt) Ganzzahlbezeichnung dieses VIF, die die Reihenfolge angibt, in der die VIF-Back-Ends erstellt wurden
• MAC (schreibgeschützt) MAC-Adresse des VIF, wie sie der VM angezeigt wird

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

  Dieser Parameter ist schreibgeschützt, Sie können die MTU-Einstellung jedoch mit dem Schlüssel mtu über den Kartenparameter other-config überschreiben. Zum Beispiel, um die MTU auf einer virtuellen NIC zurückzusetzen, um Jumbo-Frames zu verwenden:

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

• currently-attached (schreibgeschützt) true, wenn das Gerät angeschlossen ist
• qos_algorithm_type (Lese-/Schreibzugriff) zu verwendender QoS-Algorithmus
• qos_algorithm_params (Lese-/Schreib-Kartenparameter) Parameter für den gewählten QoS-Algorithmus
• qos_supported_algorithms (schreibgeschützter Satzparameter) unterstützte QoS-Algorithmen für dieses VIF
• MAC-autogenerated (schreibgeschützt) Der Wert ist true, wenn die MAC-Adresse des VIF automatisch generiert wurde
• other-config (Lese-/Schreib-Kartenparameter) zusätzliche Konfigurations-key:value-Paare
• other-config:ethtoolrx (Lese-/Schreibzugriff) auf „on“ setzen, um die Empfangs-Prüfsumme zu aktivieren, auf „off“, um sie zu deaktivieren
• other-config:ethtooltx (Lese-/Schreibzugriff) auf „on“ setzen, um die Sende-Prüfsumme zu aktivieren, auf „off“, um sie zu deaktivieren
• other-config:ethtoolsg (Lese-/Schreibzugriff) auf ‘on’ setzen, um Scatter/Gather zu aktivieren, auf ‘off’, um zu deaktivieren
• other-config:ethtooltso (Lese-/Schreibzugriff) auf ‘on’ setzen, um TCP-Segmentierungs-Offload zu aktivieren, auf ‘off’, um zu deaktivieren
• other-config:ethtoolufo (Lese-/Schreibzugriff) auf ‘on’ setzen, um UDP-Fragment-Offload zu aktivieren, auf ‘off’, um zu deaktivieren
• other-config:ethtoolgso (Lese-/Schreibzugriff) auf ‘on’ setzen, um generisches Segmentierungs-Offload zu aktivieren, auf ‘off’, um zu deaktivieren
• other-config:promiscuous (Lese-/Schreibzugriff) auf ‘true’ setzen, damit ein VIF auf der Bridge promiskuitiv ist, sodass es den gesamten Datenverkehr über die Bridge sieht. Nützlich für den Betrieb eines Intrusion Detection Systems (IDS) oder Ähnlichem in einer VM.
• network-uuid (Nur Lesezugriff) der eindeutige Bezeichner/Objektreferenz des virtuellen Netzwerks, mit dem dieses VIF verbunden ist
• network-name-label (Nur Lesezugriff) der beschreibende Name des virtuellen Netzwerks, mit dem dieses VIF verbunden ist
• io_read_kbs (Nur Lesezugriff) durchschnittliche Leserate in kB/s für dieses VIF
• io_write_kbs (Nur Lesezugriff) durchschnittliche Schreibrate in kB/s für dieses VIF
• locking_mode (Lese-/Schreibzugriff) Beeinflusst die Fähigkeit des VIFs, Datenverkehr zu/von einer Liste von MAC- und IP-Adressen zu filtern. Erfordert zusätzliche Parameter.

• locking_mode:default (Lese-/Schreibzugriff) Variiert je nach dem standardmäßigen Sperrmodus für das VIF-Netzwerk.

  Wenn der Standard-Sperrmodus auf disabled gesetzt ist, wendet XenServer eine Filterregel an, sodass das VIF keinen Datenverkehr senden oder empfangen kann. Wenn der Standard-Sperrmodus auf unlocked gesetzt ist, entfernt XenServer alle mit dem VIF verbundenen Filterregeln. Weitere Informationen finden Sie unter Netzwerkbefehle.

• locking_mode:locked (Lese-/Schreibzugriff) Nur Datenverkehr, der an die oder von den angegebenen MAC- und IP-Adressen gesendet wird, ist auf dem VIF erlaubt. Wenn keine IP-Adressen angegeben sind, ist kein Datenverkehr erlaubt.
• locking_mode:unlocked (Lese-/Schreibzugriff) Es werden keine Filter auf den Datenverkehr angewendet, der zum oder vom VIF geht.
• locking_mode:disabled (Lese-/Schreibzugriff) XenServer wendet eine Filterregel an, sodass das VIF den gesamten Datenverkehr verwirft.

vif-create

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

Erstellen Sie ein VIF auf einer VM.

Geeignete Werte für das Feld device sind im Parameter allowed-VIF-devices auf der angegebenen VM aufgeführt. Bevor dort VIFs existieren, sind die erlaubten Werte ganze Zahlen von 0–6.

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

vif-destroy

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

Zerstören Sie ein VIF.

vif-move

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

Verschieben Sie das VIF in ein anderes Netzwerk.

vif-plug

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

Versuchen Sie, das VIF anzuschließen, während sich die VM im laufenden Zustand befindet.

vif-unplug

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

Versucht, das VIF von der VM zu trennen, während diese läuft.

vif-configure-ipv4

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

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

Zum Beispiel:

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

IPv4-Einstellungen wie folgt bereinigen:

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

vif-configure-ipv6

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

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

Zum Beispiel:

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

IPv6-Einstellungen wie folgt bereinigen:

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

VLAN-Befehle

Befehle für die Arbeit mit VLANs (virtuellen Netzwerken). Um virtuelle Schnittstellen aufzulisten und zu bearbeiten, siehe die PIF-Befehle, die einen VLAN-Parameter haben, um anzuzeigen, dass sie ein zugehöriges virtuelles Netzwerk haben. Weitere Informationen finden Sie unter PIF-Befehle. Um beispielsweise VLANs aufzulisten, verwenden Sie xe pif-list.

vlan-create

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

Erstellen Sie ein VLAN auf Ihrem XenServer-Host.

pool-vlan-create

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

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

vlan-destroy

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

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

VM-Befehle

Befehle zur Steuerung von VMs und deren Attributen.

VM-Selektoren

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

Die VM-Objekte können mit dem Standardbefehl zur Objektlistung (xe vm-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen bearbeitet werden. Weitere Informationen finden Sie unter Befehle für Parameter auf niedriger Ebene

VM-Parameter

VMs haben die folgenden Parameter:

Hinweis:

Alle beschreibbaren VM-Parameterwerte können geändert werden, während die VM läuft, aber neue Parameter werden nicht dynamisch angewendet und können erst nach einem Neustart der VM wirksam werden.

• appliance (Lese-/Schreibzugriff) die Appliance/vApp, zu der die VM gehört
• uuid (nur lesbar) der eindeutige Bezeichner/die Objekt-Referenz für die VM
• name-label (Lese-/Schreibzugriff) der Name der VM
• name-description (Lese-/Schreibzugriff) die Beschreibungszeichenfolge der VM
• order (Lese-/Schreibzugriff) für den Start/das Herunterfahren von vApps und für den Start nach einem HA-Failover. VMs mit einem Ordnungswert von 0 (Null) werden zuerst gestartet, dann VMs mit einem Ordnungswert von 1 und so weiter.
• version (nur lesbar) die Häufigkeit, mit der diese VM wiederhergestellt wurde. Wenn Sie eine neue VM mit einer älteren Version überschreiben möchten, rufen Sie vm-recover auf.
• user-version (Lese-/Schreibzugriff) Zeichenfolge für Ersteller von VMs und Vorlagen zur Angabe von Versionsinformationen

• is-a-template (Lese-/Schreibzugriff) Der Wert ist false, es sei denn, diese VM ist eine Vorlage. Vorlagen-VMs können niemals gestartet werden; sie werden nur zum Klonen anderer VMs verwendet. Nachdem dieser Wert auf true gesetzt wurde, kann er nicht mehr auf false zurückgesetzt werden. Vorlagen-VMs können mit diesem Parameter nicht in VMs umgewandelt werden.

  Sie können eine VM mit den folgenden Schritten in eine Vorlage konvertieren:

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

• is-control-domain (schreibgeschützt) Der Wert ist „true“, wenn es sich um eine Steuerdomäne (Domäne 0 oder eine Treiberdomäne) handelt.
• power-state (schreibgeschützt) aktueller Energiezustand
• start-delay (lesen/schreiben) die Verzögerung in Sekunden, die gewartet werden soll, bevor ein Aufruf zum Starten der VM zurückkehrt
• shutdown-delay (lesen/schreiben) die Verzögerung in Sekunden, die gewartet werden soll, bevor ein Aufruf zum Herunterfahren der VM zurückkehrt
• memory-dynamic-max (lesen/schreiben) dynamisches Maximum in Bytes
• memory-dynamic-min (lesen/schreiben) dynamisches Minimum in Bytes
• memory-static-max (lesen/schreiben) statisch festgelegtes (absolutes) Maximum in Bytes. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
• memory-static-min (lesen/schreiben) statisch festgelegtes (absolutes) Minimum in Bytes. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
• suspend-VDI-uuid (schreibgeschützt) die VDI, auf der ein Suspend-Image gespeichert ist
• VCPUs-params (Lese-/Schreib-Map-Parameter) Konfigurationsparameter für die ausgewählte vCPU-Richtlinie.
• VCPUs-max (lesen/schreiben) maximale Anzahl virtueller CPUs.
• VCPUs-at-startup (lesen/schreiben) Startanzahl virtueller CPUs
• actions-after-crash (lesen/schreiben) Aktion, die ausgeführt werden soll, wenn die VM abstürzt. Für PV-Gäste sind folgende Parameter gültig:
  • preserve (nur zur Analyse)
  • coredump_and_restart (Coredump aufzeichnen und VM neu starten)
  • coredump_and_destroy (Coredump aufzeichnen und VM angehalten lassen)
  • restart (kein Coredump und VM neu starten)
  • destroy (kein Coredump und VM angehalten lassen)
• console-uuids (Parameter nur lesbar) virtuelle Konsolengeräte

• platform (Lese-/Schreib-Map-Parameter) plattformspezifische Konfiguration

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

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

  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
   <!--NeedCopy-->
  

  So überprüfen Sie den aktuellen Status:

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

• allowed-operations (Parameter nur lesbar) Liste der in diesem Zustand zulässigen Operationen
• current-operations (Parameter nur lesbar) eine Liste der Operationen, die derzeit auf der VM ausgeführt werden
• allowed-VBD-devices (Parameter nur lesbar) Liste der verfügbaren VBD-Identifikatoren, dargestellt durch ganze Zahlen im Bereich 0–254. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
• allowed-VIF-devices (Parameter nur lesbar) Liste der verfügbaren VIF-Identifikatoren, dargestellt durch ganze Zahlen im Bereich 0–6. Diese Liste dient nur zu Informationszwecken, und andere Geräte können verwendet werden (funktionieren aber möglicherweise nicht).
• HVM-boot-policy (Lese-/Schreibzugriff) die Startrichtlinie für Gäste. Entweder BIOS-Reihenfolge oder eine leere Zeichenfolge.
• HVM-boot-params (Lese-/Schreib-Map-Parameter) der Ordnungsschlüssel steuert die Startreihenfolge des Gastes, dargestellt als Zeichenfolge, wobei jedes Zeichen eine Startmethode ist: d für CD/DVD, c für die Root-Festplatte und n für den Netzwerk-PXE-Start. Der Standardwert ist dc.
• HVM-shadow-multiplier (Lesen/Schreiben) Gleitkommawert, der den Shadow-Speicher-Overhead steuert, der der VM zugewiesen wird. Standardmäßig 1.0 (der Mindestwert), und ändern Sie diesen Wert nur, wenn Sie ein fortgeschrittener Benutzer sind.
• PV-kernel (Lesen/Schreiben) Pfad zum Kernel
• PV-ramdisk (Lesen/Schreiben) Pfad zum initrd
• PV-args (Lesen/Schreiben) Zeichenfolge von Kernel-Befehlszeilenargumenten
• PV-legacy-args (Lesen/Schreiben) Zeichenfolge von Argumenten, um ältere VMs zu starten
• PV-bootloader (Lesen/Schreiben) Name oder Pfad des Bootloaders
• PV-bootloader-args (Lesen/Schreiben) Zeichenfolge von verschiedenen Argumenten für den Bootloader
• last-boot-CPU-flags (Nur Lesen) beschreibt die CPU-Flags, mit denen die VM zuletzt gestartet wurde
• resident-on (Nur Lesen) der XenServer-Host, auf dem eine VM resident ist
• affinity (Lesen/Schreiben) Der XenServer-Host, auf dem die VM bevorzugt ausgeführt wird. Wird vom Befehl xe vm-start verwendet, um zu entscheiden, wo die VM ausgeführt werden soll. Auch als Home-Server bekannt.
• groups (Lesen/Schreiben) die VM-Gruppe, zu der diese VM gehört. Eine VM-Gruppe definiert, wo XenServer versucht, die VM zu starten oder wohin sie evakuiert werden soll.

• other-config (Lesen/Schreiben-Map-Parameter) Eine Liste von Schlüssel-Wert-Paaren, die zusätzliche Konfigurationsparameter für die VM angeben.

  Zum Beispiel fordert das Schlüssel-Wert-Paar other-config auto_poweron: true an, die VM automatisch zu starten, nachdem ein beliebiger Host im Pool gebootet wurde. Sie müssen diesen Parameter auch in der other-config Ihres Pools festlegen. Diese Parameter sind jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restart-priority.

• start-time (Nur Lesen) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat das Format yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC (GMT)
• install-time (Nur Lesen) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für die VM gelesen wurden. Dieser Zeitstempel hat das Format yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, zum Beispiel Z für UTC (GMT)
• memory-actual (schreibgeschützt) der tatsächlich von einer VM verwendete Speicher
• VCPUs-number (schreibgeschützt) die Anzahl der der VM zugewiesenen virtuellen CPUs für eine Linux-VM. Diese Zahl kann von VCPUS-max abweichen und kann ohne Neustart der VM mit dem Befehl vm-vcpu-hotplug geändert werden. Weitere Informationen finden Sie unter vm-vcpu-hotplug. Windows-VMs laufen immer mit der auf VCPUsmax eingestellten Anzahl von vCPUs und müssen neu gestartet werden, um diesen Wert zu ändern. Die Leistung sinkt drastisch, wenn Sie VCPUs-number auf einen Wert setzen, der größer ist als die Anzahl der physischen CPUs auf dem XenServer-Host.
• VCPUs-Utilization (schreibgeschützter Kartenparameter) eine Liste der virtuellen CPUs und deren Gewichtung
• os-version (schreibgeschützter Kartenparameter) die Version des Betriebssystems für die VM
• PV-drivers-version (schreibgeschützter Kartenparameter) die Versionen der paravirtualisierten Treiber für die VM
• PV-drivers-detected (schreibgeschützt) Flag für die neueste Version der paravirtualisierten Treiber für die VM
• memory (schreibgeschützter Kartenparameter) vom Agenten auf der VM gemeldete Speichermetriken
• disks (schreibgeschützter Kartenparameter) vom Agenten auf der VM gemeldete Festplattenmetriken
• networks (schreibgeschützter Kartenparameter) vom Agenten auf der VM gemeldete Netzwerkmetriken
• other (schreibgeschützter Kartenparameter) andere vom Agenten auf der VM gemeldete Metriken
• guest-metrics-lastupdated (schreibgeschützt) Zeitstempel, wann der In-Guest-Agent den letzten Schreibvorgang in diese Felder durchgeführt hat. Der Zeitstempel hat das Format yyyymmddThh:mm:ss z, wobei z der einbuchstabige militärische Zeitzonenindikator ist, z. B. Z für UTC (GMT)
• actions-after-shutdown (lesen/schreiben) Aktion, die nach dem Herunterfahren der VM ausgeführt werden soll
• actions-after-reboot (lesen/schreiben) Aktion, die nach dem Neustart der VM ausgeführt werden soll
• possible-hosts potenzielle Hosts dieser VM (schreibgeschützt)
• dom-id (schreibgeschützt) Domänen-ID (falls verfügbar, sonst -1)
• recommendations (schreibgeschützt) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
• xenstore-data (Lese-/Schreib-Kartenparameter) Daten, die nach der Erstellung der VM in den xenstore Baum (/local/domain/*domid*/vm-data) eingefügt werden sollen
• is-a-snapshot (schreibgeschützt) Der Wert ist wahr, wenn diese VM ein Snapshot ist
• snapshot_of (schreibgeschützt) die UUID der VM, von der dieser Snapshot stammt
• snapshots (schreibgeschützt) die UUIDs aller Snapshots dieser VM
• snapshot_time (schreibgeschützt) der Zeitstempel des Snapshot-Vorgangs, der diesen VM-Snapshot erstellt hat
• memory-target (schreibgeschützt) die für diese VM festgelegte Zielspeichermenge
• blocked-operations (Lese-/Schreib-Kartenparameter) listet die Operationen auf, die auf dieser VM nicht ausgeführt werden können
• last-boot-record (schreibgeschützt) Aufzeichnung der letzten Boot-Parameter für diese Vorlage, im XML-Format
• ha-always-run (Lese-/Schreibzugriff) Der Wert ist wahr, wenn diese VM immer auf einem anderen Host neu gestartet wird, falls der Host, auf dem sie sich befindet, ausfällt. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restart-priority.
• ha-restart-priority (Lese-/Schreibzugriff) Neustart oder Best-Effort
• blobs (schreibgeschützt) binärer Datenspeicher
• live (schreibgeschützt) Der Wert ist wahr, wenn die VM läuft. Der Wert ist falsch, wenn HA vermutet, dass die VM nicht läuft.

vm-assert-can-be-recovered

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

Prüft, ob Speicher zur Wiederherstellung dieser VM verfügbar ist.

vm-call-plugin

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

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

vm-cd-add

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

Fügt der ausgewählten VM eine neue virtuelle CD hinzu. Wählen Sie den Parameter device von 0–3 aus.

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

vm-cd-eject

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

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

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

vm-cd-insert

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

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

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

vm-cd-list

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

Listet die an die angegebenen VMs angeschlossenen CDs auf.

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

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

vm-cd-remove

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

Entfernen Sie eine virtuelle CD von den angegebenen VMs.

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

vm-checkpoint

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

Erstellen Sie einen Prüfpunkt einer vorhandenen VM, unter Verwendung eines schnellen Festplatten-Snapshot-Vorgangs auf Speicherebene, sofern verfügbar.

vm-clone

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

Klonen Sie eine vorhandene VM, unter Verwendung eines schnellen Festplatten-Klon-Vorgangs auf Speicherebene, sofern verfügbar. Geben Sie den Namen und die optionale Beschreibung für die resultierende geklonte VM mit den Argumenten new-name-label und new-name-description an.

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

vm-compute-maximum-memory

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

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

Zum Beispiel:

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

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

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

vm-compute-memory-overhead

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

Berechnet den Virtualisierungsspeicher-Overhead einer VM.

vm-copy

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

Kopieren Sie eine vorhandene VM, jedoch ohne Verwendung des schnellen Festplatten-Klonvorgangs auf Speicherebene (auch wenn diese Option verfügbar ist). Die Festplatten-Images der kopierten VM sind garantiert vollständige Images, d.h. sie sind nicht Teil einer Copy-on-Write (CoW)-Kette.

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

Geben Sie das Ziel-SR für die resultierende kopierte VM mithilfe von sr-uuid an. Wenn dieser Parameter nicht angegeben wird, ist das Ziel dasselbe SR, in dem 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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-copy-bios-strings

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

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

Hinweis:

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

vm-crashdump-list

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

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

Wenn Sie das optionale Argument params verwenden, 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 all verwenden, um alle Parameter anzuzeigen. Wenn params nicht verwendet wird, zeigt die zurückgegebene Liste eine Standarduntermenge 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 VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-data-source-list

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

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

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

Datenquellen haben zwei Parameter – standard und enabled –, die Sie in der Ausgabe dieses Befehls sehen können. Wenn eine Datenquelle enabled auf true gesetzt hat, werden die Metriken derzeit in der Leistungsdatenbank aufgezeichnet. Wenn eine Datenquelle standard auf true gesetzt hat, werden die Metriken standardmäßig in der Leistungsdatenbank aufgezeichnet (und enabled ist für diese Datenquelle ebenfalls auf true gesetzt). Wenn eine Datenquelle standard auf false gesetzt hat, werden die Metriken standardmäßig nicht in der Leistungsdatenbank aufgezeichnet (und enabled ist für diese Datenquelle ebenfalls auf false gesetzt).

Um die Aufzeichnung von Datenquellenmetriken in der Leistungsdatenbank zu starten, führen Sie den Befehl vm-data-source-record aus. Dieser Befehl setzt enabled auf true. Zum Beenden führen Sie vm-data-source-forget aus. Dieser Befehl setzt enabled auf false.

vm-data-source-record

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

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

Dieser Vorgang schreibt die Informationen aus der Datenquelle in die persistente Leistungsmetrikdatenbank der angegebenen VMs. Aus Leistungsgründen ist diese Datenbank von der normalen Agenten-Datenbank getrennt.

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

vm-data-source-forget

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

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

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

vm-data-source-query

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

Zeigen Sie die angegebene Datenquelle für eine VM an.

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

vm-destroy

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

Zerstören Sie die angegebene VM. Dies lässt den mit der VM verbundenen Speicher intakt. Um auch den Speicher zu löschen, verwenden Sie xe vm-uninstall.

vm-disk-add

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

Fügen Sie den angegebenen VMs eine Festplatte hinzu. Wählen Sie den Parameter device aus dem Wert des Parameters allowed-VBD-devices der VMs aus.

Der Parameter disk-size kann in Bytes oder unter Verwendung der IEC-Standard-Suffixe KiB, MiB, GiB und TiB angegeben werden.

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

vm-disk-list

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

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

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

vm-disk-remove

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

Entfernen Sie eine Festplatte von den angegebenen VMs und zerstören Sie sie.

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

vm-export

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

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

Wenn der Parameter metadata true ist, werden die Festplatten 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 über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der VM-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

vm-import

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

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

Wenn metadata true ist, können Sie einen zuvor exportierten Satz von Metadaten ohne die zugehörigen Disk-Blöcke importieren. Der reine Metadaten-Import schlägt fehl, wenn VDIs nicht gefunden werden können (benannt nach SR und VDI.location), es sei denn, die Option --force ist angegeben; in diesem Fall wird der Import unabhängig davon fortgesetzt. Wenn Datenträger gespiegelt oder Out-of-Band verschoben werden können, ist der Metadaten-Import/-Export eine schnelle Methode, VMs zwischen getrennten Pools zu verschieben. Zum Beispiel als Teil eines Notfallwiederherstellungsplans.

Hinweis:

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

vm-install

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

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

Hinweis:

Beim Installieren von einer Vorlage mit vorhandenen Datenträgern werden standardmäßig neue Datenträger im selben SR wie diese vorhandenen Datenträger erstellt. Sofern das SR dies unterstützt, handelt es sich bei diesen Datenträgern um schnelle Kopien. Wenn ein anderes SR in der Befehlszeile angegeben wird, werden die neuen Datenträger dort erstellt. In diesem Fall ist eine schnelle Kopie nicht möglich, und die Datenträger sind vollständige Kopien.

Beim Installieren von einer Vorlage, die keine vorhandenen Datenträger hat, werden alle neuen Datenträger im angegebenen SR oder im Standard-SR des Pools erstellt, wenn kein SR angegeben ist.

vm-is-bios-customized

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

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

vm-memory-dynamic-range-set

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

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

vm-memory-limits-set

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

Konfigurieren Sie die Speicherlimits einer VM.

vm-memory-set

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

Konfigurieren Sie die Speicherzuweisung einer VM.

vm-memory-shadow-multiplier-set

xe vm-memory-shadow-multiplier-set [vm-selector=vm_selector_value...] [multiplier=float_memory_multiplier]
<!--NeedCopy-->

Legen Sie den Shadow-Memory-Multiplikator für die angegebene VM fest.

Dies ist eine erweiterte Option, die die Menge des Shadow-Speichers ändert, der einer hardwaregestützten VM zugewiesen ist.

Bei einigen spezialisierten Anwendungsworkloads, wie z. B. Citrix Virtual Apps™, ist zusätzlicher Shadow-Speicher erforderlich, um die volle Leistung zu erzielen.

Dieser Speicher wird als Overhead betrachtet. Er ist von den normalen Speicherberechnungen zur Zuweisung von Speicher zu einer VM getrennt. Wenn dieser Befehl aufgerufen wird, verringert sich die Menge des freien Host-Speichers entsprechend dem Multiplikator, und das Feld HVM_shadow_multiplier wird mit dem Wert aktualisiert, den Xen der VM zugewiesen hat. Wenn nicht genügend freier XenServer-Hostspeicher vorhanden ist, wird ein Fehler zurückgegeben.

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

vm-memory-static-range-set

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

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

vm-memory-target-set

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

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

vm-migrate

xe vm-migrate [compress=true|false] [copy=true|false] [host-uuid=destination_host_uuid] [host=name_or_ uuid_of_destination_host] [force=true|false] [live=true|false] [vm-selector=vm_selector_value...] [remote-master=destination_pool_master_uuid] [remote-username=destination_pool_username] [remote-password=destination_pool_password] [remote-network=destination_pool_network_uuid ][vif:source_vif_uuid=destination_network_uuid] [vdi:vdi_uuid=destination_sr_uuid]
<!--NeedCopy-->

Dieser Befehl migriert die angegebenen VMs zwischen physischen Hosts.

Der Parameter compress überschreibt den Pool-Parameter migration-compression für xe pool-param-set.

Der host-Parameter im vm-migrate-Befehl kann entweder der Name oder die UUID des XenServer-Hosts sein. Beispiel: Um die VM auf einen anderen Host im Pool zu migrieren, wobei die VM-Festplatten auf einem von beiden Hosts gemeinsam genutzten Speicher liegen:

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid
<!--NeedCopy-->

So verschieben Sie VMs zwischen Hosts im selben Pool, die keinen Speicher gemeinsam nutzen (Speicher-Live-Migration):

xe vm-migrate uuid=vm_uuid host-uuid=destination_host_uuid \
    remote-master=192.0.2.35 remote-username=username remote-password=password
<!--NeedCopy-->

Für die Speicher-Live-Migration müssen Sie den Hostnamen oder die IP-Adresse, den Benutzernamen und das Kennwort für den Pool-Koordinator angeben, selbst wenn Sie innerhalb desselben Pools migrieren.

Sie können den SR auswählen, wo jede VDI gespeichert wird:

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 remote-username=username remote-password=password host-uuid=destination_host_uuid \
    vdi:vdi_1=destination_sr1_uuid \
    vdi:vdi_2=destination_sr2_uuid \
    vdi:vdi_3=destination_sr3_uuid
<!--NeedCopy-->

Zusätzlich können Sie auswählen, welches Netzwerk die VM nach der Migration angehängt werden soll:

xe vm-migrate uuid=vm_uuid \
    vdi1:vdi_1_uuid=destination_sr1_uuid \
    vdi2:vdi_2_uuid=destination_sr2_uuid \
    vdi3:vdi_3_uuid=destination_sr3_uuid \
    vif:source_vif_uuid=destination_network_uuid
<!--NeedCopy-->

Für die Pool-übergreifende Migration:

xe vm-migrate uuid=vm_uuid remote-master=192.0.2.35 \
    remote-username=username remote-password=password \
    host-uuid=destination_host_uuid  \
    vif:source_vif_uuid=destination_network_uuid \
    vdi:vdi_uuid=destination_sr_uuid
<!--NeedCopy-->

Weitere Informationen zur Speicher-Live-Migration, Live-Migration und Live-VDI-Migration finden Sie unter VMs migrieren.

Hinweis:

Wenn Sie von einer älteren Version von XenServer oder Citrix Hypervisor™ aktualisieren, müssen Sie möglicherweise alle VMs herunterfahren und neu starten, nachdem Sie Ihre VMs migriert haben, um sicherzustellen, dass neue Virtualisierungsfunktionen übernommen werden.

Standardmäßig wird die VM angehalten, migriert und auf dem anderen Host fortgesetzt. Der live-Parameter wählt die Live-Migration aus. Die Live-Migration hält die VM während der Migration am Laufen, wodurch die VM-Ausfallzeit minimiert wird. Unter bestimmten Umständen, wie z. B. bei extrem speicherintensiven Workloads in der VM, fällt die Live-Migration in den Standardmodus zurück und hält die VM für kurze Zeit an, bevor die Speicherübertragung abgeschlossen wird.

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

vm-pause

xe vm-pause
<!--NeedCopy-->

Eine laufende VM anhalten. Beachten Sie, dass dieser Vorgang den zugeordneten Speicher nicht freigibt (siehe vm-suspend).

vm-reboot

xe vm-reboot [vm-selector=vm_selector_value...] [force=true]
<!--NeedCopy-->

Die angegebenen VMs neu starten.

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

Verwenden Sie das Argument force, um einen unsauberen Neustart zu erzwingen. Dabei ist das Herunterfahren vergleichbar mit dem Ziehen des Steckers bei einem physischen Server.

vm-recover

xe vm-recover vm-uuid [database] [vdi-uuid] [force]
<!--NeedCopy-->

Stellt eine VM aus der in der bereitgestellten VDI enthaltenen Datenbank wieder her.

vm-reset-powerstate

xe vm-reset-powerstate [vm-selector=vm_selector_value...] {force=true}
<!--NeedCopy-->

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

Dies ist ein erweiterter Befehl, der nur verwendet werden sollte, wenn ein Mitgliedshost in einem Pool ausfällt. Sie können diesen Befehl verwenden, um den Pool-Koordinator zu zwingen, den Energiestatus der VMs auf halted zurückzusetzen. Im Wesentlichen erzwingt dieser Befehl die Sperre der VM und ihrer Datenträger, damit sie als Nächstes auf einem anderen Pool-Host gestartet werden kann. Dieser Aufruf erfordert die Angabe des Force-Flags und schlägt fehl, wenn es nicht in der Befehlszeile vorhanden ist.

vm-restart-device-models

xe vm-restart-device-models [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Starten Sie das Gerätemodell für diese VM auf dem Host neu. Während das Gerätemodell neu gestartet wird, können Sie die VM nicht anhalten, starten oder migrieren. Der Endbenutzer der VM könnte eine leichte Pause und Wiederaufnahme in seiner Sitzung bemerken.

Hinweis:

Damit die Aktion zum Neustart des Gerätemodells auf einer Windows-VM unterstützt wird, müssen die XenServer VM Tools für Windows auf der VM installiert sein.

vm-resume

xe vm-resume [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid]
<!--NeedCopy-->

Setzen Sie die angegebenen VMs fort.

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

Wenn sich die VM auf einem freigegebenen SR in einem Host-Pool befindet, verwenden Sie das Argument on, um anzugeben, auf welchem Pool-Mitglied sie gestartet werden soll. Standardmäßig bestimmt das System einen geeigneten Host, der jedes der Mitglieder des Pools sein kann.

vm-retrieve-wlb-recommendations

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

Rufen Sie die Empfehlungen für den Workload-Ausgleich für die ausgewählte VM ab.

vm-shutdown

xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Fahren Sie die angegebene VM herunter.

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

Verwenden Sie das Argument force, um ein unsauberes Herunterfahren zu erzwingen, ähnlich dem Ziehen des Steckers bei einem physischen Server.

vm-snapshot

xe vm-snapshot new-name-label=name_label [new-name-description+name_description]
<!--NeedCopy-->

Erstellen Sie einen Snapshot einer vorhandenen VM, wobei, falls verfügbar, eine schnelle Datenträger-Snapshot-Operation auf Speicherebene verwendet wird.

vm-start

xe vm-start [vm-selector=vm_selector_value...] [force=true|false] [on=host_uuid] [--multiple]
<!--NeedCopy-->

Starten Sie die angegebenen VMs.

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

Wenn sich die VMs auf einem freigegebenen SR in einem Host-Pool befinden, verwenden Sie das Argument on, um anzugeben, auf welchem Pool-Mitglied die VMs gestartet werden sollen. Standardmäßig bestimmt das System einen geeigneten Host, der jedes der Mitglieder des Pools sein kann.

vm-suspend

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

Halten Sie die angegebene VM an.

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

vm-uninstall

xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Deinstallieren Sie eine VM und zerstören Sie deren Datenträger (die VDIs, die als RW markiert und nur mit dieser VM verbunden sind) zusätzlich zu ihrem Metadaten-Eintrag. Um nur die VM-Metadaten zu zerstören, verwenden Sie xe vm-destroy.

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

vm-unpause

xe vm-unpause
<!--NeedCopy-->

Eine angehaltene VM fortsetzen.

vm-vcpu-hotplug

xe vm-vcpu-hotplug new-vcpus=new_total_vcpu_count [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Passen Sie die Anzahl der vCPUs, die einer laufenden Linux-VM zur Verfügung stehen, dynamisch an. Die Anzahl der vCPUs wird durch den Parameter VCPUs-max begrenzt. Windows-VMs laufen immer mit der auf VCPUs-max eingestellten Anzahl von vCPUs und müssen neu gestartet werden, um diesen Wert zu ändern.

Verwenden Sie den Parameter new-vcpus, um die neue Gesamtanzahl der vCPUs zu definieren, die Sie nach Ausführung dieses Befehls haben möchten. Verwenden Sie diesen Parameter nicht, um die Anzahl der vCPUs zu übergeben, die Sie hinzufügen möchten. Wenn Sie beispielsweise zwei vorhandene vCPUs in Ihrer VM haben und zwei weitere vCPUs hinzufügen möchten, geben Sie new-vcpus=4 an.

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

Hinweis:

Wenn Sie Linux-VMs ohne installierte XenServer VM Tools ausführen, führen Sie den folgenden Befehl auf der VM als root aus, um sicherzustellen, dass die neu Hot-Plug-fähigen vCPUs verwendet werden: # for i in /sys/devices/system/cpu/cpu[1-9]*/online; do if [ "$(cat $i)" = 0 ]; then echo 1 > $i; fi; done

vm-vif-list

xe vm-vif-list [vm-selector=vm_selector_value...]
<!--NeedCopy-->

Listet die VIFs der angegebenen VMs auf.

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

Geplante Snapshots

Befehle zur Steuerung von geplanten VM-Snapshots und deren Attributen.

Die vmss-Objekte können mit dem Standardbefehl zur Objektlistung (xe vmss-list) aufgelistet und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

vmss-create

xe vmss-create enabled=true/false name-label=name type=type frequency=frequency retained-snapshots=value name-description=description schedule:schedule
<!--NeedCopy-->

Erstellt einen Snapshot-Zeitplan im Pool.

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
<!--NeedCopy-->

Snapshot-Zeitpläne haben die folgenden Parameter:

vmss-destroy

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

Zerstört einen Snapshot-Zeitplan im Pool.

USB-Passthrough

USB-Passthrough wird für die folgenden USB-Versionen unterstützt: 1.1, 2.0 und 3.0.

USB-Passthrough aktivieren/deaktivieren

xe pusb-param-set uuid=pusb_uuid passthrough-enabled=true/false
<!--NeedCopy-->

USB-Passthrough aktivieren/deaktivieren.

pusb-scan

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

PUSB scannen und aktualisieren.

vusb-create

xe vusb-create usb-group-uuid=usb_group_uuid vm-uuid=vm_uuid
<!--NeedCopy-->

Erstellt einen virtuellen USB im Pool. Starten Sie die VM, um den USB an die VM durchzureichen.

vusb-unplug

xe vusb-unplug uuid=vusb_uuid
<!--NeedCopy-->

Trennt USB von der VM.

vusb-destroy

xe vusb-destroy uuid=vusb_uuid
<!--NeedCopy-->

Entfernt die virtuelle USB-Liste von der VM.

VM-Gruppenbefehle

Befehle zur Steuerung von VM-Gruppen und deren Attributen.

VM-Gruppenparameter

• uuid (schreibgeschützt) der eindeutige Bezeichner/Objektreferenz für die VM
• name-label (Lese-/Schreibzugriff) der Name der VM
• name-description (Lese-/Schreibzugriff) die Beschreibungszeichenfolge der VM
• placement (nur Lesezugriff) der Typ der Platzierungsregeln, die auf VMs in der Gruppe angewendet werden sollen. Die verfügbaren Werte sind anti-affinity und normal.

vm-group-list

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

Listet alle VM-Gruppen in diesem Pool auf.

vm-group-create

xe vm-group-create placement=anti-affinity|normal name-label=<name-label> [name-description=<name-description>]
<!--NeedCopy-->

Erstellt eine VM-Gruppe.

vm-group-destroy

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

Löscht diese VM-Gruppe. Wenn Sie eine VM-Gruppe löschen, die VMs enthält, sind die VMs nicht mehr mit einer Gruppe verknüpft, aber ansonsten nicht betroffen.