Share via


az load test

Hinweis

Diese Referenz ist Teil der Ladeerweiterung für die Azure CLI (Version 2.41.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen Az Load Test-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Diese Befehlsgruppe befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Befehlsgruppe zum Verwalten von Auslastungstests.

Befehlsgruppe zum Verwalten des Auslastungstests mit "Erstellen", "Aktualisieren", "Löschen", "Liste" usw.

Befehle

Name Beschreibung Typ Status
az load test app-component

Befehlsgruppe zum Verwalten von App-Komponenten.

Durchwahl Vorschau
az load test app-component add

Fügen Sie einem Test eine App-Komponente hinzu.

Durchwahl Vorschau
az load test app-component list

Listet alle App-Komponenten für einen Test auf.

Durchwahl Vorschau
az load test app-component remove

Entfernen Sie die angegebene App-Komponente aus einem Test.

Durchwahl Vorschau
az load test create

Erstellen Sie einen neuen Auslastungstest.

Durchwahl Vorschau
az load test delete

Löschen eines vorhandenen Auslastungstests.

Durchwahl Vorschau
az load test download-files

Laden Sie Dateien eines vorhandenen Ladetests herunter.

Durchwahl Vorschau
az load test file

Befehlsgruppe für Vorgänge in Testdateien.

Durchwahl Vorschau
az load test file delete

Löschen sie eine Datei aus dem Test.

Durchwahl Vorschau
az load test file download

Laden Sie eine Datei aus einem Test herunter.

Durchwahl Vorschau
az load test file list

Listet alle Dateien in einem Test auf.

Durchwahl Vorschau
az load test file upload

Laden Sie eine Datei in einen Test hoch.

Durchwahl Vorschau
az load test list

Alle Tests in der angegebenen Auslastungstestressource auflisten.

Durchwahl Vorschau
az load test server-metric

Befehlsgruppe zum Verwalten von Servermetriken.

Durchwahl Vorschau
az load test server-metric add

Fügen Sie einem Test eine Servermetrik hinzu.

Durchwahl Vorschau
az load test server-metric list

Listet alle Servermetriken für einen Test auf.

Durchwahl Vorschau
az load test server-metric remove

Entfernen Sie die angegebene Servermetrik aus dem Test.

Durchwahl Vorschau
az load test show

Details des Tests anzeigen.

Durchwahl Vorschau
az load test update

Aktualisieren sie einen vorhandenen Auslastungstest.

Durchwahl Vorschau

az load test create

Vorschau

Die Befehlsgruppe "Ladetest" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie einen neuen Auslastungstest.

az load test create --load-test-resource
                    --test-id
                    [--certificate]
                    [--description]
                    [--display-name]
                    [--engine-instances]
                    [--env]
                    [--keyvault-reference-id]
                    [--load-test-config-file]
                    [--no-wait]
                    [--resource-group]
                    [--secret]
                    [--split-csv]
                    [--subnet-id]
                    [--test-plan]

Beispiele

Erstellen Sie einen Test mit der Ladetestkonfigurationsdatei.

az load test create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --load-test-config-file ~/resources/sample-config.yaml

Erstellen Sie einen Test mit Argumenten.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --description "Test description" --test-plan sample-jmx.jmx --engine-instances 1 --env rps=2 count=1

Erstellen Sie einen Test mit der Ladetestkonfigurationsdatei, und überschreiben Sie die Modulinstanz und env verwenden Sie Argumente, und warten Sie nicht auf den Dateiupload.

az load test create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --load-test-config-file ~/resources/sample-config.yaml --engine-instances 1 --env rps=2 count=1 --no-wait

Erstellen Sie einen Test mit geheimen Schlüsseln und Umgebungsvariablen.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --description "Test description" --test-plan sample-jmx.jmx --secret secret_name1=secret_uri1 secret_name2=secret_uri2 --env rps=2 count=1

Erstellen Sie einen Test mit geheimen Schlüsseln mithilfe der vom Benutzer zugewiesenen verwalteten Identität, um auf den Key Vault zuzugreifen.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --secret secret_name1=secret_uri1 secret_name2=secret_uri2 --keyvault-reference-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/microsoft.managedidentity/userassignedidentities/sample-mi"

Erstellen Sie einen Test für einen privaten Endpunkt in einem virtuellen Netzwerk mit aktivierter geteilter CSV-Option.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.Network/virtualNetworks/SampleVMVNET/subnets/SampleVMSubnet" --split-csv true

Erforderliche Parameter

--load-test-resource --name -n

Name oder ARM-Ressourcen-ID der Ressource "Auslastungstests".

--test-id -t

Test-ID des Auslastungstests.

Optionale Parameter

--certificate

Ein einzelnes Zertifikat im Format "key[=value]". Das Zertifikat sollte im PFX-Format in Azure Key Vault gespeichert werden, und der Zertifikatbezeichner sollte als Wert angegeben werden.

--description

Beschreibung des Auslastungstests.

--display-name

Anzeigename des Auslastungstests.

--engine-instances

Anzahl der Modulinstanzen, auf denen der Test ausgeführt werden soll.

--env

Durch Leerzeichen getrennte Umgebungsvariablen: Schlüssel[=Wert] [Schlüssel[=Wert] ...].

--keyvault-reference-id

Die Identität, die für den Zugriff auf den Schlüsseltresor verwendet wird.

--load-test-config-file

Pfad zur Ladetestkonfigurationsdatei. Lesen Sie https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--secret

Schlüssel[=Wert] [Schlüssel[=Wert] [Schlüssel[=Wert] ...]. Geheime Schlüssel sollten in Azure Key Vault gespeichert werden, und der geheime Bezeichner sollte als Wert angegeben werden.

--split-csv

Teilen Sie CSV-Dateien gleichmäßig zwischen Modulinstanzen.

--subnet-id

Ressourcen-ID des Subnetzes, das für den privaten Auslastungstest verwendet werden soll.

--test-plan

Pfad zum JMeter-Skript.

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 load test delete

Vorschau

Die Befehlsgruppe "Ladetest" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen eines vorhandenen Auslastungstests.

az load test delete --load-test-resource
                    --test-id
                    [--resource-group]
                    [--yes]

Beispiele

Löschen eines Auslastungstests.

az load test delete --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id

Erforderliche Parameter

--load-test-resource --name -n

Name oder ARM-Ressourcen-ID der Ressource "Auslastungstests".

--test-id -t

Test-ID des Auslastungstests.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--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 load test download-files

Vorschau

Die Befehlsgruppe "Ladetest" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Laden Sie Dateien eines vorhandenen Ladetests herunter.

az load test download-files --load-test-resource
                            --path
                            --test-id
                            [--force]
                            [--resource-group]

Beispiele

Laden Sie alle Dateien eines Tests herunter. Das Verzeichnis sollte bereits vorhanden sein.

az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path ~/downloads

Laden Sie alle Dateien eines Tests herunter, indem Sie das Verzeichnis erstellen, wenn es nicht vorhanden ist.

az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path "~/downloads/new folder" --force

Erforderliche Parameter

--load-test-resource --name -n

Name oder ARM-Ressourcen-ID der Ressource "Auslastungstests".

--path

Pfad des Verzeichnisses zum Herunterladen von Dateien.

--test-id -t

Test-ID des Auslastungstests.

Optionale Parameter

--force

Erzwingen Sie die Ausführung des Befehls. Dadurch wird das Verzeichnis erstellt, um Dateien herunterzuladen, wenn es nicht vorhanden ist.

Standardwert: False
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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 load test list

Vorschau

Die Befehlsgruppe "Ladetest" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Alle Tests in der angegebenen Auslastungstestressource auflisten.

az load test list --load-test-resource
                  [--resource-group]

Beispiele

Alle Auslastungstests in einer Ressource auflisten.

az load test list --load-test-resource sample-alt-resource --resource-group sample-rg

Erforderliche Parameter

--load-test-resource --name -n

Name oder ARM-Ressourcen-ID der Ressource "Auslastungstests".

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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 load test show

Vorschau

Die Befehlsgruppe "Ladetest" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Details des Tests anzeigen.

az load test show --load-test-resource
                  --test-id
                  [--resource-group]

Beispiele

Rufen Sie die Details eines Auslastungstests ab.

az load test show --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg

Erforderliche Parameter

--load-test-resource --name -n

Name oder ARM-Ressourcen-ID der Ressource "Auslastungstests".

--test-id -t

Test-ID des Auslastungstests.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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 load test update

Vorschau

Die Befehlsgruppe "Ladetest" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktualisieren sie einen vorhandenen Auslastungstest.

az load test update --load-test-resource
                    --test-id
                    [--certificate]
                    [--description]
                    [--display-name]
                    [--engine-instances]
                    [--env]
                    [--keyvault-reference-id]
                    [--load-test-config-file]
                    [--no-wait]
                    [--resource-group]
                    [--secret]
                    [--split-csv]
                    [--subnet-id]
                    [--test-plan]

Beispiele

Aktualisieren Sie einen Test mit der Ladetestkonfigurationsdatei, und warten Sie nicht auf den Dateiupload.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --load-test-config-file ~/resources/sample-config.yaml --no-wait

Aktualisieren Sie den Anzeigenamen und die Beschreibung für einen Test.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --description "Test description" --display-name "Sample Name"

Aktualisieren Sie einen Test mit der Ladetestkonfigurationsdatei, und überschreiben Sie Parameter mithilfe von Argumenten.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --load-test-config-file ~/resources/sample-config.yaml --engine-instances 1 --env name=value name=value

Entfernen Sie die geheimen Schlüssel aus einem Test.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --secret secret_name1=""

Aktualisieren Sie die Key Vault-Referenzidentität auf die vom System zugewiesene verwaltete Identität.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --keyvault-reference-id null

Erforderliche Parameter

--load-test-resource --name -n

Name oder ARM-Ressourcen-ID der Ressource "Auslastungstests".

--test-id -t

Test-ID des Auslastungstests.

Optionale Parameter

--certificate

Ein einzelnes Zertifikat im Format "key[=value]". Das Zertifikat sollte im PFX-Format in Azure Key Vault gespeichert werden, und der Zertifikatbezeichner sollte als Wert angegeben werden. Verwenden Sie "" zum Löschen des vorhandenen Zertifikats.

--description

Beschreibung des Auslastungstests.

--display-name

Anzeigename des Auslastungstests.

--engine-instances

Anzahl der Modulinstanzen, auf denen der Test ausgeführt werden soll.

--env

Durch Leerzeichen getrennte Umgebungsvariablen: Schlüssel[=Wert] [Schlüssel[=Wert] ...]. Verwenden Sie "", um vorhandene Umgebungsvariablen zu löschen.

--keyvault-reference-id

Die Identität, die für den Zugriff auf den Schlüsseltresor verwendet wird. Bereitstellen null oder None Verwenden der vom System zugewiesenen Identität der Auslastungstestressource.

--load-test-config-file

Pfad zur Ladetestkonfigurationsdatei. Lesen Sie https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--secret

Schlüssel[=Wert] [Schlüssel[=Wert] [Schlüssel[=Wert] ...]. Geheime Schlüssel sollten in Azure Key Vault gespeichert werden, und der geheime Bezeichner sollte als Wert angegeben werden. Verwenden Sie "", um vorhandene geheime Schlüssel zu löschen.

--split-csv

Teilen Sie CSV-Dateien gleichmäßig zwischen Modulinstanzen.

--subnet-id

Ressourcen-ID des Subnetzes, das für den privaten Auslastungstest verwendet werden soll.

--test-plan

Pfad zum JMeter-Skript.

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.