Befehlszeilenschnittstelle

Die xe-CLI ermöglicht Ihnen die Skripterstellung und Automatisierung von Systemadministrationsaufgaben. 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.
• Greifen Sie per SSH auf den Host zu, 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.

Zur Installation aus dem RPM 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 Passwort zu definieren, die beim Ausführen von xe-Befehlen verwendet werden sollen. Sie haben jedoch auch die Möglichkeit, diese Informationen als Umgebungsvariable festzulegen. Zum Beispiel:

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

Hinweis:

Die Remote-xe-CLI unter Linux kann hängen bleiben, wenn versucht wird, Befehle über eine sichere Verbindung auszuführen, die einen Dateitransfer 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 auf dem Host ist verfügbar, indem Sie Folgendes eingeben:

xe help command
<!--NeedCopy-->

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

xe help
<!--NeedCopy-->

Oder 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 eigene 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 Argument password-file 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 nachfolgenden 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 (Standardwert 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-->

Eine Kurzschreibweise ist auch für Argumente für Remote-Verbindungen 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 Parameter des Remote-XenServer-Hosts 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 TAB-Taste drücken, wird der Rest des Befehls angezeigt. Wenn mehr als ein Befehl mit vm-l beginnt, listet ein erneutes Drücken der TAB-Taste 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 Remote-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. Höherstufige 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 einer 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 haben einen kleineren Satz von Befehlen.

Parametertypen

Die Objekte, die mit den xe-Befehlen adressiert werden, verfügen über Parametersätze, die sie identifizieren und 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 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 bestimmten 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 der Beispielausgabe von xe vm-param-list auf einer bestimmten 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 hat eine Liste von Elementen, die Schlüssel-Wert-Paare darstellen. Den Schlüsselnamen folgt ein Doppelpunkt (:). Jedes Schlüssel-Wert-Paar ist durch ein Semikolon (;) vom nächsten getrennt. Das M vor dem RW zeigt an, dass dieser Parameter ein Map-Parameter ist und lesbar und schreibbar ist. Der allowed-operations-Parameter hat 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 schreibbar ist.

Um einen 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-->

Low-Level-Parameterbefehle

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 zu spezifizieren. 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 mit diesem Schlüssel in der Karte verknüpften Wert ab. 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. Bei einem 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, die aufwändig zu berechnen sind. 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, wobei nur Objekte ausgegeben werden, 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, für die 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 vermeiden, 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 bei einem XenServer-Host von einer Remote-Instanz der xe CLI aus zu authentifizieren.

Um ein Geheimnis-Objekt 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 Geheimnis-Objekts aus. Zum Beispiel, 99945d96-5890-de2a-3899-8c04ef2521db. Fügen Sie _secret an den Namen des Passwort-Arguments 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, werden nur die Datensätze ab diesem spezifischen Zeitpunkt heruntergeladen.

audit-log-get Parameter

audit-log-get hat die folgenden Parameter

audit-log-get

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

Um beispielsweise Audit-Datensätze des Pools ab einem präzisen Millisekunden-Zeitstempel zu erhalten, 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 gebündelten 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 angegeben werden

bond-destroy

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

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

bond-set-mode

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

Den Bond-Modus ändern.

CD-Befehle

Befehle für die Arbeit 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 auf, mit Filterung nach dem optionalen Argument params.

Wenn das optionale Argument params verwendet wird, ist der Wert von params eine Zeichenfolge, die eine Liste der Parameter 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.

Optionale Argumente können beliebig viele 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 und die Parameter mit den Standard-Parameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Befehle für Low-Level-Parameter. 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-->

Zerstört einen GFS2-Cluster-Host, wodurch der GFS2-Cluster effektiv verlassen wird.

cluster-host-disable

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

Deaktiviert die GFS2-Cluster-Mitgliedschaft für einen aktivierten GFS2-Cluster-Host.

cluster-host-enable

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

Aktiviert die GFS2-Cluster-Mitgliedschaft für einen deaktivierten GFS2-Cluster-Host.

cluster-host-force-destroy

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

Zerstört ein GFS2-Cluster-Host-Objekt zwangsweise, 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-->

Erstellt einen Pool-weiten GFS2-Cluster.

cluster-pool-destroy

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

Zerstört den Pool-weiten GFS2-Cluster. 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 poolweit resynchronisieren.

Konsolenbefehle

Befehle für die Arbeit mit Konsolen.

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

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 große 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 Pool-weiten 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-->

Timing-Statistiken ausgeben.

diagnostic-vdi-status

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

Abfragen des Sperr- und Freigabestatus eines VDI.

diagnostic-vm-status

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

Abfragen der Hosts, auf denen die VM booten kann, Überprüfen des 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-->

Prüft, 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 (freigegebenen) 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 aktivieren Sie die Datenbankreplikation:

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

Nach einem Notfall verbinden Sie sich am sekundären Standort mit dem SR. 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-->

Eine VM wiederherstellen:

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

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

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

Ereignisbefehle

Befehle für die Arbeit 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 die Ausführung anderer Befehle, bis ein Objekt existiert, das die in der Befehlszeile angegebenen Bedingungen erfüllt. Das Argument x=y bedeutet „auf Feld x warten, bis es den Wert y annimmt“ und x=/=y bedeutet „auf Feld x warten, bis es einen anderen Wert als y annimmt“.

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

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

Blockiert andere Befehle, bis eine VM namens myvm sich im power-state “running”-Zustand 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 aufgeführt 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.

Physische GPU-Parameter

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

Befehle für die Arbeit 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.

Virtuelle GPU-Parameter

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, unterstützte Software und Grafikkarten von GPU-Anbietern sind 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-Operationen

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 bindet die VM an die angegebene GPU-Gruppe und gibt optional den virtuellen GPU-Typ an. Wird kein virtueller GPU-Typ angegeben, wird der Typ ‘Pass-Through’ angenommen.

vgpu-destroy

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

Zerstört die angegebene virtuelle GPU.

Deaktivieren von VNC für VMs mit virtueller GPU

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

Die Verwendung von false deaktiviert die VNC-Konsole für eine VM, da sie 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, die als Kontrolldomäne oder Domäne 0 bekannt ist.

Die XenServer-Hostobjekte 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 Standardparameterbefehlen 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 dies durch die Angabe des Arguments host=uuid_or_name_label. Sie können XenServer auch durch Filtern der vollständigen Hostliste nach den Werten der Felder angeben. 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 Befehlsliste 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:

Beispiele:

• xe host-param-set uuid=<uuid> ntp-mode=Factory
• xe host-param-set uuid=<uuid> ntp-custom-servers=server1,server2
• xe host-param-set uuid=<uuid> timezone=UTC
• xe host-param-set uuid=<uuid> max-cstate=1

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

CPUs auf XenServer-Hosts haben die folgenden Parameter:

Crash-Dumps 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 Host-Server 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.

Für die anfängliche Lizenzierungskonfiguration siehe auch license-server-address und license-server-port.

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

host-backup

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

Laden Sie ein Backup der Kontrolldomäne des angegebenen XenServer-Hosts auf den Rechner 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 Kontrolldomäne mit der Sicherungsdatei füllen. Verwenden Sie den Befehl nur von einem entfernten Off-Host-Rechner 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-->

Erstellen Sie einen neuen Fehlerbericht (mit xen-bugtool, einschließlich aller optionalen Dateien) und laden Sie ihn auf die Support-FTP-Site oder einen anderen Speicherort hoch.

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.

Optionale Parameter sind http-proxy: angegebenen HTTP-Proxy verwenden, und url: auf diese Ziel-URL hochladen. Wenn optionale Parameter nicht verwendet werden, wird kein Proxy-Server identifiziert und das Ziel ist die Standard-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 Standard-Support-FTP-Site. Optionale Parameter sind http-proxy: angegebenen HTTP-Proxy verwenden, und url: auf diese Ziel-URL hochladen.

host-declare-dead

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

Erklärt den Host für tot, 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. Nach dem Neustart des Hosts wird dieser automatisch wieder aktiviert, wenn alle Bedingungen für die Aktivierung erfüllt sind (z. B. Speicher verfügbar ist).

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

host-disable-display

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

Anzeige für den Host deaktivieren.

host-disable-local-storage-caching

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

Lokales Speichercaching auf dem angegebenen Host deaktivieren.

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 beliebig viele der Host-Parameter sein, die am Anfang dieses Abschnitts aufgeführt sind.

host-emergency-ha-disable

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

HA auf dem lokalen Host deaktivieren. Nur zur Wiederherstellung eines Pools mit einer fehlerhaften HA-Einrichtung zu verwenden.

host-emergency-management-reconfigure

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

Konfiguriert 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 am Anfang 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-->

Lokales Speichercaching auf dem angegebenen Host aktivieren.

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 den Host zuerst 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.

Wenn HA aktiviert ist, 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 am Anfang 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 erneut, nachdem Sie den Host vergessen haben.

Dieser Befehl ist nützlich, wenn der zu „vergessende“ XenServer-Host tot 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-->

Abrufen des installierten Server-TLS-Zertifikats.

host-get-sm-diagnostics

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

Anzeigen der 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 kommagetrennte Liste von Systemstatuseinträgen, die aus dem XML-Fragment der Funktionen stammen, 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 mithilfe des Standardauswahlmechanismus ausgewählt (siehe Host-Selektoren oben).

host-get-system-status-capabilities

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

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

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

Jede Funktionsentität kann die folgenden Attribute haben.

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

• pii Persönlich identifizierbare Informationen (PII). Gibt 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
  • yes: PII sind wahrscheinlich oder sicher in diesen Einträgen enthalten
  • maybe: Sie sollten diese Einträge möglicherweise auf PII überprüfen
  • if_customized: Wenn die Dateien unverändert sind, enthalten sie keine PII. Da wir jedoch die Bearbeitung dieser Dateien fördern, 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 Fehlerberichte aufgenommen werden, 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 von 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 Datei mit Zeitstempel 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), verwenden Sie ihn nicht auf diese Weise. Dies würde die Kontrolldomänenpartition mit der Kopie der Protokolle überladen. Verwenden Sie den Befehl nur von einem entfernten, externen Computer aus, auf dem Sie genügend Speicherplatz 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 z. B. XenCenter). Dieser Befehl wird direkt auf dem XenServer-Host ausgeführt, 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. Nach Ausführung dieses Befehls können Sie sich nicht mehr remote über das Netzwerk mit der Kontrolldomä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 Managementschnittstelle zu verwenden, die für die Verbindung mit XenCenter genutzt 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 neu binden 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 eine Netzwerkverbindung 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 auf 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 erholt sich, 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.

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 der sekundären Partition ausgepackt wurde. Nachdem Sie ein xe host-restore durchgeführt haben, müssen Sie die Installations-CD booten und die 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 eine beliebige Anzahl der zu Beginn dieses Abschnitts aufgeführten Host-Parameter sein.

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 den Hostnamen in der Steuerdomänendatenbank und 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-->

Wird verwendet, 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 (d. h. den Power-On-Modus) angeben. Geben Sie dann Konfigurationsoptionen mit dem Argument power-on-config und den zugehörigen Schlüssel-Wert-Paaren 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 ü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.

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

Versucht, einen Speicher-Datenpfad auf einem Host zu zerstören und zu bereinigen. Wenn allow-leak=true angegeben ist, werden alle Datensatz des Datenpfads gelöscht, auch wenn er nicht sauber heruntergefahren wurde.

host-sync-data

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

Synchronisiert die auf dem Pool-Koordinator gespeicherten Daten mit dem benannten Host. Dies beinhaltet nicht die Datenbankdaten).

host-syslog-reconfigure

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

Konfiguriert 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 am Anfang dieses Abschnitts aufgeführten Host-Parameter sein.

host-data-source-list

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

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

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der 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 für eine Datenquelle enabled auf true gesetzt ist, werden die Metriken derzeit in die Leistungsdatenbank aufgezeichnet.
• Wenn für eine Datenquelle standard auf true gesetzt ist, werden die Metriken standardmäßig in die Leistungsdatenbank aufgezeichnet. Der Wert von enabled ist für diese Datenquelle ebenfalls auf true gesetzt.
• Wenn für eine Datenquelle standard auf false gesetzt ist, werden die Metriken standardmäßig nicht in die 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 eine beliebige Anzahl 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 eine beliebige Anzahl 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-->

Zeigen Sie die angegebene Datenquelle für einen Host an.

Wählen Sie die Hosts aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden (siehe Host-Selektoren). Optionale Argumente können eine beliebige Anzahl der 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 Warnmeldungen angezeigt.

Die Nachrichtenobjekte können mit dem Standardbefehl zur Objektlistung (xe message-list) aufgelistet und die Parameter mit den Standardparameterbefehlen bearbeitet 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 bearbeitet 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 Befehle für Parameter auf niedriger Ebene

SR-IOV-Parameter

SR-IOV hat die folgenden Parameter:

network-sriov-create

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

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

network-sriov-destroy

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

Entfernt ein SR-IOV-Netzwerkobjekt und deaktiviert SR-IOV auf seiner 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-->

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

patch-clean

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

Löschen Sie eine zuvor hochgeladene Patch-Datei.

patch-destroy

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

Entfernen Sie einen nicht angewendeten Patch-Eintrag und Dateien vom Host.

patch-pool-apply

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

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

patch-pool-clean

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

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

patch-precheck

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

Führen Sie die Vorabprüfungen aus, die im Patch enthalten sind, 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 (Physical Block Devices). 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 Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

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 Parameter device-config kann nur bei der Erstellung festgelegt werden.

Um eine Zuordnung von ‘path’ zu ‘/tmp’ hinzuzufügen, stellen Sie sicher, dass die Befehlszeile das Argument 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 Storage.

pbd-destroy

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

Zerstört die angegebene PBD.

pbd-plug

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

Versucht, die PBD an den 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-->

Versucht, 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 parameter commands

PIF-Parameter

PIFs haben die folgenden Parameter:

Hinweis:

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

pif-forget

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

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

pif-introduce

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

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

pif-plug

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

Versuchen Sie, 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 eines Switches 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-->

Rekonfigurieren Sie die IPv6-Adresseinstellungen auf einem PIF.

pif-scan

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

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

pif-set-primary-address-type

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

Ändert den primären Adresstyp, der von diesem PIF verwendet wird.

pif-unplug

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

Versucht, 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 ein oder mehrere gemeinsam genutzte Speicher-Repositorys, 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 hinzugefügt wird, wird er als Mitglied bezeichnet. Wenn der Pool, dem der Host hinzugefügt wird, aus einem einzigen Mitglied besteht, wird dieses Mitglied zum Pool-Koordinator. Wenn der Pool, dem der Host hinzugefügt wird, 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-->

Wenden Sie eine Edition auf den gesamten Pool an. 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-->

Installieren Sie ein TLS-Zertifikat, poolweit.

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

Weist den angegebenen XenServer-Host an, Koordinator (früher „Master“) eines bestehenden 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-->

Deaktiviert das lokale Speichercaching im gesamten Pool.

pool-disable-redo-log

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

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

Lädt eine Kopie der gesamten Pooldatenbank herunter und speichert 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-->

Aktiviert das lokale Speichercaching im gesamten Pool.

pool-enable-redo-log

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

Aktiviert 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 zu werden (früher „der Pool-Master“ genannt). Der XenServer-Host akzeptiert diesen Befehl erst, 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 einer bestimmten Anzahl von 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 für den 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

Berechnet die maximale Anzahl von Hostausfällen, die unter der aktuellen Poolkonfiguration 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-->

Berechnet die maximale Anzahl von Hostausfä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-->

Initialisiert den Workload-Ausgleich für den aktuellen Pool mit dem Ziel-Workload-Ausgleichsserver.

pool-join

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

Weisen Sie Ihren XenServer-Host an, einem bestehenden 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 genutzt wird. Der Befehl schreibt den MANAGEMENT_INTERFACE-Schlüssel in /etc/xensource-inventory für alle Hosts im Pool neu.

Wenn der Gerätename einer Schnittstelle (die eine IP-Adresse haben muss) angegeben wird, bindet der XenServer-Poolkoordinator 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 neu gebunden werden soll. Bei Ausführung dieses Befehls darf er sich nicht im Notfallmodus befinden.

Warnung:

Seien Sie vorsichtig, wenn Sie diesen CLI-Befehl außerhalb des Hosts verwenden, und stellen Sie sicher, dass Sie über eine Netzwerkverbindung auf der neuen Schnittstelle 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-->

Weist den Poolkoordinator 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 Poolkoordinator festzulegen.

pool-restore-database

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

Lädt ein Datenbank-Backup (erstellt mit pool-dump-database) in einen Pool hoch. Nach Erhalt des Uploads startet sich der Poolkoordinator mit der neuen Datenbank neu.

Es gibt auch eine Option für einen Testlauf, mit der Sie überprüfen können, ob die Pooldatenbank wiederhergestellt werden kann, ohne den Vorgang tatsächlich auszuführen. Standardmäßig ist dry-run auf false 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 Mitgliedschaft in einem Pool nachzuweisen. Benutzer mit der Rolle „Pool-Administrator“ können dieses Geheimnis einsehen, 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-->

Sendet den angegebenen Body über HTTPS an den angegebenen Host und Port und gibt 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-->

Erzwingt 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 Accelerator-Befehle

Befehle für die Arbeit mit dem PVS Accelerator.

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

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

Eine 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 Standardparameterbefehlen manipuliert 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 programmgesteuert über die XenAPI oder die xe-Befehlszeilenschnittstelle (CLI) zu steuern.

Diese Verbesserung ermöglicht es Administratoren, den SSH-Zugriff sowohl auf einzelnen Hosts als auch auf gesamten Pools zu verwalten, wodurch keine manuelle Interaktion mit jeder Serverkonsole mehr erforderlich ist.

Vorteile

• Automatisierte Verwaltung: SSH auf einzelnen Hosts oder über einen gesamten Pool programmgesteuert 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 Hinweise

• 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 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. Für gültige host Selektoren siehe 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 (Pool-Ebene-Operation)

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 Festplattenklon-Operation auf Speicherebene zu verwenden (auch wenn diese verfügbar ist). Die Festplatten-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ört einen Snapshot. Dabei 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-->

Listet die Festplatten auf 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-->

Exportiert einen Snapshot nach Dateiname.

snapshot-reset-powerstate

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

Erzwingt den VM-Stromversorgungsstatus 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 Speicherabbild 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-->

Setzt eine vorhandene VM auf einen früheren Checkpoint- oder Snapshot-Status zurück.

snapshot-uninstall

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

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

SR-Befehle

Befehle zur Steuerung von SRs (Speicher-Repositories).

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

SR-Parameter

SRs haben die folgenden Parameter:

sr-create

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

Erstellt einen SR auf der Festplatte, führt ihn in die Datenbank ein und erstellt einen PBD, der den SR an den XenServer-Host anbindet. Wenn shared auf true gesetzt ist, wird ein PBD für jeden XenServer-Host im Pool erstellt. Wenn shared nicht angegeben oder auf false gesetzt ist, wird ein 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-Backends 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 eine SR und verwirft alle aufgezeichneten Daten.

sr-data-source-list

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

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

sr-data-source-query

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

Fragt den letzten Wert ab, der von einer SR-Datenquelle gelesen wurde.

sr-data-source-record

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

Zeichnet die angegebene Datenquelle für eine SR auf.

sr-destroy

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

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

sr-enable-database-replication

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

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

sr-disable-database-replication

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

Deaktiviert die XAPI-Datenbankreplikation auf die angegebene SR.

sr-forget

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

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

sr-introduce

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

Platziert lediglich einen SR-Datensatz in der Datenbank. 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 unter Verwendung der bereitgestellten device-config-Schlüssel durch. 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 unterstützen. Die Scanergebnisse 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 über die verschiedenen Speicher-Backends hinweg finden Sie unter Speicher.

sr-probe-ext

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

Führen Sie eine 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 die Ergebnisse für jeden SR-Typ im selben menschenlesbaren Format 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-->

Thin Provisioning auf einem LVHD SR aktivieren.

Subjektbefehle

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ügt 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 Befehle für Parameter auf niedriger Ebene

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 eines Betriebssystemanbieters booten können (zum Beispiel: RHEL, CentOS, SLES, Windows). 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 manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

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 umwandeln:

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

• is-control-domain (schreibgeschützt) true, wenn dies eine Steuerdomä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 bei Änderung 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 bei Änderung 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 (nur Lesezugriff) 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 (nur Lese-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 (nur Lese-Set-Parameter) Liste der in diesem Zustand zulässigen Operationen
• current-operations (nur Lese-Set-Parameter) Liste der Operationen, die derzeit an dieser Vorlage ausgeführt werden
• allowed-VBD-devices (nur lesbarer Satzparameter) Liste der verfügbaren VBD-Bezeichner, dargestellt durch Ganzzahlen 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 (nur lesbarer Satzparameter) Liste der verfügbaren VIF-Bezeichner, dargestellt durch Ganzzahlen 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 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 zu initrd
• PV-args (Lese-/Schreibzugriff) Zeichenfolge von Kernel-Befehlszeilenargumenten
• PV-legacy-args (Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um ältere 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 lesbar) 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 lesbar) der XenServer-Host, auf dem eine auf dieser Vorlage basierende VM resident ist. Wird für eine Vorlage als not in database angezeigt
• affinity (Lese-/Schreibzugriff) der XenServer-Host, auf dem eine auf dieser Vorlage basierende VM bevorzugt ausgeführt wird. Wird vom Befehl xe vm-start verwendet, um zu entscheiden, wo die VM ausgeführt werden soll. Auch bekannt als Home-Server.
• 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 (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine VM, die auf dieser Vorlage basiert, gelesen wurden, im Format 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 (schreibgeschützt) Zeitstempel des Datums und der Uhrzeit, zu der die Metriken für eine VM, die auf dieser Vorlage basiert, gelesen wurden, im Format 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 (schreibgeschützt) der tatsächlich von einer VM, die auf dieser Vorlage basiert, verwendete Speicher; 0 für eine Vorlage
• VCPUs-number (schreibgeschützt) die Anzahl der virtuellen CPUs, die einer VM, die auf dieser Vorlage basiert, zugewiesen sind; 0 für eine Vorlage
• VCPUs-Utilization (schreibgeschützter Kartenparameter) Liste der virtuellen CPUs und deren Gewicht schreibgeschützter Kartenparameter os-version die Version des Betriebssystems für eine VM, die auf dieser Vorlage basiert. Erscheint als not in database für eine Vorlage
• PV-drivers-version (schreibgeschützter Kartenparameter) die Versionen der paravirtualisierten Treiber für eine VM, die auf dieser Vorlage basiert. Erscheint als not in database für eine Vorlage
• PV-drivers-detected (schreibgeschützt) Flag für die neueste Version der paravirtualisierten Treiber für eine VM, die auf dieser Vorlage basiert. Erscheint als not in database für eine Vorlage
• memory (schreibgeschützter Kartenparameter) Speichermetriken, die vom Agenten auf einer VM, die auf dieser Vorlage basiert, gemeldet werden. Erscheint als not in database für eine Vorlage
• disks (schreibgeschützter Kartenparameter) Festplattenmetriken, die vom Agenten auf einer VM, die auf dieser Vorlage basiert, gemeldet werden. Erscheint als not in database für eine Vorlage
• networks (schreibgeschützter Kartenparameter) Netzwerkmetriken, die vom Agenten auf einer VM, die auf dieser Vorlage basiert, gemeldet werden. Erscheint als not in database für eine Vorlage
• other (schreibgeschützter Kartenparameter) andere Metriken, die vom Agenten auf einer VM, die auf dieser Vorlage basiert, gemeldet werden. Erscheint als not in database für eine Vorlage
• guest-metrics-last-updated (schreibgeschützt) Zeitstempel, wann der Gast-Agent die letzte Schreiboperation auf diese Felder durchgeführt hat. Im Format 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 dem Gast zur Verfügung gestellten Schattens angewendet wird
• dom-id (nur Lesezugriff) Domänen-ID (falls verfügbar, sonst -1)
• recommendations (nur Lesezugriff) XML-Spezifikation der empfohlenen Werte und Bereiche für Eigenschaften dieser VM
• xenstore-data (Lese-/Schreib-Map-Parameter) Daten, die nach der Erstellung der VM in den xenstore-Baum (/local/domain/*domid*/vmdata) eingefügt werden sollen.
• is-a-snapshot (nur Lesezugriff) Der Wert ist „true“, wenn diese Vorlage ein VM-Snapshot ist
• snapshot_of (nur Lesezugriff) die UUID der VM, von der diese Vorlage ein Snapshot ist
• snapshots (nur Lesezugriff) die UUIDs aller Snapshots, die von dieser Vorlage erstellt wurden
• snapshot_time (nur Lesezugriff) der Zeitstempel des zuletzt erstellten VM-Snapshots
• memory-target (nur Lesezugriff) 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 (nur Lesezugriff) Aufzeichnung der letzten Boot-Parameter für diese Vorlage im XML-Format
• ha-always-run (Lese-/Schreibzugriff) Der Wert ist „true“, 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 Parameter ha-restartpriority.
• ha-restart-priority (nur Lesezugriff) Neustart oder Best-Effort-Lese-/Schreib-Blobs-Binärdatenspeicher
• live (nur Lesezugriff) 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-->

Deinstalliert eine benutzerdefinierte Vorlage. Dieser Vorgang zerstört die VDIs, die als „im Besitz“ dieser Vorlage gekennzeichnet sind.

Befehle aktualisieren

Der folgende Abschnitt enthält Befehle zur Aktualisierung des XenServer-Hosts.

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

Parameter aktualisieren

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 zuvor bereits hochgeladen wurde, wird stattdessen 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-Rechte 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 Befehle für Low-Level-Parameter

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 ein 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 für eine Festplatte RO oder RW sein.

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

vbd-destroy

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

Zerstören Sie das angegebene VBD.

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

vbd-eject

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

Entfernen Sie die Medien aus dem Laufwerk, das durch ein VBD dargestellt wird. Dieser Befehl funktioniert nur, wenn die Medien vom Typ ‘entfernbar’ 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 ein 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, das VBD anzuhängen, während die VM im laufenden Zustand ist.

vbd-unplug

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

Versucht, das 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 von einer VM gesehenen virtuellen Festplatte darstellt. Dies unterscheidet sich vom VBD, das ein Objekt ist, das eine VM an das VDI bindet. Das VDI enthält Informationen über die physikalischen Attribute der virtuellen Festplatte (welcher SR-Typ, ob die Festplatte gemeinsam genutzt werden kann, ob die Medien Lese-/Schreib- oder Nur-Lese-Zugriff haben usw.). Das 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 Speichertreiberanbieters.

vdi-copy

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

Kopieren Sie eine VDI auf ein angegebenes SR.

vdi-create

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

Erstellen Sie eine VDI.

Der Parameter virtual-size kann in Bytes oder unter Verwendung der IEC-Standardsuffixe 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 überprovisioniertes 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 Daten, die mit der angegebenen VDI verknüpft sind, aber behalten Sie die Metadaten der geänderten Blockverfolgung bei.

Hinweis:

Wenn Sie die geänderte Blockverfolgung verwenden, um inkrementelle Sicherungen 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 die geänderte Blockverfolgung verwenden, um inkrementelle Sicherungen 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.

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

vdi-disable-cbt

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

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

vdi-enable-cbt

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

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

Hinweis:

Sie können die geänderte Blockverfolgung 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 eine VDI in den angegebenen Dateinamen. Sie können eine VDI in einem der folgenden Formate exportieren:

• raw
• vhd

Das VHD-Format kann sparse sein. Wenn nicht zugewiesene Blöcke innerhalb der 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 der exportierten VDI und der Basis-VDI geändert haben.

vdi-forget

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

Entfernt einen VDI-Datensatz bedingungslos 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-->

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

vdi-list-changed-blocks

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

Vergleichen Sie zwei VDIs und geben Sie die Liste der Blöcke 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-->

Migrieren Sie 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-->

Ändern Sie 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 innerhalb 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 anbieterspezifische Konfigurationsinformationen an den Back-End-Speichertreiber zu übergeben, auf dem das VDI basiert. Weitere Informationen finden Sie in der Dokumentation des Speichertreiberanbieters.

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 für die Arbeit mit VIFs (virtuelle Netzwerkschnittstellen).

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

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 (Nur-Lese-Set-Parameter) eine Liste der in diesem Zustand zulässigen Operationen
• current-operations (Nur-Lese-Set-Parameter) eine Liste der Operationen, die derzeit auf diesem VIF ausgeführt werden
• device (Nur-Lese) ganzzahlige Bezeichnung dieses VIF, die die Reihenfolge angibt, in der VIF-Back-Ends erstellt wurden
• MAC (Nur-Lese) MAC-Adresse des VIF, wie sie der VM angezeigt wird

• MTU (Nur-Lese) Maximale Übertragungseinheit des VIF in Bytes.

  Dieser Parameter ist schreibgeschützt, aber Sie können die MTU-Einstellung mit dem Schlüssel mtu unter Verwendung des Kartenparameters 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 (Nur-Lese) 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 (Nur-Lese-Set-Parameter) unterstützte QoS-Algorithmen für dieses VIF
• MAC-autogenerated (Nur-Lese) 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 es zu deaktivieren
• other-config:ethtooltso (Lesen/Schreiben) auf ‘on’ setzen, um TCP-Segmentierungs-Offload zu aktivieren, auf ‘off’, um es zu deaktivieren
• other-config:ethtoolufo (Lesen/Schreiben) auf ‘on’ setzen, um UDP-Fragment-Offload zu aktivieren, auf ‘off’, um es zu deaktivieren
• other-config:ethtoolgso (Lesen/Schreiben) auf ‘on’ setzen, um generisches Segmentierungs-Offload zu aktivieren, auf ‘off’, um es zu deaktivieren
• other-config:promiscuous (Lesen/Schreiben) true, 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 Lesen) der eindeutige Bezeichner/Objektreferenz des virtuellen Netzwerks, mit dem dieses VIF verbunden ist
• network-name-label (nur Lesen) der beschreibende Name des virtuellen Netzwerks, mit dem dieses VIF verbunden ist
• io_read_kbs (nur Lesen) durchschnittliche Leserate in kB/s für dieses VIF
• io_write_kbs (nur Lesen) durchschnittliche Schreibrate in kB/s für dieses VIF
• locking_mode (Lesen/Schreiben) 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 (Lesen/Schreiben) Variiert je nach dem Standard-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 (Lesen/Schreiben) 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 (Lesen/Schreiben) Es werden keine Filter auf den Datenverkehr angewendet, der zum oder vom VIF geht.
• locking_mode:disabled (Lesen/Schreiben) 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 eine 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 zulässigen 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 eine VIF.

vif-move

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

Verschieben Sie die VIF in ein anderes Netzwerk.

vif-plug

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

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

vif-unplug

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

Versucht, die 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-->

Bereinigen Sie die IPv4-Einstellungen wie folgt:

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

Bereinigen Sie die IPv6-Einstellungen wie folgt:

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 für jeden Host ermitteln, auf welcher Schnittstelle (z. B. eno12429np0) sich das angegebene Netzwerk befindet, und dann entsprechend ein neues PIF-Objekt auf jedem Host erstellen und einstecken.

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 Standardparameterbefehlen manipuliert werden. Weitere Informationen finden Sie unter Low-level parameter commands

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 angewendet werden.

• appliance (Lese-/Schreibzugriff) die Appliance/vApp, zu der die VM gehört
• uuid (nur Lesezugriff) der eindeutige Bezeichner/Objektreferenz 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 vApp-Start/Herunterfahren und für den Start nach HA-Failover. VMs mit einem Ordnungswert von 0 (Null) werden zuerst gestartet, dann VMs mit einem Ordnungswert von 1 und so weiter.
• version (nur Lesezugriff) 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 folgendem Befehl in eine Vorlage umwandeln:

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

• is-control-domain (schreibgeschützt) Der Wert ist wahr, wenn es sich um eine Steuerdomäne handelt (Domäne 0 oder eine Treiberdomäne)
• power-state (schreibgeschützt) aktueller Energiezustand
• start-delay (Lese-/Schreibzugriff) die Verzögerung in Sekunden, die gewartet werden soll, bevor ein Aufruf zum Starten der VM zurückkehrt
• shutdown-delay (Lese-/Schreibzugriff) die Verzögerung in Sekunden, die gewartet werden soll, bevor ein Aufruf zum Herunterfahren der VM zurückkehrt
• memory-dynamic-max (Lese-/Schreibzugriff) dynamisches Maximum in Bytes
• memory-dynamic-min (Lese-/Schreibzugriff) dynamisches Minimum in Bytes
• memory-static-max (Lese-/Schreibzugriff) statisch festgelegtes (absolutes) Maximum in Bytes. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
• memory-static-min (Lese-/Schreibzugriff) statisch festgelegtes (absolutes) Minimum in Bytes. Wenn Sie diesen Wert ändern möchten, muss die VM heruntergefahren werden.
• suspend-VDI-uuid (schreibgeschützt) 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 (Lese-/Schreibzugriff) maximale Anzahl virtueller CPUs.
• VCPUs-at-startup (Lese-/Schreibzugriff) Startanzahl virtueller CPUs
• actions-after-crash (Lese-/Schreibzugriff) Aktion, die ausgeführt werden soll, wenn die VM abstürzt. Für PV-Gäste sind gültige Parameter:
  • preserve (nur zur Analyse)
  • coredump_and_restart (einen Core-Dump aufzeichnen und die VM neu starten)
  • coredump_and_destroy (einen Coredump aufzeichnen und die VM angehalten lassen)
  • restart (kein Coredump und VM neu starten)
  • destroy (kein Coredump und VM angehalten lassen)
• console-uuids (schreibgeschützter Parameter) virtuelle Konsolengeräte

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

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

   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 schalten:

   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 (schreibgeschützter Parameter) Liste der in diesem Zustand zulässigen Operationen
• current-operations (schreibgeschützter Parameter) eine Liste der Operationen, die derzeit auf der VM ausgeführt werden
• allowed-VBD-devices (schreibgeschützter Parameter) Liste der zur Verwendung verfügbaren VBD-Identifikatoren, dargestellt durch Ganzzahlen 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 (schreibgeschützter Parameter) Liste der zur Verwendung verfügbaren VIF-Identifikatoren, dargestellt durch Ganzzahlen 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 Reihenfolgeschlü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-Disk und n für den Netzwerk-PXE-Start. Der Standardwert ist dc.
• HVM-shadow-multiplier (Lese-/Schreibzugriff) Gleitkommawert, der den Umfang des Shadow-Memory-Overheads steuert, der der VM zugewiesen wird. Der Standardwert ist 1.0 (der Mindestwert), und dieser Wert sollte nur von fortgeschrittenen Benutzern geändert werden.
• PV-kernel (Lese-/Schreibzugriff) Pfad zum Kernel
• PV-ramdisk (Lese-/Schreibzugriff) Pfad zur initrd
• PV-args (Lese-/Schreibzugriff) Zeichenfolge von Kernel-Befehlszeilenargumenten
• PV-legacy-args (Lese-/Schreibzugriff) Zeichenfolge von Argumenten, um Legacy-VMs 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 Lesezugriff) beschreibt die CPU-Flags, mit denen die VM zuletzt gestartet wurde
• resident-on (nur Lesezugriff) der XenServer-Host, auf dem eine VM resident ist
• affinity (Lese-/Schreibzugriff) 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 bekannt als Home-Server.
• 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) 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 hat. Sie müssen diesen Parameter auch in Ihrem Pool other-config festlegen. Diese Parameter sind jetzt veraltet. Verwenden Sie stattdessen den Parameter ha-restart-priority.

• start-time (nur Lesezugriff) 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 Lesezugriff) 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 (nur Lesezugriff) 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 werden immer mit der auf VCPUsmax eingestellten Anzahl von vCPUs ausgeführt 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 (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 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) 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 Vorgänge 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 bei einem Ausfall des Hosts, auf dem sie sich befindet, immer auf einem anderen Host neu gestartet wird. Dieser Parameter ist jetzt veraltet. Verwenden Sie stattdessen den ha-restart-priority Parameter.
• 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 einen „value“-String 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ügen Sie 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-->

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

Legen Sie eine CD in das virtuelle CD-Laufwerk ein. Dieser Befehl funktioniert nur, wenn genau ein leeres CD-Gerät an die VM angeschlossen ist. Wenn zwei oder mehr leere CD-Geräte vorhanden sind, verwenden Sie den Befehl xe vbd-insert und geben Sie die UUIDs des VBD und des einzulegenden VDI 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-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-->

Entfernt eine virtuelle CD aus 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 zu Beginn dieses Abschnitts aufgeführten VM-Parameter sein.

vm-checkpoint

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

Erstellt einen Prüfpunkt einer vorhandenen VM, wobei, falls verfügbar, eine schnelle Disk-Snapshot-Operation auf Speicherebene verwendet wird.

vm-clone

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

Klont eine vorhandene VM, wobei, falls verfügbar, eine schnelle Disk-Klon-Operation auf Speicherebene verwendet wird. 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 zu Beginn dieses Abschnitts aufgeführten VM-Parameter sein.

vm-compute-maximum-memory

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

Berechnet die maximale Menge an statischem Speicher, die einer vorhandenen VM zugewiesen werden kann, wobei die Gesamtmenge des physischen RAMs als Obergrenze dient. Der optionale Parameter approximate reserviert in der Berechnung ausreichend zusätzlichen Speicher, um das spätere Hinzufügen weiterer 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 zu Beginn dieses Abschnitts aufgeführten VM-Parameter sein.

vm-compute-memory-overhead

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

Berechnet den Virtualisierungsspeicher-Overhead einer VM.

vm-copy

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

Kopieren Sie eine vorhandene VM, jedoch ohne die speicherbasierte schnelle Festplatten-Klonoperation zu verwenden (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 mit den Argumenten new-name-label und new-name-description an.

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

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 zu Beginn dieses Abschnitts aufgeführten VM-Parameter sein.

vm-copy-bios-strings

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

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

Hinweis:

Nach dem ersten Start einer VM können Sie deren BIOS-Strings nicht mehr ändern. Stellen Sie sicher, dass die BIOS-Strings korrekt sind, bevor Sie die VM zum ersten Mal starten.

vm-crashdump-list

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

Listet die mit den angegebenen VMs verknüpften Crashdumps auf.

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 über den Standardauswahlmechanismus ausgewählt. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der zu Beginn dieses Abschnitts aufgeführten VM-Parameter sein.

vm-data-source-list

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

Listet 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, über den Standardauswahlmechanismus aus. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können eine beliebige Anzahl der zu Beginn dieses Abschnitts aufgeführten VM-Parameter sein. 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-->

Zeichnet 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 aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können beliebig viele 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-->

Beendet die Aufzeichnung der angegebenen Datenquelle für eine VM und verwirft alle aufgezeichneten Daten.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können beliebig viele 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-->

Zeigt die angegebene Datenquelle für eine VM an.

Wählen Sie die VMs aus, auf denen dieser Vorgang ausgeführt werden soll, indem Sie den Standardauswahlmechanismus verwenden. Weitere Informationen finden Sie unter VM-Selektoren. Optionale Argumente können beliebig viele 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ört die angegebene VM. Dabei bleibt der mit der VM verbundene 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. Konventionsgemäß 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, wird die MAC-Adresse der ursprünglichen VM beibehalten. Der sr-uuid bestimmt den Ziel-SR, in den die VM importiert werden soll. Wenn dieser Parameter nicht angegeben wird, wird der Standard-SR verwendet.

Wenn die 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 wird angegeben; in diesem Fall wird der Import trotzdem fortgesetzt. Wenn Datenträger gespiegelt oder außerband 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 eine 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 in derselben SR wie diese vorhandenen Datenträger erstellt. Sofern die SR dies unterstützt, handelt es sich bei diesen Datenträgern um schnelle Kopien. Wenn eine andere SR in der Befehlszeile angegeben wird, werden die neuen Datenträger dort erstellt. In diesem Fall ist keine schnelle Kopie 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 in der angegebenen SR erstellt, oder in der Standard-SR des Pools, wenn keine 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, während 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-Speicher-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 für die Speicherzuweisung an eine 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. Es ist nur möglich, diese Felder zu ändern, 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 durch die Werte memory_static_min und memory_static_max der VM definierten Bereichs liegen.

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 Parameter host im Befehl vm-migrate kann entweder der Name oder die UUID des XenServer-Hosts sein. Um beispielsweise die VM zu einem 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, auch wenn Sie innerhalb desselben Pools migrieren.

Sie können den SR auswählen, in dem 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 verwenden 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 Cross-Pool-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 aktualisieren, müssen Sie möglicherweise alle VMs nach der Migration herunterfahren und neu starten, um sicherzustellen, dass neue Virtualisierungsfunktionen übernommen werden.

Standardmäßig wird die VM angehalten, migriert und auf dem anderen Host fortgesetzt. Der Parameter live wählt die Live-Migration aus. Die Live-Migration hält die VM während der Migration am Laufen und minimiert so die Ausfallzeit der VM. 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 am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

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 am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

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 zu Beginn dieses Abschnitts aufgeführten VM-Parameter sein.

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 Energiezustand der VMs auf halted zurückzusetzen. Im Wesentlichen erzwingt dieser Befehl die Sperre der VM und ihrer Festplatten, sodass 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-->

Startet das Gerätemodell für diese VM auf dem Host neu. Während das Gerätemodell neu gestartet wird, können Sie die VM weder anhalten, starten noch migrieren. Der Endbenutzer der VM bemerkt möglicherweise eine leichte Pause und Wiederaufnahme in seiner Sitzung.

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

Setzt die angegebenen VMs fort.

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

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 Lastausgleich für die ausgewählte VM ab.

vm-shutdown

xe vm-shutdown [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Fahren Sie die angegebene VM herunter.

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

Verwenden Sie das Argument force, um ein nicht ordnungsgemäßes 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, ein schneller Festplatten-Snapshot-Vorgang 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 am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

Wenn sich die VMs auf einem gemeinsamen 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 am Anfang dieses Abschnitts aufgeführten VM-Parameter sein.

vm-uninstall

xe vm-uninstall [vm-selector=vm_selector_value...] [force=true|false]
<!--NeedCopy-->

Deinstallieren Sie eine VM, wobei ihre Festplatten (die VDIs, die als RW markiert und nur mit dieser VM verbunden sind) zusätzlich zu ihrem Metadaten-Datensatz zerstört werden. 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 ist 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-->

USB von der VM trennen.

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 (lesen/schreiben) 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, bleiben aber ansonsten unberührt.