az quantum

Notitie

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

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	Verzend een taak die moet worden uitgevoerd op Azure Quantum en wacht op het resultaat.	Toestel	Preview
az quantum job	Taken voor Azure Quantum beheren.	Toestel	Preview
az quantum job cancel	Aanvraag om een taak in Azure Quantum te annuleren als deze nog niet is voltooid.	Toestel	Preview
az quantum job list	Haal de lijst met taken op in een Quantum-werkruimte.	Toestel	Preview
az quantum job output	Haal de resultaten van het uitvoeren van een taak op.	Toestel	Preview
az quantum job show	De status en details van de taak ophalen.	Toestel	Preview
az quantum job submit	Dien een programma of circuit in dat moet worden uitgevoerd op Azure Quantum.	Toestel	Preview
az quantum job wait	Plaats de CLI in een wachtstatus totdat de taak is uitgevoerd.	Toestel	Preview
az quantum offerings	Provideraanbiedingen voor Azure Quantum beheren.	Toestel	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.	Toestel	Preview
az quantum offerings list	Haal de lijst op met alle provideraanbiedingen die beschikbaar zijn op de opgegeven locatie.	Toestel	Preview
az quantum offerings show-terms	De voorwaarden van een provider en SKU-combinatie weergeven, inclusief licentie-URL en acceptatiestatus.	Toestel	Preview
az quantum run	Gelijk aan az quantum execute.	Toestel	Preview
az quantum target	Beheer doelen voor Azure Quantum-werkruimten.	Toestel	Preview
az quantum target clear	Wis de standaarddoel-id.	Toestel	Preview
az quantum target list	Haal de lijst met providers en hun doelen op in een Azure Quantum-werkruimte.	Toestel	Preview
az quantum target set	Selecteer het standaarddoel dat moet worden gebruikt bij het verzenden van taken naar Azure Quantum.	Toestel	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.	Toestel	Preview
az quantum workspace	Azure Quantum-werkruimten beheren.	Toestel	Preview
az quantum workspace clear	Wis de standaard Azure Quantum-werkruimte.	Toestel	Preview
az quantum workspace create	Maak een nieuwe Azure Quantum-werkruimte.	Toestel	Preview
az quantum workspace delete	Verwijder de opgegeven (of huidige) Azure Quantum-werkruimte.	Toestel	Preview
az quantum workspace keys	Api-sleutels voor Azure Quantum Workspace beheren.	Toestel	Preview
az quantum workspace keys list	Api-sleutels weergeven voor de opgegeven (of huidige) Azure Quantum-werkruimte.	Toestel	Preview
az quantum workspace keys regenerate	Genereer api-sleutel opnieuw voor de opgegeven (of huidige) Azure Quantum-werkruimte.	Toestel	Preview
az quantum workspace list	Haal de lijst met Beschikbare Azure Quantum-werkruimten op.	Toestel	Preview
az quantum workspace quotas	Geef de quota voor de opgegeven (of huidige) Azure Quantum-werkruimte weer.	Toestel	Preview
az quantum workspace set	Selecteer een standaard Azure Quantum-werkruimte voor toekomstige opdrachten.	Toestel	Preview
az quantum workspace show	De details van de opgegeven (of huidige) Azure Quantum-werkruimte ophalen.	Toestel	Preview
az quantum workspace update	Werk de opgegeven (of huidige) Azure Quantum-werkruimte bij.	Toestel	Preview

az quantum execute

Preview

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

Verzend een taak die moet worden uitgevoerd op Azure Quantum en wacht op het resultaat.

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>]

Voorbeelden

Dien een Q#-programma in vanuit de huidige map en wacht op het resultaat.

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

Dien een Q#-programma in vanuit de huidige map met taak- en programmaparameters.

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

Verzend en wacht tot een Q#-programma uit de huidige map met een doelfunctieparameter.

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

Vereiste parameters

--location -l

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

--resource-group -g

De naam van de 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 behulp van az quantum workspace set.

Optionele parameters

--entry-point

Het toegangspunt voor het QIR-programma of -circuit. Vereist voor QIR. Genegeerd voor Q#-taken.

--job-input-file

De locatie van het invoerbestand dat moet worden verzonden. Vereist voor QIR-, QIO- en passthrough-taken. Genegeerd voor Q#-taken.

--job-input-format

De indeling van het bestand dat moet worden verzonden. Laat deze parameter weg voor Q#-taken.

--job-name

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

--job-output-format

De verwachte indeling van de taakuitvoer. Genegeerd voor Q#-taken.

--job-params

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

--no-build

[Afgeschaft] Indien opgegeven, wordt het Q#-programma niet gebouwd voordat het wordt ingediend.

standaardwaarde: False

--project

[Afgeschaft] De locatie van het Q#-project dat moet worden verzonden. De standaardinstelling is de huidige map.

--shots

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

--storage

Indien opgegeven, wordt de Verbinding maken ionString van een Azure Storage gebruikt om taakgegevens en -resultaten op te slaan.

--target-capability

De parameter Target-capability doorgegeven aan de compiler.

<PROGRAM_ARGS>

Lijst met argumenten die worden verwacht door de Q#-bewerking die is opgegeven als --name=value after --.

Globale parameters

--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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.

az quantum run

Preview

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

Gelijk aan 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>]

Voorbeelden

Dien een Q#-programma in vanuit de huidige map en wacht op het resultaat.

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

Dien een Q#-programma in vanuit de huidige map met taak- en programmaparameters.

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

Verzend en wacht tot een Q#-programma uit de huidige map met een doelfunctieparameter.

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

Vereiste parameters

--location -l

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

--resource-group -g

De naam van de 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 behulp van az quantum workspace set.

Optionele parameters

--entry-point

Het toegangspunt voor het QIR-programma of -circuit. Vereist voor QIR. Genegeerd voor Q#-taken.

--job-input-file

De locatie van het invoerbestand dat moet worden verzonden. Vereist voor QIR-, QIO- en passthrough-taken. Genegeerd voor Q#-taken.

--job-input-format

De indeling van het bestand dat moet worden verzonden. Laat deze parameter weg voor Q#-taken.

--job-name

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

--job-output-format

De verwachte indeling van de taakuitvoer. Genegeerd voor Q#-taken.

--job-params

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

--no-build

[Afgeschaft] Indien opgegeven, wordt het Q#-programma niet gebouwd voordat het wordt ingediend.

standaardwaarde: False

--project

[Afgeschaft] De locatie van het Q#-project dat moet worden verzonden. De standaardinstelling is de huidige map.

--shots

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

--storage

Indien opgegeven, wordt de Verbinding maken ionString van een Azure Storage gebruikt om taakgegevens en -resultaten op te slaan.

--target-capability

De parameter Target-capability doorgegeven aan de compiler.

<PROGRAM_ARGS>

Lijst met argumenten die worden verwacht door de Q#-bewerking die is opgegeven als --name=value after --.

Globale parameters

--debug

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

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc

standaardwaarde: json

--query

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

--subscription

Naam of id van het 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.