Freigeben über


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

--accelerated-networking

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.

Zulässige Werte: false, true
--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--application-licenses

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.

--application-package-references

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

--auto-scale-formula

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

--certificate-references

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.

--defer-os-rolling-upgrade

Verzögern Sie Betriebssystemupgrades auf tvMs, wenn sie Aufgaben ausführen. True, wenn die Kennzeichnung vorhanden ist.

Zulässige Werte: false, true
--disable-auto-rollback

Gibt an, ob das Rollbackfeature des Betriebssystemimages deaktiviert werden soll. True, wenn die Kennzeichnung vorhanden ist.

Zulässige Werte: false, true
--disk-encryption-targets

Eine durch Leerzeichen getrennte Liste von DiskEncryptionTargets. aktuelle mögliche Werte sind OsDisk und TemporaryDisk.

--enable-auto-os-upgrade

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.

Zulässige Werte: false, true
--enable-cross-zone-upgrade

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.

Zulässige Werte: false, true
--enable-inter-node-communication

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.

--enable-secure-boot

Aktivieren sie den sicheren Start.

Zulässige Werte: false, true
--enable-vtpm

Aktivieren Sie vTPM.

Zulässige Werte: false, true
--enable-write-accel

Geben Sie an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.

Zulässige Werte: false, true
--encryption-at-host

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.

Zulässige Werte: false, true
--id

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

--image

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

--json-file

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.

--max-batch-instance-percent

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.

--max-unhealthy-instance-percent

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.

--max-unhealthy-upgraded-instance-percent

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.

--metadata

Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen. Leerzeichentrennte Werte im Format "key=value".

--node-agent-sku-id

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

--os-disk-caching

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.

Zulässige Werte: none, readonly, readwrite
--os-disk-size

Die anfängliche Datenträgergröße in GB beim Erstellen eines neuen Betriebssystemdatenträgers.

--os-family

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

Zulässige Werte: 2, 3, 4, 5, 6
--os-version

Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an.

--pause-time-between-batches

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.

--placement

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.

Zulässige Werte: cachedisk
--policy

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
--prioritize-unhealthy-instances

Aktualisieren Sie alle fehlerhaften Instanzen in einem Skalierungssatz, bevor alle fehlerfreien Instanzen auftreten. True, wenn die Kennzeichnung vorhanden ist.

Zulässige Werte: false, true
--resize-timeout

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.

--resource-tags

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.

--rollback-failed-instances-on-policy-breach

Fehler bei Rollbackinstanzen beim vorherigen Modell, wenn die Richtlinie für das Rollupgrade verletzt wird. True, wenn die Kennzeichnung vorhanden ist.

Zulässige Werte: false, true
--security-type

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.

--start-task-command-line

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

--start-task-resource-files

Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".

--start-task-wait-for-success

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.

--storage-account-type

Der Speicherkontotyp für verwaltete Datenträger.

Zulässige Werte: premium_lrs, standard_lrs, standardssd_lrs
--target-communication

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.

Zulässige Werte: classic, default, simplified
--target-dedicated-nodes

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.

--target-low-priority-nodes

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.

--targets

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.

--task-slots-per-node

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.

--upgrade-policy-mode

Der Modus des Poolbetriebssystemupgrades.

Zulässige Werte: automatic, manual, rolling
--use-rolling-upgrade-policy

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.

Zulässige Werte: false, true
--vm-size

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

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

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Der Name des Batch-Kontos. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--application-licenses

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.

--application-package-references

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.

--auto-scale-formula

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

--certificate-references

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 .

--disk-encryption-targets

Eine separate Leerzeichenliste von DiskEncryptionTargets. aktuelle mögliche Werte sind OsDisk und TemporaryDisk.

--enable-inter-node-communication

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.

Standardwert: False
--id

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

--image

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

--json-file

Die Datei, die den Pool enthält, der im JSON-Format erstellt werden soll, wenn dieser Parameter angegeben ist, werden alle anderen Parameter ignoriert.

--metadata

Der Batchdienst weist Metadaten keine Bedeutung zu; sie ist ausschließlich für die Verwendung von Benutzercode vorgesehen.

--node-agent-sku-id

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

--os-family

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.

--os-version

Der Standardwert ist * und gibt die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie an.

--parameters

Parameterwerte für eine JSON-Vorlagendatei für Batchpools. Kann nur mit --template verwendet werden.

--policy

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.

--resize-timeout

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

--resource-group

Die Ressourcengruppe des Batchkontos.

--start-task-command-line

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.

--start-task-resource-files

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

--start-task-wait-for-success

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.

Standardwert: False
--target-dedicated-nodes

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.

--target-low-priority-nodes

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.

--targets

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.

--task-slots-per-node

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.

--template

Eine JSON-Vorlagendatei für Batchpools. Wenn dieser Parameter angegeben ist, werden alle anderen Parameter ignoriert.

--vm-size

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

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

--pool-id

Die ID des zu löschenden Pools.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--if-match

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.

--if-modified-since

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.

--if-none-match

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.

--if-unmodified-since

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.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

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

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--expand

Eine OData-$expand-Klausel.

--filter

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.

--select

Eine OData-$select-Klausel.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

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

--pool-id

Die ID des zu aktualisierenden Pools.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Der Name des Batch-Kontos. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--application-package-references

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.

--certificate-references

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 .

--json-file

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.

--metadata

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.

--start-task-command-line

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.

--start-task-environment-settings

Eine Liste der Umgebungsvariableneinstellungen für die Startaufgabe. Leerzeichentrennte Werte im Format "key=value".

--start-task-max-task-retry-count

Gibt an, wie oft der Task maximal wiederholt werden kann.

--start-task-wait-for-success

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

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

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

--pool-id

Die ID des Pools.

Optionale Parameter

--abort

Beenden Sie den Vorgang zum Ändern der Größe des Pools.

Standardwert: False
--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Der Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Der Name des Batch-Kontos. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--if-match

Der Vorgang wird nur ausgeführt, wenn das aktuelle ETag der Ressource exakt mit dem angegebenen Wert übereinstimmt.

--if-modified-since

Der Vorgang wird nur ausgeführt, wenn die Ressource seit dem angegebenen Zeitstempel geändert wurde.

--if-none-match

Der Vorgang wird nicht nur ausgeführt, wenn das aktuelle ETag der Ressource exakt mit dem angegebenen Wert übereinstimmt.

--if-unmodified-since

Der Vorgang wird nicht nur ausgeführt, wenn die Ressource seit dem angegebenen Zeitstempel geändert wurde.

--node-deallocation-option

Wenn Knoten möglicherweise aus dem Pool entfernt werden, wenn die Poolgröße abnimmt.

Zulässige Werte: requeue, retaineddata, taskcompletion, terminate
--resize-timeout

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

--target-dedicated-nodes

Die gewünschte Anzahl dedizierter Computeknoten im Pool.

--target-low-priority-nodes

Die gewünschte Anzahl von Computeknoten mit Spot-/Niedriger Priorität im Pool.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

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

--pool-id

Die ID des zu aktualisierenden Pools.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--application-package-references

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

--certificate-references

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.

--if-match

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.

--if-modified-since

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.

--if-none-match

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.

--if-unmodified-since

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.

--json-file

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.

--metadata

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

--start-task-command-line

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

--start-task-environment-settings

Leerzeichentrennte Werte im Format "key=value".

--start-task-max-task-retry-count

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

--start-task-resource-files

Unter diesem Element aufgelistete Dateien befinden sich im Arbeitsverzeichnis der Aufgabe. Durch Leerzeichen getrennte Ressourcenverweise im Format "filename=httpurl".

--start-task-wait-for-success

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.

--target-communication

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.

Zulässige Werte: classic, default, simplified
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

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

--pool-id

Die ID des abzurufenden Pools.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie nach Umgebungsvariablen festlegen: AZURE_BATCH_ACCOUNT.

--expand

Eine OData-$expand-Klausel.

--if-match

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.

--if-modified-since

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.

--if-none-match

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.

--if-unmodified-since

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.

--select

Eine OData-$select-Klausel.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.