az quantum

  • Vorschau
  • Referenz

Hinweis

Diese Referenz ist Teil der Quantenerweiterung für die Azure CLI (Version 2.41.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az Quantum-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

Verwalten Sie Azure Quantum Workspaces, und übermitteln Sie Aufträge an Azure Quantum Providers.

Befehle

Name Beschreibung Typ Status
az quantum execute

Übermitteln Sie einen Auftrag, der auf Azure Quantum ausgeführt werden soll, und wartet auf das Ergebnis.

 Erweiterung Vorschau
az quantum job

Verwalten von Aufträgen für Azure Quantum.

 Erweiterung Vorschau
az quantum job cancel

Fordern Sie an, einen Auftrag in Azure Quantum abzubrechen, wenn er nicht abgeschlossen wurde.

 Erweiterung Vorschau
az quantum job list

Rufen Sie die Liste der Aufträge in einem Quantum Workspace ab.

 Erweiterung Vorschau
az quantum job output

Ruft die Ergebnisse der Ausführung eines Auftrags ab.

 Erweiterung Vorschau
az quantum job show

Rufen Sie den Status und details des Auftrags ab.

 Erweiterung Vorschau
az quantum job submit

Übermitteln Sie ein Programm oder eine Leitung, die auf Azure Quantum ausgeführt werden soll.

 Erweiterung Vorschau
az quantum job wait

Platzieren Sie die CLI in einem Wartezustand, bis der Auftrag abgeschlossen ist.

 Erweiterung Vorschau
az quantum offerings

Verwalten Sie Anbieterangebote für Azure Quantum.

 Erweiterung Vorschau
az quantum offerings accept-terms

Akzeptieren Sie die Bedingungen einer Anbieter- und SKU-Kombination, um sie für die Erstellung von Arbeitsbereichen zu aktivieren.

 Erweiterung Vorschau
az quantum offerings list

Rufen Sie die Liste aller Anbieterangebote ab, die am angegebenen Standort verfügbar sind.

 Erweiterung Vorschau
az quantum offerings show-terms

Zeigen Sie die Bedingungen eines Anbieters und einer SKU-Kombination einschließlich Lizenz-URL und Akzeptanzstatus an.

 Erweiterung Vorschau
az quantum run

Entspricht az quantum execute.

 Erweiterung Vorschau
az quantum target

Verwalten Sie Ziele für Azure Quantum-Arbeitsbereiche.

 Erweiterung Vorschau
az quantum target clear

Löschen Sie die Standardziel-ID.

 Erweiterung Vorschau
az quantum target list

Rufen Sie die Liste der Anbieter und deren Ziele in einem Azure Quantum-Arbeitsbereich ab.

 Erweiterung Vorschau
az quantum target set

Wählen Sie das Standardziel aus, das beim Übermitteln von Aufträgen an Azure Quantum verwendet werden soll.

 Erweiterung Vorschau
az quantum target show

Rufen Sie die Ziel-ID des aktuellen Standardziels ab, das beim Übermitteln von Aufträgen an Azure Quantum verwendet werden soll.

 Erweiterung Vorschau
az quantum workspace

Verwalten von Azure Quantum-Arbeitsbereichen.

 Erweiterung Vorschau
az quantum workspace clear

Löschen Sie den standardmäßigen Azure Quantum-Arbeitsbereich.

 Erweiterung Vorschau
az quantum workspace create

Erstellen Sie einen neuen Azure Quantum-Arbeitsbereich.

 Erweiterung Vorschau
az quantum workspace delete

Löschen Sie den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich.

 Erweiterung Vorschau
az quantum workspace keys

Verwalten von Azure Quantum Workspace-API-Schlüsseln.

 Erweiterung Vorschau
az quantum workspace keys list

Auflisten von API-Schlüsseln für den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich.

 Erweiterung Vorschau
az quantum workspace keys regenerate

Generieren Sie den API-Schlüssel für den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich neu.

 Erweiterung Vorschau
az quantum workspace list

Rufen Sie die Liste der verfügbaren Azure Quantum-Arbeitsbereiche ab.

 Erweiterung Vorschau
az quantum workspace quotas

Listen Sie die Kontingente für den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich auf.

 Erweiterung Vorschau
az quantum workspace set

Wählen Sie einen Standardmäßigen Azure Quantum-Arbeitsbereich für zukünftige Befehle aus.

 Erweiterung Vorschau
az quantum workspace show

Rufen Sie die Details des angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereichs ab.

 Erweiterung Vorschau
az quantum workspace update

Aktualisieren Sie den angegebenen (oder aktuellen) Azure Quantum-Arbeitsbereich.

 Erweiterung Vorschau

az quantum execute

Vorschau

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

Übermitteln Sie einen Auftrag, der auf Azure Quantum ausgeführt werden soll, und wartet auf das Ergebnis.

az quantum execute --location
                   --resource-group
                   --target-id
                   --workspace-name
                   [--entry-point]
                   [--job-input-file]
                   [--job-input-format]
                   [--job-name]
                   [--job-output-format]
                   [--job-params]
                   [--no-build]
                   [--project]
                   [--shots]
                   [--storage]
                   [--target-capability]
                   [<PROGRAM_ARGS>]

Beispiele

Senden Sie ein Q#-Programm aus dem aktuellen Ordner, und warten Sie auf das Ergebnis.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

Senden und warten Sie auf ein Q#-Programm aus dem aktuellen Ordner mit Auftrags- und Programmparametern.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

Senden und warten Sie, bis ein Q#-Programm aus dem aktuellen Ordner mit einem Zielfunktionsparameter stammt.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

Erforderliche Parameter

--location -l

Position. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--resource-group -g

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

--target-id -t

Ausführungsmodul für Quantencomputingaufträge. Wenn ein Arbeitsbereich mit einer Reihe von Anbietern konfiguriert ist, aktivieren sie jeweils ein oder mehrere Ziele. Sie können das Standardziel mithilfe von az quantum target set.

--workspace-name -w

Name des Quantum-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Optionale Parameter

--entry-point

Der Einstiegspunkt für das QIR-Programm oder -Schaltkreis. Erforderlich für QIR. Bei Q#-Aufträgen ignoriert.

--job-input-file

Der Speicherort der zu übermittelnden Eingabedatei. Erforderlich für QIR-, QIO- und Pass-Through-Aufträge. Bei Q#-Aufträgen ignoriert.

--job-input-format

Das Format der zu übermittelnden Datei. Lassen Sie diesen Parameter für Q#-Aufträge aus.

--job-name

Ein Anzeigename, der dieser Ausführung des Programms zugewiesen werden soll.

--job-output-format

Das erwartete Auftragsausgabeformat. Bei Q#-Aufträgen ignoriert.

--job-params

Auftragsparameter, die als Liste von Key=Wert-Paaren, JSON-Zeichenfolgen oder @{file} json-Inhalten an das Ziel übergeben werden.

--no-build

[Veraltet] Wenn angegeben, wird das Q#-Programm vor der Übermittlung nicht erstellt.

Standardwert: False
--project

[Veraltet] Der Speicherort des zu übermittelnden Q#-Projekts. Standardmäßig wird der aktuelle Ordner verwendet.

--shots

Die Anzahl der Wiederholungen des Q#-Programms für das angegebene Ziel.

--storage

Wenn angegeben, wird die Verbinden ionString eines Azure Storage verwendet, um Auftragsdaten und Ergebnisse zu speichern.

--target-capability

Zielfunktionsparameter, der an den Compiler übergeben wird.

<PROGRAM_ARGS>

Liste der Argumente, die von dem Q#-Vorgang erwartet werden, der als --name=wert nach angegeben ist --.

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

Vorschau

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

Entspricht az quantum execute.

az quantum run --location
               --resource-group
               --target-id
               --workspace-name
               [--entry-point]
               [--job-input-file]
               [--job-input-format]
               [--job-name]
               [--job-output-format]
               [--job-params]
               [--no-build]
               [--project]
               [--shots]
               [--storage]
               [--target-capability]
               [<PROGRAM_ARGS>]

Beispiele

Senden Sie ein Q#-Programm aus dem aktuellen Ordner, und warten Sie auf das Ergebnis.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget

Senden und warten Sie auf ein Q#-Programm aus dem aktuellen Ordner mit Auftrags- und Programmparametern.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-params key1=value1 key2=value2 -- --n-qubits=3

Senden und warten Sie, bis ein Q#-Programm aus dem aktuellen Ordner mit einem Zielfunktionsparameter stammt.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --target-capability MyTargetCapability

Erforderliche Parameter

--location -l

Position. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--resource-group -g

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

--target-id -t

Ausführungsmodul für Quantencomputingaufträge. Wenn ein Arbeitsbereich mit einer Reihe von Anbietern konfiguriert ist, aktivieren sie jeweils ein oder mehrere Ziele. Sie können das Standardziel mithilfe von az quantum target set.

--workspace-name -w

Name des Quantum-Arbeitsbereichs. Sie können den Standardarbeitsbereich mithilfe von az quantum workspace set.

Optionale Parameter

--entry-point

Der Einstiegspunkt für das QIR-Programm oder -Schaltkreis. Erforderlich für QIR. Bei Q#-Aufträgen ignoriert.

--job-input-file

Der Speicherort der zu übermittelnden Eingabedatei. Erforderlich für QIR-, QIO- und Pass-Through-Aufträge. Bei Q#-Aufträgen ignoriert.

--job-input-format

Das Format der zu übermittelnden Datei. Lassen Sie diesen Parameter für Q#-Aufträge aus.

--job-name

Ein Anzeigename, der dieser Ausführung des Programms zugewiesen werden soll.

--job-output-format

Das erwartete Auftragsausgabeformat. Bei Q#-Aufträgen ignoriert.

--job-params

Auftragsparameter, die als Liste von Key=Wert-Paaren, JSON-Zeichenfolgen oder @{file} json-Inhalten an das Ziel übergeben werden.

--no-build

[Veraltet] Wenn angegeben, wird das Q#-Programm vor der Übermittlung nicht erstellt.

Standardwert: False
--project

[Veraltet] Der Speicherort des zu übermittelnden Q#-Projekts. Standardmäßig wird der aktuelle Ordner verwendet.

--shots

Die Anzahl der Wiederholungen des Q#-Programms für das angegebene Ziel.

--storage

Wenn angegeben, wird die Verbinden ionString eines Azure Storage verwendet, um Auftragsdaten und Ergebnisse zu speichern.

--target-capability

Zielfunktionsparameter, der an den Compiler übergeben wird.

<PROGRAM_ARGS>

Liste der Argumente, die von dem Q#-Vorgang erwartet werden, der als --name=wert nach angegeben ist --.

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.