az quantum

Förhandsgranskning
Referens

Kommentar

Den här referensen är en del av kvanttillägget för Azure CLI (version 2.41.0 eller senare). Tillägget installeras automatiskt första gången du kör ett az quantum-kommando . Läs mer om tillägg.

Den här kommandogruppen är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hantera Azure Quantum-arbetsytor och skicka jobb till Azure Quantum Providers.

Kommandon

Name	Description	Typ	Status
az quantum execute	Skicka ett jobb för att köra på Azure Quantum och väntar på resultatet.	Anknytning	Förhandsgranska
az quantum job	Hantera jobb för Azure Quantum.	Anknytning	Förhandsgranska
az quantum job cancel	Begäran om att avbryta ett jobb på Azure Quantum om det inte har slutförts.	Anknytning	Förhandsgranska
az quantum job list	Hämta listan över jobb på en Kvantarbetsyta.	Anknytning	Förhandsgranska
az quantum job output	Hämta resultatet av att köra ett jobb.	Anknytning	Förhandsgranska
az quantum job show	Hämta jobbets status och information.	Anknytning	Förhandsgranska
az quantum job submit	Skicka ett program eller en krets som ska köras på Azure Quantum.	Anknytning	Förhandsgranska
az quantum job wait	Placera CLI i vänteläge tills jobbet har slutförts.	Anknytning	Förhandsgranska
az quantum offerings	Hantera providererbjudanden för Azure Quantum.	Anknytning	Förhandsgranska
az quantum offerings accept-terms	Godkänn villkoren för en provider och en SKU-kombination för att aktivera den för att skapa arbetsytor.	Anknytning	Förhandsgranska
az quantum offerings list	Hämta listan över alla leverantörserbjudanden som är tillgängliga på den angivna platsen.	Anknytning	Förhandsgranska
az quantum offerings show-terms	Visa villkoren för en provider- och SKU-kombination, inklusive licens-URL och godkännandestatus.	Anknytning	Förhandsgranska
az quantum run	`az quantum execute`Motsvarar .	Anknytning	Förhandsgranska
az quantum target	Hantera mål för Azure Quantum-arbetsytor.	Anknytning	Förhandsgranska
az quantum target clear	Rensa standardmål-ID:t.	Anknytning	Förhandsgranska
az quantum target list	Hämta listan över leverantörer och deras mål på en Azure Quantum-arbetsyta.	Anknytning	Förhandsgranska
az quantum target set	Välj det standardmål som ska användas när jobb skickas till Azure Quantum.	Anknytning	Förhandsgranska
az quantum target show	Hämta mål-ID för det aktuella standardmålet som ska användas när du skickar jobb till Azure Quantum.	Anknytning	Förhandsgranska
az quantum workspace	Hantera Azure Quantum-arbetsytor.	Anknytning	Förhandsgranska
az quantum workspace clear	Rensa standardarbetsytan för Azure Quantum.	Anknytning	Förhandsgranska
az quantum workspace create	Skapa en ny Azure Quantum-arbetsyta.	Anknytning	Förhandsgranska
az quantum workspace delete	Ta bort den angivna (eller aktuella) Azure Quantum-arbetsytan.	Anknytning	Förhandsgranska
az quantum workspace keys	Hantera API-nycklar för Azure Quantum Workspace.	Anknytning	Förhandsgranska
az quantum workspace keys list	Lista API-nycklar för den angivna (eller aktuella) Azure Quantum-arbetsytan.	Anknytning	Förhandsgranska
az quantum workspace keys regenerate	Återskapa API-nyckeln för den angivna (eller aktuella) Azure Quantum-arbetsytan.	Anknytning	Förhandsgranska
az quantum workspace list	Hämta listan över tillgängliga Azure Quantum-arbetsytor.	Anknytning	Förhandsgranska
az quantum workspace quotas	Visa en lista över kvoter för den angivna (eller aktuella) Azure Quantum-arbetsytan.	Anknytning	Förhandsgranska
az quantum workspace set	Välj en Azure Quantum-standardarbetsyta för framtida kommandon.	Anknytning	Förhandsgranska
az quantum workspace show	Hämta information om den angivna (eller aktuella) Azure Quantum-arbetsytan.	Anknytning	Förhandsgranska
az quantum workspace update	Uppdatera den angivna (eller aktuella) Azure Quantum-arbetsytan.	Anknytning	Förhandsgranska

az quantum execute

Förhandsgranskning

Kommandogruppen "quantum" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Skicka ett jobb för att köra på Azure Quantum och väntar på resultatet.

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

Exempel

Skicka ett Q#-program från den aktuella mappen och vänta på resultatet.

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

Skicka och vänta på ett Q#-program från den aktuella mappen med jobb- och programparametrar.

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

Skicka och vänta på ett Q#-program från den aktuella mappen med en målfunktionsparameter.

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

Obligatoriska parametrar

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--target-id -t

Körningsmotor för kvantberäkningsjobb. När en arbetsyta konfigureras med en uppsättning leverantörer aktiverar de var och en ett eller flera mål. Du kan konfigurera standardmålet med .az quantum target set

--workspace-name -w

Namnet på kvantarbetsytan. Du kan konfigurera standardarbetsytan med .az quantum workspace set

Valfria parametrar

--entry-point

Startpunkten för QIR-programmet eller kretsen. Krävs för QIR. Ignoreras på Q#-jobb.

--job-input-file

Platsen för den indatafil som ska skickas. Krävs för QIR-, QIO- och direktjobb. Ignoreras på Q#-jobb.

--job-input-format

Formatet på filen som ska skickas. Utelämna den här parametern för Q#-jobb.

--job-name

Ett eget namn att ge till den här körningen av programmet.

--job-output-format

Det förväntade utdataformatet för jobb. Ignoreras på Q#-jobb.

--job-params

Jobbparametrar som skickas till målet som en lista över nyckel=värdepar, json-sträng eller @{file} med json-innehåll.

--no-build

[Inaktuell] Om det anges skapas inte Q#-programmet innan det skickas.

Standardvärde: False

--project

[Inaktuell] Platsen för Q#-projektet som ska skickas. Standardvärdet är den aktuella mappen.

--shots

Antal gånger som Q#-programmet ska köras på det angivna målet.

--storage

Om det anges används Anslut ionString för en Azure Storage för att lagra jobbdata och resultat.

--target-capability

Parametern target-capability som skickas till kompilatorn.

<PROGRAM_ARGS>

Lista över argument som förväntas av Q#-åtgärden som anges som --name=value efter --.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc

Standardvärde: json

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az quantum run

Förhandsgranskning

Kommandogruppen "quantum" är i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

az quantum executeMotsvarar .

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

Exempel

Skicka ett Q#-program från den aktuella mappen och vänta på resultatet.

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

Skicka och vänta på ett Q#-program från den aktuella mappen med jobb- och programparametrar.

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

Skicka och vänta på ett Q#-program från den aktuella mappen med en målfunktionsparameter.

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

Obligatoriska parametrar

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--target-id -t

--workspace-name -w

Namnet på kvantarbetsytan. Du kan konfigurera standardarbetsytan med .az quantum workspace set

Valfria parametrar

--entry-point

Startpunkten för QIR-programmet eller kretsen. Krävs för QIR. Ignoreras på Q#-jobb.

--job-input-file

Platsen för den indatafil som ska skickas. Krävs för QIR-, QIO- och direktjobb. Ignoreras på Q#-jobb.

--job-input-format

Formatet på filen som ska skickas. Utelämna den här parametern för Q#-jobb.

--job-name

Ett eget namn att ge till den här körningen av programmet.

--job-output-format

Det förväntade utdataformatet för jobb. Ignoreras på Q#-jobb.

--job-params

Jobbparametrar som skickas till målet som en lista över nyckel=värdepar, json-sträng eller @{file} med json-innehåll.

--no-build

[Inaktuell] Om det anges skapas inte Q#-programmet innan det skickas.

Standardvärde: False

--project

[Inaktuell] Platsen för Q#-projektet som ska skickas. Standardvärdet är den aktuella mappen.

--shots

Antal gånger som Q#-programmet ska köras på det angivna målet.

--storage

Om det anges används Anslut ionString för en Azure Storage för att lagra jobbdata och resultat.

--target-capability

Parametern target-capability som skickas till kompilatorn.

<PROGRAM_ARGS>

Lista över argument som förväntas av Q#-åtgärden som anges som --name=value efter --.

Globala parametrar

--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc

Standardvärde: json

--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

Dela via

az quantum

Kommandon

az quantum execute

Exempel

Obligatoriska parametrar

Valfria parametrar

az quantum run

Exempel

Obligatoriska parametrar

Valfria parametrar

Ytterligare resurser