az batch pool
Hinweis
Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Weitere Informationen zu Erweiterungen
Batchpools verwalten.
Befehle
Name | Beschreibung | Typ | Status |
---|---|---|---|
az batch pool autoscale |
Verwalten der automatischen Skalierung von Batchpools. |
Core | Allgemein verfügbar |
az batch pool autoscale disable |
Deaktiviert die automatische Skalierung für einen Pool. |
Core | Allgemein verfügbar |
az batch pool autoscale enable |
Aktiviert die automatische Skalierung für einen Pool. |
Core | Allgemein verfügbar |
az batch pool autoscale evaluate |
Ruft das Ergebnis der Auswertung einer automatischen Skalierungsformel im Pool ab. |
Core | Allgemein verfügbar |
az batch pool create |
Erstellen Sie einen Batchpool in einem Konto. Wählen Sie beim Erstellen eines Pools Argumente aus der Cloud Services-Konfiguration oder der Virtuellen Computerkonfiguration aus. |
Core | Allgemein verfügbar |
az batch pool create (azure-batch-cli-extensions Erweiterung) |
Erstellen Sie einen Batchpool in einem Konto. Wählen Sie beim Erstellen eines Pools Argumente aus der Cloud Services-Konfiguration oder der Virtuellen Computerkonfiguration aus. |
Erweiterung | Allgemein verfügbar |
az batch pool delete |
Löscht einen Pool aus dem angegebenen Konto. |
Core | Allgemein verfügbar |
az batch pool list |
Listet alle Pools im angegebenen Konto auf. |
Core | Allgemein verfügbar |
az batch pool node-counts |
Abrufen der Knotenanzahl für Batchpools. |
Core | Allgemein verfügbar |
az batch pool node-counts list |
Ruft die Anzahl der Computeknoten in jedem Zustand ab, gruppiert nach Pool. |
Core | Allgemein verfügbar |
az batch pool reset |
Dient zum Aktualisieren der Eigenschaften eines Batchpools. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardwerte zurückgesetzt. |
Core | Allgemein verfügbar |
az batch pool resize |
Ändern der Größe oder Beenden der Größe eines Batchpools |
Core | Allgemein verfügbar |
az batch pool set |
Dient zum Aktualisieren der Eigenschaften eines Batchpools. Durch das Aktualisieren einer Eigenschaft in einer Untergruppe werden die nicht angegebenen Eigenschaften dieser Gruppe zurückgesetzt. |
Core | Allgemein verfügbar |
az batch pool show |
Ruft Informationen zum angegebenen Pool ab. |
Core | Allgemein verfügbar |
az batch pool supported-images |
Abfragen von Informationen zu VM-Images, die vom Azure Batch-Dienst unterstützt werden. |
Core | Allgemein verfügbar |
az batch pool supported-images list |
Listet alle virtuellen Computerimages auf, die vom Azure-Batchdienst unterstützt werden. |
Core | Allgemein verfügbar |
az batch pool usage-metrics |
Zeigen Sie Nutzungsmetriken von Batchpools an. |
Core | Allgemein verfügbar |
az batch pool usage-metrics list |
Listet die Nutzungsmetriken auf, aggregiert nach Pool über einzelne Zeitintervalle für das angegebene Konto. |
Core | Allgemein verfügbar |
az batch pool create
Erstellen Sie einen Batchpool in einem Konto. Wählen Sie beim Erstellen eines Pools Argumente aus der Cloud Services-Konfiguration oder der Virtuellen Computerkonfiguration aus.
az batch pool create [--accelerated-networking {false, true}]
[--account-endpoint]
[--account-key]
[--account-name]
[--application-licenses]
[--application-package-references]
[--auto-scale-formula]
[--certificate-references]
[--defer-os-rolling-upgrade {false, true}]
[--disable-auto-rollback {false, true}]
[--disk-encryption-targets]
[--enable-auto-os-upgrade {false, true}]
[--enable-cross-zone-upgrade {false, true}]
[--enable-inter-node-communication]
[--enable-secure-boot {false, true}]
[--enable-vtpm {false, true}]
[--enable-write-accel {false, true}]
[--encryption-at-host {false, true}]
[--id]
[--image]
[--json-file]
[--max-batch-instance-percent]
[--max-unhealthy-instance-percent]
[--max-unhealthy-upgraded-instance-percent]
[--metadata]
[--node-agent-sku-id]
[--os-disk-caching {none, readonly, readwrite}]
[--os-disk-size]
[--os-family {2, 3, 4, 5, 6}]
[--os-version]
[--pause-time-between-batches]
[--placement {cachedisk}]
[--policy {regional, zonal}]
[--prioritize-unhealthy-instances {false, true}]
[--resize-timeout]
[--resource-tags]
[--rollback-failed-instances-on-policy-breach {false, true}]
[--security-type]
[--start-task-command-line]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--storage-account-type {premium_lrs, standard_lrs, standardssd_lrs}]
[--target-communication {classic, default, simplified}]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--upgrade-policy-mode {automatic, manual, rolling}]
[--use-rolling-upgrade-policy {false, true}]
[--vm-size]
Optionale Parameter
Gibt an, ob dieser Pool beschleunigte Netzwerke aktivieren soll. Das beschleunigte Netzwerk ermöglicht die Single Root-E/A-Virtualisierung (SR-IOV) auf einem virtuellen Computer, was zu einer verbesserten Netzwerkleistung führen kann. Weitere Informationen finden Sie unter: https://zcusa.951200.xyz/azure/virtual- Netzwerk/beschleunigte Netzwerk-Übersicht. Legen Sie "true" fest, um den Wert zu aktivieren.
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batchdienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl. Durch Leerzeichen getrennte Werte.
Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets vollqualifizierte sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Änderungen an Paketverweise wirken sich auf alle neuen Knoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt wurden. Es gibt maximal 10 Paketverweise für einen bestimmten Pool. Leerzeichentrennte Anwendungs-IDs mit optionaler Version im Format "id[#version]".
Eine Formel für die gewünschte Anzahl von Computeknoten im Pool. Die Formel wird vor der Erstellung des Pools auf Gültigkeit überprüft. Wenn die Formel ungültig ist, lehnt der Batchdienst die Anforderung mit detaillierten Fehlerinformationen ab. Weitere Informationen zum Angeben dieser Formel finden Sie unter https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/.
Für Windows-Knoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis "Aufgabe" gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR wird der Aufgabe bereitgestellt, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von 'remoteUser' wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers erstellt (z. B. /home/{user-name}/certs) und Zertifikate in diesem Verzeichnis platziert. Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung . Durch Leerzeichen getrennte Zertifikatfingerabdrücke.
Verzögern Sie Betriebssystemupgrades auf tvMs, wenn sie Aufgaben ausführen. True, wenn die Kennzeichnung vorhanden ist.
Gibt an, ob das Rollbackfeature des Betriebssystemimages deaktiviert werden soll. True, wenn die Kennzeichnung vorhanden ist.
Eine durch Leerzeichen getrennte Liste von DiskEncryptionTargets. aktuelle mögliche Werte sind OsDisk und TemporaryDisk.
Gibt an, ob Betriebssystemupgrades automatisch auf Skalierungssatzinstanzen angewendet werden sollen, wenn eine neuere Version des Betriebssystemimages verfügbar wird.
Wenn dies für Windows-basierte Pools auf "true" festgelegt ist, kann "WindowsConfiguration.enableAutomaticUpdates " nicht auf "true" festgelegt werden. True, wenn die Kennzeichnung vorhanden ist.
Zulassen, dass VMSS AZ-Grenzen beim Erstellen von Upgradebatches ignoriert. Berücksichtigen Sie die Update do Standard und maxBatchInstancePercent, um die Batchgröße zu bestimmen. Dieses Feld kann nur bei Verwendung von NodePlacementConfiguration als Zonal auf "true" oder "false" festgelegt werden. True, wenn die Kennzeichnung vorhanden ist.
Gibt an, ob der Pool die direkte Kommunikation zwischen Computeknoten zulässt. Das Aktivieren der Kommunikation zwischen Knoten begrenzt die maximale Größe des Pools aufgrund von Bereitstellungseinschränkungen auf den Computeknoten des Pools. Dies kann dazu führen, dass der Pool seine gewünschte Größe nicht erreicht. Der Standardwert ist false. True, wenn die Kennzeichnung vorhanden ist.
Aktivieren sie den sicheren Start.
Aktivieren Sie vTPM.
Geben Sie an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.
Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um die Hostverschlüsselung für den virtuellen Computer oder die Skalierungsgruppe des virtuellen Computers zu aktivieren oder zu deaktivieren. Dadurch wird die Verschlüsselung für alle Datenträger einschließlich Ressourcen-/Temp-Datenträger auf dem Host selbst aktiviert. Das Standardverhalten lautet: Die Verschlüsselung auf dem Host wird deaktiviert, es sei denn, diese Eigenschaft ist für die Ressource auf "true" festgelegt.
Erforderlich. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen einschließlich Bindestrichen und Unterstrichen enthalten und darf nicht mehr als 64 Zeichen enthalten. Bei der ID wird die Groß-/Kleinschreibung beibehalten und die Groß-/Kleinschreibung nicht beachtet (d. h., Sie verfügen möglicherweise nicht über zwei Pool-IDs innerhalb eines Kontos, die sich nur nach Groß-/Kleinschreibung unterscheiden).
Referenz zu Betriebssystemimages. Dies kann entweder das Format "publisher:offer:sku[:version]" oder eine vollqualifizierte ARM-Bild-ID des Formulars "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}" sein. Wenn das Format "publisher:offer:sku[:version]" verwendet wird, ist die Version optional und wird verwendet, wenn sie nicht angegeben wird. Gültige Werte können über "az batchpool supported-images list" abgerufen werden. Beispiel: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".
Die Datei, die die Parameterspezifikation des Pools enthält, erstellt die Parameterspezifikation in JSON(formatiert für den Textkörper der REST-API-Anforderung). Wenn dieser Parameter angegeben ist, werden alle Parameterargumente für die Poolerstellung ignoriert. Siehe https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.
Der maximale Prozentsatz der gesamten Instanzen des virtuellen Computers, die gleichzeitig durch das rollierende Upgrade in einem Batch aktualisiert werden. Da dies ein Maximum ist, können fehlerhafte Instanzen in früheren oder zukünftigen Batches dazu führen, dass der Prozentsatz der Instanzen in einem Batch verringert wird, um eine höhere Zuverlässigkeit sicherzustellen. Der Wert dieses Felds sollte zwischen 5 und 100 (einschließlich) liegen. Wenn "maxBatchInstancePercent" und "maxUnhealthyInstancePercent" mit dem Wert zugewiesen sind, sollte der Wert von "maxBatchInstancePercent" nicht größer als "maxUnhealthyInstancePercent" sein.
Der maximale Prozentsatz der Instanzen des virtuellen Computers im Skalierungssatz, der gleichzeitig fehlerhaft sein kann, entweder aufgrund eines Upgrades oder durch die Integritätsprüfungen des virtuellen Computers in einem fehlerhaften Zustand gefunden wird, bevor das Rollupgrade abgebrochen wird. Diese Einschränkung wird vor dem Starten eines Batches überprüft. Der Wert dieses Felds sollte zwischen 5 und 100 (einschließlich) liegen. Wenn "maxBatchInstancePercent" und "maxUnhealthyInstancePercent" mit dem Wert zugewiesen sind, sollte der Wert von "maxBatchInstancePercent" nicht größer als "maxUnhealthyInstancePercent" sein.
Der maximale Prozentsatz der aktualisierten Virtuellen Computerinstanzen, die sich in einem fehlerhaften Zustand befinden. Diese Überprüfung erfolgt, nachdem jeder Batch aktualisiert wurde. Wenn dieser Prozentsatz jemals überschritten wird, wird das rollierende Update abgebrochen. Der Wert dieses Felds sollte zwischen 0 und 100 (einschließlich) liegen.
Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. Leerzeichentrennte Werte im Format "key=value".
Erforderlich. Der Batch Compute Node-Agent ist ein Programm, das auf jedem Computeknoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Computeknoten und dem Batchdienst bereitstellt. Es gibt unterschiedliche Implementierungen des Compute Node-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen eine Computeknoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten ComputeKnoten-Agent-SKUs sowie deren Liste der überprüften Imageverweise finden Sie unter "Liste unterstützter Computeknoten-Agent-SKUs".
Geben Sie die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None, ReadOnly, ReadWrite. Die Standardwerte sind: Keine für den Standardspeicher. ReadOnly für Premium-Speicher.
Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Betriebssystemdatenträgers.
Erforderlich. Mögliche Werte sind: 2 – Betriebssystemfamilie 2, entspricht Windows Server 2008 R2 SP1. 3 – Betriebssystemfamilie 3, entspricht Windows Server 2012. 4 – Betriebssystemfamilie 4, entspricht Windows Server 2012 R2. 5 – Betriebssystemfamilie 5, entspricht Windows Server 2016. 6 – Betriebssystemfamilie 6, entspricht Windows Server 2019. Weitere Informationen finden Sie unter Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).
Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an.
Die Wartezeit zwischen Abschluss des Updates für alle virtuellen Computer in einem Batch und starten den nächsten Batch. Die Zeitdauer sollte im ISO 8601-Format angegeben werden. Das erwartete Format ist eine ISO-8601-Dauer.
Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger für alle virtuellen Computer im Pool an. Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um den Speicherort auszuwählen, z. B. Cachespeicherplatz für die Bereitstellung ephemerer Betriebssystemdatenträger. Weitere Informationen zu den Anforderungen an ephemerale Betriebssystemdatenträgergrößen finden Sie unter Ephemeral os disk size requirements for Windows VMs at and Linux VMs at https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements.
Knotenplatzierungsrichtlinientyp in Batchpools. Zuordnungsrichtlinie, die vom Batchdienst zum Bereitstellen der Knoten verwendet wird. Wenn nicht angegeben, verwendet Batch die Regionalrichtlinie.
Aktualisieren Sie alle fehlerhaften Instanzen in einem Skalierungssatz, bevor alle fehlerfreien Instanzen auftreten. True, wenn die Kennzeichnung vorhanden ist.
Dieses Timeout gilt nur für die manuelle Skalierung; es hat keine Auswirkung, wenn enableAutoScale auf "true" festgelegt ist. Der Standardwert beträgt 15 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, gibt der Batchdienst einen Fehler zurück. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung). Das erwartete Format ist eine ISO-8601-Dauer.
Der Benutzer kann Ressourcentags für den Pool angeben. Alle ressourcen, die für den Pool erstellt wurden, werden dann auch mit den gleichen Ressourcentags markiert.
Fehler bei Rollbackinstanzen beim vorherigen Modell, wenn die Richtlinie für das Rollupgrade verletzt wird. True, wenn die Kennzeichnung vorhanden ist.
Geben Sie den SecurityType des virtuellen Computers an. Sie muss auf einen beliebigen angegebenen Wert festgelegt werden, um Uefi Einstellungen zu aktivieren. Das Standardverhalten lautet: Uefi Einstellungen wird nur aktiviert, wenn diese Eigenschaft festgelegt ist.
Erforderlich. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte sie einen relativen Pfad (relativ zum Arbeitsverzeichnis "Aufgabe") verwenden oder die vom Batch bereitgestellte Umgebungsvariable (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".
Gibt an, ob der Batchdienst warten soll, bis der StartTask erfolgreich abgeschlossen wurde (d. h. zum Beenden mit Beendigungscode 0), bevor Aufgaben auf dem Computeknoten geplant werden. Wenn "true" und "StartTask" auf einem Knoten fehlschlägt, wiederholt der Batchdienst die StartTask bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn die Aufgabe nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Knoten nicht verwendbar und plant keine Vorgänge. Diese Bedingung kann über den Computerknotenstatus und Fehlerinformationen erkannt werden. Wenn "false" lautet, wartet der Batchdienst nicht, bis der StartTask abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während der StartTask noch ausgeführt wird. und auch wenn der StartTask fehlschlägt, werden neue Aufgaben weiterhin auf dem Computeknoten geplant. Der Standardwert ist „true“. True, wenn die Kennzeichnung vorhanden ist.
Der Speicherkontotyp für verwaltete Datenträger.
Der gewünschte Knotenkommunikationsmodus für den Pool. Wenn dieses Element vorhanden ist, wird das vorhandene targetNodeCommunicationMode-Objekt ersetzt, das im Pool konfiguriert ist. Wenn keine Angabe erfolgt, bleiben vorhandene Metadaten unverändert.
Die gewünschte Anzahl dedizierter Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
Die gewünschte Anzahl von Computeknoten mit Spot-/Niedriger Priorität im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
Ohne Angabe werden keine Datenträger auf den Computeknoten im Pool verschlüsselt. Unter Linux-Pool wird nur "TemporaryDisk" unterstützt; unter Windows-Pool muss "OsDisk" und "TemporaryDisk" angegeben werden. Getrennter Speicherplatz für Zu verschlüsselnde Zieldatenträger. Werte können osDisk oder TemporaryDisk sein.
Die Anzahl von Taskslots, die verwendet werden können, um gleichzeitige Tasks auf einem einzelnen Computeknoten im Pool auszuführen. Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256.
Der Modus des Poolbetriebssystemupgrades.
Gibt an, ob die Rollupgraderichtlinie während des Automatischen Betriebssystemupgrades verwendet werden soll. Das automatische Betriebssystemupgrade wird auf die Standardrichtlinie zurückfallen, wenn keine Richtlinie für vmSS definiert ist. True, wenn die Kennzeichnung vorhanden ist.
Erforderlich. Informationen zu verfügbaren Größen virtueller Computer für Cloud Services Pools (mit CloudServiceConfiguration erstellte Pools) finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle VM-Größen der Clouddienste mit Ausnahme von ExtraSmall, A1V2 und A2V2. Informationen zu verfügbaren VM-Größen für Pools mit Images vom Virtual Machines Marketplace (pools created with virtualMachineConfiguration) finden Sie unter Größen für virtuelle Computer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für virtuelle Computer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie).
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch pool create (azure-batch-cli-extensions Erweiterung)
Erstellen Sie einen Batchpool in einem Konto. Wählen Sie beim Erstellen eines Pools Argumente aus der Cloud Services-Konfiguration oder der Virtuellen Computerkonfiguration aus.
az batch pool create [--account-endpoint]
[--account-key]
[--account-name]
[--application-licenses]
[--application-package-references]
[--auto-scale-formula]
[--certificate-references]
[--disk-encryption-targets]
[--enable-inter-node-communication]
[--id]
[--image]
[--json-file]
[--metadata]
[--node-agent-sku-id]
[--os-family]
[--os-version]
[--parameters]
[--policy]
[--resize-timeout]
[--resource-group]
[--start-task-command-line]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--template]
[--vm-size]
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Der Name des Batch-Kontos. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Die Liste der Anwendungslizenzen muss eine Teilmenge der verfügbaren Batchdienstanwendungslizenzen sein. Wenn eine Lizenz angefordert wird, die nicht unterstützt wird, schlägt die Poolerstellung fehl.
Beim Erstellen eines Pools muss die Anwendungs-ID des Pakets vollqualifizierte sein (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Änderungen an Paketverweise wirken sich auf alle neuen Knoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt wurden. Es gibt maximal 10 Paketverweise für einen bestimmten Pool.
Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "false" festgelegt ist. Es ist erforderlich, wenn enableAutoScale auf "true" festgelegt ist. Die Formel wird vor der Erstellung des Pools auf Gültigkeit überprüft. Wenn die Formel ungültig ist, lehnt der Batchdienst die Anforderung mit detaillierten Fehlerinformationen ab. Weitere Informationen zum Angeben dieser Formel finden Sie unter "Automatische Skalierung von Computeknoten in einem Azure-Batchpool" (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
Für Windows-Knoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis "Aufgabe" gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR wird der Aufgabe bereitgestellt, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von 'remoteUser' wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers erstellt (z. B. /home/{user-name}/certs) und Zertifikate in diesem Verzeichnis platziert. Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung .
Eine separate Leerzeichenliste von DiskEncryptionTargets. aktuelle mögliche Werte sind OsDisk und TemporaryDisk.
Gibt an, ob der Pool die direkte Kommunikation zwischen Computeknoten zulässt. Das Aktivieren der Kommunikation zwischen Knoten begrenzt die maximale Größe des Pools aufgrund von Bereitstellungseinschränkungen auf den Computeknoten des Pools. Dies kann dazu führen, dass der Pool seine gewünschte Größe nicht erreicht. Der Standardwert ist false.
Erforderlich. Die ID kann eine beliebige Kombination aus alphanumerischen Zeichen einschließlich Bindestrichen und Unterstrichen enthalten und darf nicht mehr als 64 Zeichen enthalten. Bei der ID wird die Groß-/Kleinschreibung beibehalten und die Groß-/Kleinschreibung nicht beachtet (d. h., Sie verfügen möglicherweise nicht über zwei Pool-IDs innerhalb eines Kontos, die sich nur nach Groß-/Kleinschreibung unterscheiden).
Referenz zu Betriebssystemimages. Dies kann entweder das Format "publisher:offer:sku[:version]" oder eine vollqualifizierte ARM-Bild-ID des Formulars "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}" sein. Wenn das Format "publisher:offer:sku[:version]" verwendet wird, ist die Version optional und wird verwendet, wenn sie nicht angegeben wird. Gültige Werte können über "az batchpool node-agent-skus list" abgerufen werden. Beispiel: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".
Die Datei, die den Pool enthält, der im JSON-Format erstellt werden soll, wenn dieser Parameter angegeben ist, werden alle anderen Parameter ignoriert.
Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen.
Die SKU des Batchknoten-Agents, der auf Computeknoten im Pool bereitgestellt werden soll. Der Batchknoten-Agent ist ein Programm, das auf jedem Knoten im Pool ausgeführt wird und die Befehls- und Steuerungsschnittstelle zwischen dem Knoten und dem Batchdienst bereitstellt. Es gibt verschiedene Implementierungen des Knoten-Agents (SKUs) für verschiedene Betriebssysteme. Sie müssen eine Knoten-Agent-SKU angeben, die dem ausgewählten Imageverweis entspricht. Informationen zum Abrufen der Liste der unterstützten Knoten-Agent-SKUs sowie deren Liste der überprüften Bildverweise finden Sie im Vorgang "Auflisten unterstützter Knoten-Agent-SKUs".
Die Azure-Gastbetriebssystemfamilie, die auf den virtuellen Computern im Pool installiert werden soll. Mögliche Werte sind: 2 – Betriebssystemfamilie 2, entspricht Windows Server 2008 R2 SP1. 3 – Betriebssystemfamilie 3, entspricht Windows Server 2012. 4 – Betriebssystemfamilie 4, entspricht Windows Server 2012 R2. 5 – Betriebssystemfamilie 5, entspricht Windows Server 2016. Weitere Informationen finden Sie unter Azure Guest OS Releases (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases). Zulässige Werte: 2, 3, 4, 5.
Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an.
Parameterwerte für eine JSON-Vorlagendatei für Batchpools. Kann nur mit --template verwendet werden.
Knotenplatzierungsrichtlinientyp in Batchpools. Zuordnungsrichtlinie, die vom Batchdienst zum Bereitstellen der Knoten verwendet wird. Wenn nicht angegeben, verwendet Batch die Regionalrichtlinie. Zulässige Werte: regional, zonal.
Dieses Timeout gilt nur für die manuelle Skalierung; es hat keine Auswirkung, wenn enableAutoScale auf "true" festgelegt ist. Der Standardwert beträgt 15 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, gibt der Batchdienst einen Fehler zurück. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).
Die Ressourcengruppe des Batchkontos.
Die Befehlszeile der Startaufgabe. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux.
Eine Liste der Dateien, die der Batchdienst vor dem Ausführen der Befehlszeile auf den Computeknoten herunterladen wird. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".
Gibt an, ob der Batchdienst warten soll, bis die Startaufgabe erfolgreich abgeschlossen wurde (d. h. zum Beenden mit Beendigungscode 0), bevor Vorgänge auf dem Computeknoten geplant werden. Wenn true und die Startaufgabe auf einem Computeknoten fehlschlägt, wiederholt der Batchdienst die Startaufgabe bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn der Vorgang nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Computeknoten nicht mehr verwendbar, und er plant keine Vorgänge. Diese Bedingung kann über den Knotenstatus und das Planungsfehlerdetails erkannt werden. Wenn false, wartet der Batchdienst nicht, bis die Startaufgabe abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während die Startaufgabe noch ausgeführt wird. und auch wenn der Startvorgang fehlschlägt, werden neue Vorgänge weiterhin auf dem Knoten geplant. Die Standardeinstellung ist „false“. True, wenn die Kennzeichnung vorhanden ist.
Die gewünschte Anzahl dedizierter Computeknoten im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
Die gewünschte Anzahl von Computeknoten mit Spot-/Niedriger Priorität im Pool. Diese Eigenschaft darf nicht angegeben werden, wenn enableAutoScale auf "true" festgelegt ist. Wenn "enableAutoScale" auf "false" festgelegt ist, müssen Sie entweder targetDedicatedNodes, targetLowPriorityNodes oder beides festlegen.
Ohne Angabe werden keine Datenträger auf den Computeknoten im Pool verschlüsselt. Unter Linux-Pool wird nur "TemporaryDisk" unterstützt; unter Windows-Pool muss "OsDisk" und "TemporaryDisk" angegeben werden. Getrennter Speicherplatz für Zu verschlüsselnde Zieldatenträger. Werte können osDisk oder TemporaryDisk sein.
Die Anzahl von Taskslots, die verwendet werden können, um gleichzeitige Tasks auf einem einzelnen Computeknoten im Pool auszuführen. Der Standardwert ist 1. Der Maximalwert ist kleiner als 4 Mal die Anzahl der Kerne der vmSize des Pools oder 256.
Eine JSON-Vorlagendatei für Batchpools. Wenn dieser Parameter angegeben ist, werden alle anderen Parameter ignoriert.
Erforderlich. Informationen zu verfügbaren Größen virtueller Computer für Cloud Services Pools (mit CloudServiceConfiguration erstellte Pools) finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle VM-Größen der Clouddienste mit Ausnahme von ExtraSmall, A1V2 und A2V2. Informationen zu verfügbaren VM-Größen für Pools mit Images vom Virtual Machines Marketplace (pools created with virtualMachineConfiguration) finden Sie unter Größen für virtuelle Computer (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) oder Größen für virtuelle Computer (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch unterstützt alle Azure VM-Größen außer STANDARD_A0 und denen mit Premiumspeicher (STANDARD_GS, STANDARD_DS und STANDARD_DSV2 Serie).
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch pool delete
Löscht einen Pool aus dem angegebenen Konto.
Wenn Sie anfordern, dass ein Pool gelöscht wird, treten die folgenden Aktionen auf: Der Poolstatus ist auf das Löschen festgelegt; alle laufenden Größenänderungsvorgänge im Pool werden beendet; Der Batchdienst startet die Größenänderung des Pools auf null Computeknoten; alle Aufgaben, die auf vorhandenen Computeknoten ausgeführt werden, werden beendet und erneut abgefragt (als ob ein Vorgang zur Größenänderung mit der Standardoption für die erneute Warteschlange angefordert wurde); schließlich wird der Pool aus dem System entfernt. Da die Ausführung von Aufgaben erneut abgefragt wird, kann der Benutzer diese Aufgaben erneut ausführen, indem er seinen Auftrag auf einen anderen Pool aktualisiert. Die Aufgaben können dann im neuen Pool ausgeführt werden. Wenn Sie das Verhalten der erneuten Warteschlange außer Kraft setzen möchten, sollten Sie die Größe des Pools explizit aufrufen, um die Größe des Pools auf null zu verkleinern, bevor Sie den Pool löschen. Wenn Sie eine Update-, Patch- oder Delete-API für einen Pool im Löschzustand aufrufen, schlägt sie mit dem HTTP-Statuscode 409 mit dem Fehlercode PoolBeingDeleted fehl.
az batch pool delete --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]
Erforderliche Parameter
Die ID des zu löschenden Pools.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Nicht zur Bestätigung auffordern
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch pool list
Listet alle Pools im angegebenen Konto auf.
az batch pool list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--select]
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Eine OData-$expand-Klausel.
Eine OData-$filter-Klausel. Weitere Informationen zum Erstellen dieses Filters finden Sie unter https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-pools.
Eine OData-$select-Klausel.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch pool reset
Dient zum Aktualisieren der Eigenschaften eines Batchpools. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardwerte zurückgesetzt.
az batch pool reset --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--certificate-references]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-wait-for-success]
Erforderliche Parameter
Die ID des zu aktualisierenden Pools.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Der Name des Batch-Kontos. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Erforderlich. Die Liste ersetzt alle vorhandenen Anwendungspaketverweise im Pool. Änderungen an Anwendungspaketverweise wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages aktualisiert werden. Es gibt maximal 10 Anwendungspaketverweise für einen bestimmten Pool. Wenn Sie keine leere Auflistung angeben, werden alle vorhandenen Anwendungspaketeverweise aus dem Pool entfernt. Für einen bestimmten Pool können maximal 10 Verweise angegeben werden.
Erforderlich. Diese Liste ersetzt alle vorhandenen Zertifikatverweise, die im Pool konfiguriert sind. Wenn Sie eine leere Auflistung angeben, werden alle vorhandenen Zertifikatverweise aus dem Pool entfernt. Für Windows-Knoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis "Aufgabe" gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR wird der Aufgabe bereitgestellt, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von 'remoteUser' wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers erstellt (z. B. /home/{user-name}/certs) und Zertifikate in diesem Verzeichnis platziert. Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung .
Die Datei, die die Parameterspezifikation für Poolaktualisierungseigenschaften in JSON(formatiert für den Textkörper der REST-API-Anforderung) enthält. Wenn dieser Parameter angegeben ist, werden alle Parameterargumente für poolupdates ignoriert.
Erforderlich. Diese Liste ersetzt alle vorhandenen Metadaten, die im Pool konfiguriert sind. Wenn Sie keine leere Auflistung angeben, werden vorhandene Metadaten aus dem Pool entfernt.
Die Befehlszeile der Startaufgabe. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux.
Eine Liste der Umgebungsvariableneinstellungen für die Startaufgabe. Leerzeichentrennte Werte im Format "key=value".
Gibt an, wie oft der Task maximal wiederholt werden kann.
Gibt an, ob der Batchdienst warten soll, bis die Startaufgabe erfolgreich abgeschlossen wurde (d. h. zum Beenden mit Beendigungscode 0), bevor Vorgänge auf dem Computeknoten geplant werden. True, wenn die Kennzeichnung vorhanden ist, andernfalls ist "False" standardmäßig festgelegt.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch pool resize
Ändern der Größe oder Beenden der Größe eines Batchpools
az batch pool resize --pool-id
[--abort]
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
[--resize-timeout]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
Erforderliche Parameter
Die ID des Pools.
Optionale Parameter
Beenden Sie den Vorgang zum Ändern der Größe des Pools.
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Der Name des Batch-Kontos. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource exakt mit dem angegebenen Wert übereinstimmt.
Der Vorgang wird nur ausgeführt, wenn die Ressource seit dem angegebenen Zeitstempel geändert wurde.
Der Vorgang wird nicht nur ausgeführt, wenn das aktuelle ETag der Ressource exakt mit dem angegebenen Wert übereinstimmt.
Der Vorgang wird nicht nur ausgeführt, wenn die Ressource seit dem angegebenen Zeitstempel geändert wurde.
Wenn Knoten möglicherweise aus dem Pool entfernt werden, wenn die Poolgröße abnimmt.
Der Standardwert beträgt 15 Minuten. Der Mindestwert beträgt 5 Minuten. Wenn Sie einen Wert kleiner als 5 Minuten angeben, gibt der Batchdienst einen Fehler zurück. wenn Sie die REST-API direkt aufrufen, lautet der HTTP-Statuscode 400 (Ungültige Anforderung).
Die gewünschte Anzahl dedizierter Computeknoten im Pool.
Die gewünschte Anzahl von Computeknoten mit Spot-/Niedriger Priorität im Pool.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch pool set
Dient zum Aktualisieren der Eigenschaften eines Batchpools. Durch das Aktualisieren einer Eigenschaft in einer Untergruppe werden die nicht angegebenen Eigenschaften dieser Gruppe zurückgesetzt.
az batch pool set --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--certificate-references]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-communication {classic, default, simplified}]
Erforderliche Parameter
Die ID des zu aktualisierenden Pools.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Änderungen an Paketverweise wirken sich auf alle neuen Knoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die sich bereits im Pool befinden, bis sie neu gestartet oder umimages neu erstellt wurden. Wenn dieses Element vorhanden ist, werden alle vorhandenen Paketverweise ersetzt. Wenn Sie eine leere Auflistung angeben, werden alle Paketverweise aus dem Pool entfernt. Ohne Angabe bleiben vorhandene Paketverweise unverändert. Leerzeichentrennte Anwendungs-IDs mit optionaler Version im Format "id[#version]".
Wenn dieses Element vorhanden ist, werden vorhandene Zertifikatverweise ersetzt, die im Pool konfiguriert sind. Wenn nicht angegeben, bleiben vorhandene Zertifikatverweise unverändert. Für Windows-Knoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -speicherort. Bei Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis "Aufgabe" gespeichert, und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR wird der Aufgabe bereitgestellt, um diesen Speicherort abzufragen. Für Zertifikate mit Sichtbarkeit von 'remoteUser' wird ein Verzeichnis "certs" im Startverzeichnis des Benutzers erstellt (z. B. /home/{user-name}/certs) und Zertifikate in diesem Verzeichnis platziert. Warnung: Diese Eigenschaft ist veraltet und wird nach Februar 2024 entfernt. Verwenden Sie stattdessen die Azure KeyVault-Erweiterung . Durch Leerzeichen getrennte Zertifikatfingerabdrücke.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Eine Datei mit der Spezifikation des Poolpatchparameters in JSON (formatiert für den jeweiligen REST-API-Textkörper). Wenn dieser Parameter angegeben ist, werden alle 'Poolargumente' ignoriert.
Wenn dieses Element vorhanden ist, ersetzt es vorhandene Metadaten, die im Pool konfiguriert sind. Wenn Sie eine leere Auflistung angeben, werden alle Metadaten aus dem Pool entfernt. Wenn keine Angabe erfolgt, bleiben vorhandene Metadaten unverändert. Leerzeichentrennte Werte im Format "key=value".
Erforderlich. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung der Umgebungsvariablen profitieren. Wenn Sie diese Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mit "cmd /c MyCommand" in Windows oder "/bin/sh -c MyCommand" in Linux. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte sie einen relativen Pfad (relativ zum Arbeitsverzeichnis "Aufgabe") verwenden oder die vom Batch bereitgestellte Umgebungsvariable (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).
Leerzeichentrennte Werte im Format "key=value".
Die maximale Anzahl der Wiederholungsversuche des Vorgangs. Der Batchdienst ruft eine Aufgabe erneut auf, wenn der Beendigungscode nicht null ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batchdienst versucht die Aufgabe einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn die maximale Wiederholungsanzahl beispielsweise 3 ist, versucht Batch die Aufgabe bis zu 4 Mal (ein erster Versuch und 3 Wiederholungsversuche). Wenn die maximale Wiederholungsanzahl 0 ist, wird der Batchdienst den Vorgang nicht wiederholen. Wenn die maximale Wiederholungsanzahl -1 ist, wiederholt der Batchdienst den Vorgang ohne Beschränkung, dies wird jedoch nicht für einen Startvorgang oder einen Vorgang empfohlen. Der Standardwert ist 0 (keine Wiederholungsversuche).
Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".
Gibt an, ob der Batchdienst warten soll, bis der StartTask erfolgreich abgeschlossen wurde (d. h. zum Beenden mit Beendigungscode 0), bevor Aufgaben auf dem Computeknoten geplant werden. Wenn "true" und "StartTask" auf einem Knoten fehlschlägt, wiederholt der Batchdienst die StartTask bis zur maximalen Wiederholungsanzahl (maxTaskRetryCount). Wenn die Aufgabe nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Knoten nicht verwendbar und plant keine Vorgänge. Diese Bedingung kann über den Computerknotenstatus und Fehlerinformationen erkannt werden. Wenn "false" lautet, wartet der Batchdienst nicht, bis der StartTask abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung auf dem Computeknoten beginnen, während der StartTask noch ausgeführt wird. und auch wenn der StartTask fehlschlägt, werden neue Aufgaben weiterhin auf dem Computeknoten geplant. Der Standardwert ist „true“. Geben Sie entweder 'true' oder 'false' an, um die Eigenschaft zu aktualisieren.
Der gewünschte Knotenkommunikationsmodus für den Pool. Wenn dieses Element vorhanden ist, wird das vorhandene targetNodeCommunicationMode-Objekt ersetzt, das im Pool konfiguriert ist. Wenn keine Angabe erfolgt, bleiben vorhandene Metadaten unverändert.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az batch pool show
Ruft Informationen zum angegebenen Pool ab.
az batch pool show --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--select]
Erforderliche Parameter
Die ID des abzurufenden Pools.
Optionale Parameter
Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.
Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.
Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.
Eine OData-$expand-Klausel.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst exakt mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt geändert wurde.
Ein ETag-Wert, der der Version der Ressource zugeordnet ist, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource für den Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.
Ein Zeitstempel, der die uhrzeit der letzten Änderung der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.
Eine OData-$select-Klausel.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID
konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.