az quantum

Hinweis

Dieser Verweis ist Teil der Quantenerweiterung für die Azure CLI (Version 2.23.0 oder höher). Die Erweiterung wird beim ersten Ausführen eines Az-Quantenbefehls automatisch installiert. Weitere Informationen zu Erweiterungen

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

Befehle

az quantum execute

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

az quantum job

Verwalten von Aufträgen für Azure Quantum.

az quantum job cancel

Bitten Sie, einen Auftrag in Azure Quantum abzubrechen, wenn sie nicht abgeschlossen ist.

az quantum job list

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

az quantum job output

Rufen Sie die Ergebnisse der Ausführung eines Q#-Auftrags ab.

az quantum job show

Rufen Sie den Status und details des Auftrags ab.

az quantum job submit

Senden Sie ein Q#-Projekt, das auf Azure Quantum ausgeführt werden soll.

az quantum job wait

Platzieren Sie die CLI in einem Wartezeitzustand, bis der Auftrag ausgeführt wird.

az quantum offerings

Verwalten von Anbieterangeboten für Azure Quantum.

az quantum offerings accept-terms

Akzeptieren Sie die Bedingungen eines Anbieters und einer SKU-Kombination, um sie für die Arbeitsbereicherstellung zu ermöglichen.

az quantum offerings list

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

az quantum offerings show-terms

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

az quantum run

Entspricht az quantum execute.

az quantum target

Verwalten von Zielen für Azure Quantum-Arbeitsbereiche.

az quantum target clear

Löschen Sie die Standardziel-ID.

az quantum target list

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

az quantum target set

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

az quantum target show

Rufen Sie die Details des angegebenen (oder aktuellen) Ziels ab, das beim Übermitteln von Aufträgen an Azure Quantum verwendet werden soll.

az quantum workspace

Verwalten von Azure Quantum-Arbeitsbereichen.

az quantum workspace clear

Deaktivieren Sie den Standardmäßigen Azure Quantum-Arbeitsbereich.

az quantum workspace create

Erstellen Sie einen neuen Azure Quantum-Arbeitsbereich.

az quantum workspace delete

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

az quantum workspace list

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

az quantum workspace quotas

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

az quantum workspace set

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

az quantum workspace show

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

az quantum execute

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

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

Beispiele

Senden Sie das 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 auf ein Q#-Programm aus dem aktuellen Ordner mit einem Zielfunktionsparameter.

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

Optionale Parameter

--job-name

Ein Anzeigename für diese Ausführung des Programms.

--job-params

Auftragsparameter, die an das Ziel übergeben wurden, als Liste der Schlüssel=Wertpaare.

--location -l

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

--no-build

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

--project

Der Speicherort des zu übermittelnden Q#-Projekts. Standardeinstellungen für den aktuellen Ordner.

--resource-group -g

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

--shots

Die Anzahl der Zeiten zum Ausführen des Q#-Programms auf dem angegebenen Ziel.

--storage

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

--target-capability

Zielfunktionsparameter, der an den Compiler übergeben wird.

--target-id -t

Ausführungsmodul für Quantencomputeraufträge. Wenn ein Arbeitsbereich mit einem Satz von Anbieter konfiguriert ist, aktivieren sie jeweils ein oder mehrere Ziele. Sie können das Standardziel mithilfe az quantum target setvon .

--workspace-name -w

Name des Quantum Workspace. Sie können den Standardarbeitsbereich mithilfe az quantum workspace setvon .

<PROGRAM_ARGS>

Liste der Argumente, die vom Q#-Vorgang erwartet werden, der als "-name=wert" angegeben ist --.

az quantum run

Entspricht az quantum execute.

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

Beispiele

Senden Sie das 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 auf ein Q#-Programm aus dem aktuellen Ordner mit einem Zielfunktionsparameter.

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

Optionale Parameter

--job-name

Ein Anzeigename für diese Ausführung des Programms.

--job-params

Auftragsparameter, die an das Ziel übergeben wurden, als Liste der Schlüssel=Wertpaare.

--location -l

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

--no-build

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

--project

Der Speicherort des zu übermittelnden Q#-Projekts. Standardeinstellungen für den aktuellen Ordner.

--resource-group -g

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

--shots

Die Anzahl der Zeiten zum Ausführen des Q#-Programms auf dem angegebenen Ziel.

--storage

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

--target-capability

Zielfunktionsparameter, der an den Compiler übergeben wird.

--target-id -t

Ausführungsmodul für Quantencomputeraufträge. Wenn ein Arbeitsbereich mit einem Satz von Anbieter konfiguriert ist, aktivieren sie jeweils ein oder mehrere Ziele. Sie können das Standardziel mithilfe az quantum target setvon .

--workspace-name -w

Name des Quantum Workspace. Sie können den Standardarbeitsbereich mithilfe az quantum workspace setvon .

<PROGRAM_ARGS>

Liste der Argumente, die vom Q#-Vorgang erwartet werden, der als "-name=wert" angegeben ist --.