az batch pool

Verwalten von Batchpools.

Befehle

az batch pool all-statistics

Zeigen Sie Statistiken aller Pools unter einem Batchkonto an.

az batch pool all-statistics show

Abrufen von Zusammenfassungsstatistiken für alle Pools in einem Batchkonto.

az batch pool autoscale

Verwalten der automatischen Skalierung von Batchpools.

az batch pool autoscale disable

Deaktiviert die automatische Skalierung für einen Pool.

az batch pool autoscale enable

Aktiviert die automatische Skalierung für einen Pool.

az batch pool autoscale evaluate

Ruft das Ergebnis der Auswertung einer automatischen Skalierungsformel im Pool ab.

az batch pool create

Erstellen Sie einen Batchpool in einem Konto. Wählen Sie beim Erstellen eines Pools Argumente aus Cloud Services Konfiguration oder Konfiguration virtueller Computer aus.

az batch pool delete

Löscht einen Pool aus dem angegebenen Konto.

az batch pool list

Listet alle Pools im angegebenen Konto auf.

az batch pool node-counts

Abrufen von Knotenanzahlen für Batchpools

az batch pool node-counts list

Ruft die Anzahl der Computeknoten in jedem Zustand ab, gruppiert nach Pool.

az batch pool reset

Aktualisieren der Eigenschaften eines Batchpools. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardwerte zurückgesetzt.

az batch pool resize

Ändern der Größe oder Beenden der Größe eines Batchpools

az batch pool set

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 show

Ruft Informationen zum angegebenen Pool ab.

az batch pool supported-images

Abfrageinformationen zu VM-Images, die von Azure Batch Dienst unterstützt werden.

az batch pool supported-images list

Listet alle virtuellen Computerimages auf, die vom Azure Batch-Dienst unterstützt werden.

az batch pool usage-metrics

Anzeigen von Nutzungsmetriken von Batchpools

az batch pool usage-metrics list

Listet die Nutzungsmetriken auf, aggregiert nach Pool in einzelnen Zeitintervallen für das angegebene Konto.

az batch pool create

Erstellen Sie einen Batchpool in einem Konto. Wählen Sie beim Erstellen eines Pools Argumente aus entweder Cloud Services Konfiguration oder virtuelle 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 {2, 3, 4, 5, 6}]
                     [--os-version]
                     [--policy {regional, zonal}]
                     [--resize-timeout]
                     [--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]
                     [--vm-size]

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable 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. Leerzeichentrennte Werte.

--application-package-references

Änderungen an Paketbezügen wirken sich auf alle neuen Knoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Computeknoten aus, die bereits im Pool vorhanden sind, bis sie neu gestartet oder umimaget werden. Es gibt maximal 10 Paketverweise für einen bestimmten Pool. Leertrennte 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 auf Gültigkeit überprüft, bevor der Pool erstellt wird. 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. Für Linux-Computeknoten werden die Zertifikate in einem Verzeichnis im Arbeitsverzeichnis "Vorgang" 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 (z. B. /home/{user-name}/certs) und Zertifikate in diesem Verzeichnis platziert. Leertrennte Zertifikatfingerabdrücke.

--disk-encryption-targets

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

--enable-inter-node-communication

Gibt an, ob der Pool die direkte Kommunikation zwischen ComputeKnoten zulässt. Durch das Aktivieren der Interknotenkommunikation wird die maximale Größe des Pools aufgrund von Bereitstellungseinschränkungen für die Computeknoten des Pools begrenzt. Dies kann dazu führen, dass der Pool seine gewünschte Größe nicht erreicht. Der Standardwert ist „FALSE“. True, wenn flag vorhanden ist.

--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. Die ID ist bei der Groß- und Kleinschreibung erhalten (das heißt, Sie verfügen möglicherweise nicht über zwei Pool-IDs innerhalb eines Kontos, die sich nur nach Groß-/Kleinschreibung unterscheiden).

--image

Betriebssystemimagereferenz. Dies kann entweder das Format "publisher:offer:sku[:version]" oder eine vollqualifizierte ARM-Bild-ID des Formulars "/abonnements/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName}" sein. Wenn das Format "publisher:offer:sku[:version]" aktiviert ist, ist die Version optional und wird nicht verwendet. Gültige Werte können über "az batchpool supported-images list" abgerufen werden. Beispiel: "MicrosoftWindowsServer:WindowsServer:2012-R2-Datacenter:latest".

--json-file

Die Datei mit pool create properties parameter specification in JSON(formatiert to match REST API request body). Wenn dieser Parameter angegeben ist, werden alle Parameterargumente des Pools erstellt. Siehe https://docs.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#request-body.

--metadata

Der Batchdienst weist keine Bedeutung für Metadaten zu; es 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 stellt die Befehls- und Steuerungsschnittstelle zwischen dem Computeknoten und dem Batchdienst bereit. Es gibt verschiedene Implementierungen des Compute Node-Agents, die als SKUs bezeichnet werden, für verschiedene Betriebssysteme. Sie müssen einen Compute Node-Agent-SKU angeben, der dem ausgewählten Bildverweis entspricht. Informationen zum Abrufen der Liste der unterstützten Compute Node-Agent-SKUs zusammen mit der Liste der überprüften Bildbezüge finden Sie im Vorgang "Liste unterstützter ComputeKnoten-Agent-SKUs".

--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 * , der die neueste Betriebssystemversion für die angegebene Betriebssystemfamilie angibt.

--policy

Knotenplatzierungsrichtlinientyp für Batchpools. Zuordnungsrichtlinie, die von Batchdienst verwendet wird, um die Knoten bereitzustellen. Falls nicht angegeben, wird Batch die Regionalrichtlinie verwenden.

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, ist der HTTP-Statuscode 400 (Bad Request). Das erwartete Format ist eine ISO-8601-Dauer.

--start-task-command-line

Erforderlich. Die Befehlszeile wird nicht unter einer Shell ausgeführt und kann daher nicht von Shellfeatures wie der Erweiterung von Umgebungsvariablen profitieren. Wenn Sie solche Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mithilfe von "cmd /c MyCommand" in Windows oder "/bin/bin-c MyCommand" in Linux. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte ein relativer Pfad (relativ zum Arbeitsverzeichnis "Vorgang") verwendet werden, oder verwenden Sie die bereitgestellte Batch-Umgebungsvariable (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--start-task-resource-files

Dateien, die unter diesem Element aufgeführt sind, befinden sich im Arbeitsverzeichnis des Vorgangs. Leergetrennte Ressourcenbezüge im Dateiname=httpurl-Format.

--start-task-wait-for-success

Ob der Batchdienst auf den Erfolgreichen Abschluss des StartTask warten sollte (das heißt, beenden Sie den Exitcode 0), bevor Sie Vorgänge auf dem Computeknoten planen. Wenn "true" und "StartTask" auf einem Knoten fehlschlägt, ruft der Batchdienst die StartTask auf die maximale Wiederholungsanzahl (maxTaskRetryCount) zurück. Wenn der Vorgang nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Knoten unbrauchbar, und die Aufgaben werden nicht geplant. Diese Bedingung kann über den Compute-Knotenstatus und Fehlerinformationen ermittelt werden. Wenn falsch, wartet der Batchdienst nicht darauf, dass die StartTask abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung des Compute-Knotens beginnen, während der StartTask noch ausgeführt wird; und selbst wenn der StartTask fehlschlägt, werden weiterhin neue Aufgaben im Compute-Knoten geplant. Der Standardwert ist „true“. True, wenn das Flag vorhanden ist.

--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 Spot/Low-Priority Compute Nodes 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

Wenn nicht angegeben, werden keine Datenträger auf den Computeknoten im Pool verschlüsselt. Auf Linux-Pool wird nur "TemporäreDisk" unterstützt; unter Windows-Pool muss "OsDisk" und "TemporäreDisk" angegeben werden. Leerzeichen getrennte Zieldatenträger, die verschlüsselt werden sollen. Werte können entweder OsDisk oder TemporäreDisk 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 maximale Wert ist die kleiner von 4 Mal die Anzahl der Kerne des vmSize-Pools oder 256.

--vm-size

Erforderlich. Informationen zu verfügbaren Größen von virtuellen Computern für Cloud Services Pools (Pools, die mit cloudServiceConfiguration erstellt wurden), finden Sie unter Größen für Cloud Services (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch unterstützt alle Cloud Services VM-Größen außer ExtraSmall, A1V2 und A2V2. Informationen zu verfügbaren VM-Größen für Pools mit Images aus dem Virtual Machines Marketplace (Pools, die mit virtualMachineConfiguration erstellt wurden) finden Sie unter Größen für Virtual Machines (Linux) () oder Größen für Virtual Machines (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/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).

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 wird auf das Löschen festgelegt; alle laufenden Größenänderungen im Pool werden beendet; der Batchdienst startet die Größe des Pools auf null Compute-Knoten; Alle Vorgänge, die auf vorhandenen Compute-Knoten ausgeführt werden, werden beendet und erneut queuiert (wie wenn ein Ändern der Größe des Poolvorgangs mit der Standardoption "Requeue" angefordert wurde); schließlich wird der Pool aus dem System entfernt. Da die Ausführung von Vorgängen requeuiert wird, kann der Benutzer diese Vorgänge erneut ausführen, indem er seinen Auftrag aktualisiert, um auf einen anderen Pool zu abzielen. Die Aufgaben können dann im neuen Pool ausgeführt werden. Wenn Sie das erneute Verhalten außer Kraft setzen möchten, sollten Sie die Größe des Pools explizit aufrufen, um den Pool explizit zu verkleinern, bevor Sie den Pool löschen. Wenn Sie eine Update-, Patch- oder Delete-API auf einem Pool im Löschenstatus aufrufen, schlägt es 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 ZU löschende ID des Pools.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable 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 im Dienst genau dem vom Client angegebenen Wert entspricht.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im 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 des Diensts nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.

--yes -y

Nicht zur Bestätigung auffordern

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 eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable 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.

az batch pool reset

Aktualisieren sie die Eigenschaften eines Batchpools. Nicht angegebene Eigenschaften, die aktualisiert werden können, werden auf ihre Standardeinstellungen 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 eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Der Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Der Name des Batch-Kontos. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--application-package-references

Erforderlich. Die Liste ersetzt alle vorhandenen Anwendungspaketbezüge im Pool. Änderungen an Anwendungspaketbezügen wirken sich auf alle neuen Computeknoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Compute-Knoten aus, die bereits im Pool vorhanden sind, bis sie neu gestartet oder neu dargestellt werden. Es gibt maximal 10 Anwendungspaketbezüge auf einem bestimmten Pool. Wenn Sie eine leere Auflistung angeben, werden alle vorhandenen Anwendungspakete aus dem Pool entfernt. Maximal 10 Verweise können auf einem bestimmten Pool angegeben werden.

--certificate-references

Erforderlich. Diese Liste ersetzt alle vorhandenen Zertifikatbezüge, die im Pool konfiguriert sind. Wenn Sie eine leere Auflistung angeben, werden vorhandene Zertifikatbezüge aus dem Pool entfernt. Für Windows-Knoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -Speicherort. Für Linux-Computeknoten werden die Zertifikate in einem Verzeichnis innerhalb des Arbeitsverzeichniss "Vorgang" gespeichert und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR wird dem Vorgang zur Abfrage für diesen Speicherort bereitgestellt. Bei Zertifikaten mit Sichtbarkeit von "remoteUser" wird ein "Certs"-Verzeichnis im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) und Zertifikate in diesem Verzeichnis platziert.

--json-file

Die Datei mit der Parameterspezifikation für Poolupdateeigenschaften in JSON(formatiert, um dem REST-API-Anforderungstext zu entsprechen). Wenn dieser Parameter angegeben wird, werden alle "Parameterargumente für Poolupdates" ignoriert.

--metadata

Erforderlich. Diese Liste ersetzt alle vorhandenen Metadaten, die im Pool konfiguriert sind. Wenn Sie eine 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 von Umgebungsvariablen profitieren. Wenn Sie solche Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mithilfe von "cmd /c MyCommand" in Windows oder "/bin/bin-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

Ob der Batchdienst auf den erfolgreichen Abschluss des Startvorgangs warten sollte (das heißt, beenden Sie den Exitcode 0), bevor Sie Vorgänge auf dem Berechnungsknoten planen. True, wenn das Flag vorhanden ist, andernfalls standardmäßig "False".

az batch pool resize

Ändern 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 die Größe des Pools.

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Der Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Der Name des Batch-Kontos. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--if-match

Der Vorgang wird nur ausgeführt, wenn der aktuelle ETag der Ressource genau dem angegebenen Wert entspricht.

--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 der aktuelle ETag der Ressource genau dem angegebenen Wert entspricht.

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

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, ist der HTTP-Statuscode 400 (Bad Request).

--target-dedicated-nodes

Die gewünschte Anzahl dedizierter Computeknoten im Pool.

--target-low-priority-nodes

Die gewünschte Anzahl von Spot/Low-Priority Compute Nodes im Pool.

az batch pool set

Aktualisieren sie die Eigenschaften eines Batchpools. Das Aktualisieren einer Eigenschaft in einer Untergruppe setzt die nicht angegebenen Eigenschaften dieser Gruppe zurück.

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]

Erforderliche Parameter

--pool-id

Die ID des Zu aktualisierenden Pools.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCOUNT.

--application-package-references

Änderungen an Paketbezügen wirken sich auf alle neuen Knoten aus, die dem Pool beitreten, wirken sich jedoch nicht auf Compute-Knoten aus, die bereits im Pool vorhanden sind, bis sie neu gestartet oder neu dargestellt werden. Wenn dieses Element vorhanden ist, ersetzt es alle vorhandenen Paketbezüge. Wenn Sie eine leere Auflistung angeben, werden alle Paketbezüge aus dem Pool entfernt. Falls nicht angegeben, bleiben vorhandene Paketbezüge unverändert. Leergetrennte Anwendungs-IDs mit optionaler Version im Format 'id[#version]'.

--certificate-references

Wenn dieses Element vorhanden ist, ersetzt es alle vorhandenen Zertifikatbezüge, die im Pool konfiguriert sind. Falls nicht angegeben, bleiben vorhandene Zertifikatbezüge unverändert. Für Windows-Knoten installiert der Batchdienst die Zertifikate im angegebenen Zertifikatspeicher und -Speicherort. Für Linux-Computeknoten werden die Zertifikate in einem Verzeichnis innerhalb des Arbeitsverzeichniss "Vorgang" gespeichert und eine Umgebungsvariable AZ_BATCH_CERTIFICATES_DIR wird dem Vorgang zur Abfrage für diesen Speicherort bereitgestellt. Bei Zertifikaten mit Sichtbarkeit von "remoteUser" wird ein "Certs"-Verzeichnis im Startverzeichnis des Benutzers (z. B. /home/{user-name}/certs) und Zertifikate in diesem Verzeichnis platziert. Leergetrennte Zertifikat-Daumendrucke.

--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 im Dienst genau dem vom Client angegebenen Wert entspricht.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im 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 des Diensts nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource im Dienst seit dem angegebenen Zeitpunkt nicht geändert wurde.

--json-file

Eine Datei mit der Spezifikation des Pool-Patchparameters in JSON (formatiert, um dem jeweiligen REST-API-Textkörper zu entsprechen). Wenn dieser Parameter angegeben wird, werden alle "Poolargumente" ignoriert.

--metadata

Wenn dieses Element vorhanden ist, ersetzt es alle vorhandenen Metadaten, die im Pool konfiguriert sind. Wenn Sie eine leere Auflistung angeben, werden alle Metadaten aus dem Pool entfernt. Falls nicht angegeben, bleibt jede 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 von Umgebungsvariablen profitieren. Wenn Sie solche Features nutzen möchten, sollten Sie die Shell in der Befehlszeile aufrufen, z. B. mithilfe von "cmd /c MyCommand" in Windows oder "/bin/bin-c MyCommand" in Linux. Wenn sich die Befehlszeile auf Dateipfade bezieht, sollte ein relativer Pfad (relativ zum Arbeitsverzeichnis "Vorgang") verwendet werden, oder verwenden Sie die bereitgestellte Batch-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 Zeiten, in denen der Vorgang erneut ausgeführt werden kann. Der Batchdienst ruft einen Vorgang zurück, wenn sein Exitcode nicht zero ist. Beachten Sie, dass dieser Wert die Anzahl der Wiederholungen ausdrücklich steuert. Der Batchdienst versucht den Vorgang einmal, und kann dann bis zu diesem Grenzwert erneut versuchen. Wenn beispielsweise die maximale Wiederholungsanzahl 3 beträgt, versucht Batch die Aufgabe bis zu 4 Mal (ein anfänglicher Versuch und 3 Wiederholungen). Wenn die maximale Wiederholungsanzahl 0 ist, wird der Batchdienst den Vorgang nicht erneut wiederholen. Wenn die maximale Wiederholungsanzahl -1 lautet, wird der Batchdienst den Vorgang ohne Begrenzung erneut zurückverwenden.

--start-task-resource-files

Dateien, die unter diesem Element aufgeführt sind, befinden sich im Arbeitsverzeichnis des Vorgangs. Leergetrennte Ressourcenbezüge im Dateiname=httpurl-Format.

--start-task-wait-for-success

Ob der Batchdienst auf den Erfolgreichen Abschluss des StartTask warten sollte (das heißt, beenden Sie den Exitcode 0), bevor Sie Vorgänge auf dem Computeknoten planen. Wenn "true" und "StartTask" auf einem Knoten fehlschlägt, ruft der Batchdienst die StartTask auf die maximale Wiederholungsanzahl (maxTaskRetryCount) zurück. Wenn der Vorgang nach allen Wiederholungen noch nicht erfolgreich abgeschlossen wurde, markiert der Batchdienst den Knoten unbrauchbar, und die Aufgaben werden nicht geplant. Diese Bedingung kann über den Compute-Knotenstatus und Fehlerinformationen ermittelt werden. Wenn falsch, wartet der Batchdienst nicht darauf, dass die StartTask abgeschlossen ist. In diesem Fall können andere Aufgaben mit der Ausführung des Compute-Knotens beginnen, während der StartTask noch ausgeführt wird; und selbst wenn der StartTask fehlschlägt, werden weiterhin neue Aufgaben im Compute-Knoten geplant. Der Standardwert ist „true“. Geben Sie entweder "true" oder "false" an, um die Eigenschaft zu aktualisieren.

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 Pools, der abgerufen werden soll.

Optionale Parameter

--account-endpoint

Batchdienstendpunkt. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ENDPOINT.

--account-key

Batchkontoschlüssel. Alternativ können Sie eine Umgebungsvariable festlegen: AZURE_BATCH_ACCESS_KEY.

--account-name

Batchkontoname. Alternativ können Sie eine Umgebungsvariable 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 im Dienst genau mit dem vom Client angegebenen Wert übereinstimmt.

--if-modified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit 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 auf dem Dienst nicht mit dem vom Client angegebenen Wert übereinstimmt.

--if-unmodified-since

Ein Zeitstempel, der die letzte Änderungszeit der Ressource angibt, die dem Client bekannt ist. Der Vorgang wird nur ausgeführt, wenn die Ressource für den Dienst seit der angegebenen Zeit nicht geändert wurde.

--select

Eine OData-$select-Klausel.