Delen via


az quantum

Note

Deze verwijzing maakt deel uit van de kwantumextensie voor de Azure CLI (versie 2.73.0 of hoger). De extensie installeert automatisch de eerste keer dat u een az quantum-opdracht uitvoert. Meer informatie over uitbreidingen.

Deze opdrachtgroep is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Azure Quantum-werkruimten beheren en taken verzenden naar Azure Quantum Providers.

Opdracht

Name Description Type Status
az quantum execute

Dien een taak in die moet worden uitgevoerd in Azure Quantum en wacht tot het resultaat wordt weergegeven. Gelijk aan az quantum run.

Extension Preview
az quantum job

Taken voor Azure Quantum beheren.

Extension Preview
az quantum job cancel

Aanvraag om een taak in Azure Quantum te annuleren als deze nog niet is voltooid.

Extension Preview
az quantum job list

Haal de lijst met taken op in een Quantum-werkruimte.

Extension Preview
az quantum job output

Haal de resultaten van het uitvoeren van een taak op.

Extension Preview
az quantum job show

De status en details van de taak ophalen.

Extension Preview
az quantum job submit

Dien een programma of circuit in dat moet worden uitgevoerd op Azure Quantum.

Extension Preview
az quantum job wait

Plaats de CLI in een wachtstatus totdat de taak is uitgevoerd.

Extension Preview
az quantum offerings

Provideraanbiedingen voor Azure Quantum beheren.

Extension Preview
az quantum offerings accept-terms

Accepteer de voorwaarden van een provider en een SKU-combinatie om deze in te schakelen voor het maken van werkruimten.

Extension Preview
az quantum offerings list

Haal de lijst op met alle provideraanbiedingen die beschikbaar zijn op de opgegeven locatie.

Extension Preview
az quantum offerings show-terms

De voorwaarden van een provider en SKU-combinatie weergeven, inclusief licentie-URL en acceptatiestatus.

Extension Preview
az quantum run

Dien een taak in die moet worden uitgevoerd in Azure Quantum en wacht tot het resultaat wordt weergegeven. Gelijk aan az quantum execute.

Extension Preview
az quantum target

Beheer doelen voor Azure Quantum-werkruimten.

Extension Preview
az quantum target clear

Wis de standaarddoel-id.

Extension Preview
az quantum target list

Haal de lijst met providers en hun doelen op in een Azure Quantum-werkruimte.

Extension Preview
az quantum target set

Selecteer het standaarddoel dat moet worden gebruikt bij het verzenden van taken naar Azure Quantum.

Extension Preview
az quantum target show

Haal de doel-id op van het huidige standaarddoel dat moet worden gebruikt bij het verzenden van taken naar Azure Quantum.

Extension Preview
az quantum workspace

Azure Quantum-werkruimten beheren.

Extension Preview
az quantum workspace clear

Wis de standaard Azure Quantum-werkruimte.

Extension Preview
az quantum workspace create

Maak een nieuwe Azure Quantum-werkruimte.

Extension Preview
az quantum workspace delete

Verwijder de opgegeven (of huidige) Azure Quantum-werkruimte.

Extension Preview
az quantum workspace keys

Api-sleutels voor Azure Quantum Workspace beheren.

Extension Preview
az quantum workspace keys list

Api-sleutels weergeven voor de opgegeven (of huidige) Azure Quantum-werkruimte.

Extension Preview
az quantum workspace keys regenerate

Genereer api-sleutel opnieuw voor de opgegeven (of huidige) Azure Quantum-werkruimte.

Extension Preview
az quantum workspace list

Haal de lijst met Beschikbare Azure Quantum-werkruimten op.

Extension Preview
az quantum workspace quotas

Geef de quota voor de opgegeven (of huidige) Azure Quantum-werkruimte weer.

Extension Preview
az quantum workspace set

Selecteer een standaard Azure Quantum-werkruimte voor toekomstige opdrachten.

Extension Preview
az quantum workspace show

De details van de opgegeven (of huidige) Azure Quantum-werkruimte ophalen.

Extension Preview
az quantum workspace update

Werk de opgegeven (of huidige) Azure Quantum-werkruimte bij.

Extension Preview

az quantum execute

Preview

De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Dien een taak in die moet worden uitgevoerd in Azure Quantum en wacht tot het resultaat wordt weergegeven. Gelijk aan az quantum run.

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

Voorbeelden

Voer QIR-bitcode uit vanuit een bestand in de huidige map en wacht op het resultaat.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Voer een Quil-passthrough-taak uit op de Rigetti-simulator en wacht op het resultaat.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t rigetti.sim.qvm --job-name MyJob --job-input-file MyProgram.quil \
   --job-input-format rigetti.quil.v1 --job-output-format rigetti.quil-results.v1

Dien een Qiskit-circuit in bij de IonQ-simulator met taakparams en wacht op de resultaten.

az quantum execute -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t ionq.simulator --job-name MyJobName --job-input-file MyCircuit.json \
   --job-input-format ionq.circuit.v1 --job-output-format ionq.quantum-results.v1 \
   --job-params count=100 content-type=application/json

Vereiste parameters

--job-input-file

De locatie van het invoerbestand dat moet worden verzonden.

--job-input-format

De indeling van het bestand dat moet worden verzonden.

--location -l

Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--target-id -t

Uitvoeringsengine voor kwantumcomputingstaken. Wanneer een werkruimte is geconfigureerd met een set providers, schakelen ze elk een of meer doelen in. U kunt het standaarddoel configureren met behulp van az quantum target set.

--workspace-name -w

Naam van de Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met az quantum workspace set.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--entry-point

Het toegangspunt voor het QIR-programma of -circuit. Vereist voor sommige QIR-taken van de provider.

--job-name

Een beschrijvende naam om aan deze uitvoering van het programma te geven.

--job-output-format

De verwachte indeling van de taakuitvoer.

--job-params

Taakparameters die aan het doel zijn doorgegeven als een lijst met sleutel-=waardeparen, json-tekenreeks of @{file} met json-inhoud.

--shots

Het aantal keren dat het programma op het opgegeven doel moet worden uitgevoerd.

--storage

Indien opgegeven, wordt de ConnectionString van een Azure Storage gebruikt voor het opslaan van taakgegevens en -resultaten.

--target-capability

De parameter Target-capability doorgegeven aan de compiler.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False

az quantum run

Preview

De opdrachtgroep 'quantum' is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Dien een taak in die moet worden uitgevoerd in Azure Quantum en wacht tot het resultaat wordt weergegeven. Gelijk aan az quantum execute.

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

Voorbeelden

Voer QIR-bitcode uit vanuit een bestand in de huidige map en wacht op het resultaat.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation -t MyTarget \
    --job-name MyJob --job-input-format qir.v1 --job-input-file MyQirBitcode.bc \
    --entry-point MyQirEntryPoint

Voer een Quil-passthrough-taak uit op de Rigetti-simulator en wacht op het resultaat.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t rigetti.sim.qvm --job-name MyJob --job-input-file MyProgram.quil \
   --job-input-format rigetti.quil.v1 --job-output-format rigetti.quil-results.v1

Dien een Qiskit-circuit in bij de IonQ-simulator met taakparams en wacht op de resultaten.

az quantum run -g MyResourceGroup -w MyWorkspace -l MyLocation \
   -t ionq.simulator --job-name MyJobName --job-input-file MyCircuit.json \
   --job-input-format ionq.circuit.v1 --job-output-format ionq.quantum-results.v1 \
   --job-params count=100 content-type=application/json

Vereiste parameters

--job-input-file

De locatie van het invoerbestand dat moet worden verzonden.

--job-input-format

De indeling van het bestand dat moet worden verzonden.

--location -l

Location. Waarden van: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--target-id -t

Uitvoeringsengine voor kwantumcomputingstaken. Wanneer een werkruimte is geconfigureerd met een set providers, schakelen ze elk een of meer doelen in. U kunt het standaarddoel configureren met behulp van az quantum target set.

--workspace-name -w

Naam van de Kwantumwerkruimte. U kunt de standaardwerkruimte configureren met az quantum workspace set.

Optionele parameters

De volgende parameters zijn optioneel, maar afhankelijk van de context kunnen een of meer parameters vereist zijn om de opdracht uit te voeren.

--entry-point

Het toegangspunt voor het QIR-programma of -circuit. Vereist voor sommige QIR-taken van de provider.

--job-name

Een beschrijvende naam om aan deze uitvoering van het programma te geven.

--job-output-format

De verwachte indeling van de taakuitvoer.

--job-params

Taakparameters die aan het doel zijn doorgegeven als een lijst met sleutel-=waardeparen, json-tekenreeks of @{file} met json-inhoud.

--shots

Het aantal keren dat het programma op het opgegeven doel moet worden uitgevoerd.

--storage

Indien opgegeven, wordt de ConnectionString van een Azure Storage gebruikt voor het opslaan van taakgegevens en -resultaten.

--target-capability

De parameter Target-capability doorgegeven aan de compiler.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

Eigenschap Waarde
Default value: False
--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

Eigenschap Waarde
Default value: False
--output -o

Uitvoerindeling.

Eigenschap Waarde
Default value: json
Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

Eigenschap Waarde
Default value: False