az quantum

預覽
參考

注意

此參考是 Azure CLI 的量子延伸模組的一部分（2.41.0 版或更高版本）。擴充功能會在您第一次執行 az quantum 命令時自動安裝。深入了解擴充功能。

此命令群組處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

管理 Azure Quantum 工作區，並將作業提交至 Azure Quantum 提供者。

命令

名稱	Description	類型	狀態
az quantum execute	提交作業以在 Azure Quantum 上執行，並等候結果。	副檔名	預覽
az quantum job	管理 Azure Quantum 的工作。	副檔名	預覽
az quantum job cancel	如果 Azure Quantum 上尚未完成作業，請要求取消作業。	副檔名	預覽
az quantum job list	取得 Quantum 工作區中的作業清單。	副檔名	預覽
az quantum job output	取得執行作業的結果。	副檔名	預覽
az quantum job show	取得作業的狀態和詳細數據。	副檔名	預覽
az quantum job submit	提交程式或線路以在 Azure Quantum 上執行。	副檔名	預覽
az quantum job wait	將 CLI 置於等候狀態，直到作業完成執行為止。	副檔名	預覽
az quantum offerings	管理 Azure Quantum 的提供者供應專案。	副檔名	預覽
az quantum offerings accept-terms	接受提供者和 SKU 組合的條款，以啟用它以建立工作區。	副檔名	預覽
az quantum offerings list	取得指定位置上所有可用的提供者供應項目清單。	副檔名	預覽
az quantum offerings show-terms	顯示提供者和 SKU 組合的條款，包括授權 URL 和接受狀態。	副檔名	預覽
az quantum run	相當於 `az quantum execute`。	副檔名	預覽
az quantum target	管理 Azure Quantum 工作區的目標。	副檔名	預覽
az quantum target clear	清除預設的目標識別碼。	副檔名	預覽
az quantum target list	取得 Azure Quantum 工作區中的提供者及其目標清單。	副檔名	預覽
az quantum target set	選取將作業提交至 Azure Quantum 時要使用的預設目標。	副檔名	預覽
az quantum target show	取得將作業提交至 Azure Quantum 時，目前預設目標的目標目標標識碼。	副檔名	預覽
az quantum workspace	管理 Azure Quantum 工作區。	副檔名	預覽
az quantum workspace clear	清除預設的 Azure Quantum 工作區。	副檔名	預覽
az quantum workspace create	建立新的 Azure Quantum 工作區。	副檔名	預覽
az quantum workspace delete	刪除指定的（或目前） Azure Quantum 工作區。	副檔名	預覽
az quantum workspace keys	管理 Azure Quantum 工作區 API 金鑰。	副檔名	預覽
az quantum workspace keys list	列出指定 Azure Quantum 工作區的 API 金鑰。	副檔名	預覽
az quantum workspace keys regenerate	為指定的 Azure Quantum 工作區重新產生 API 金鑰。	副檔名	預覽
az quantum workspace list	取得可用的 Azure Quantum 工作區清單。	副檔名	預覽
az quantum workspace quotas	列出指定（或目前） Azure Quantum 工作區的配額。	副檔名	預覽
az quantum workspace set	選取預設的 Azure Quantum 工作區以取得未來的命令。	副檔名	預覽
az quantum workspace show	取得指定 Azure Quantum 工作區的詳細數據。	副檔名	預覽
az quantum workspace update	更新指定的（或目前） Azure Quantum 工作區。	副檔名	預覽

az quantum execute

預覽

命令群組『quantum』處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

提交作業以在 Azure Quantum 上執行，並等候結果。

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

範例

從目前資料夾提交 Q# 程式，並等候結果。

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

使用作業和程序參數，從目前資料夾提交並等候 Q# 程式。

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

使用 target-capability 參數，從目前資料夾提交並等候 Q# 程式。

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

必要參數

--location -l

位置。來自的值： az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--target-id -t

量子運算作業的執行引擎。當工作區設定為一組提供者時，它們都會啟用一或多個目標。您可以使用來設定預設目標 az quantum target set。

--workspace-name -w

Quantum 工作區的名稱。您可以使用來設定預設工作區 az quantum workspace set。

選擇性參數

--entry-point

QIR 程式或線路的進入點。 QIR 的必要專案。在 Q# 作業上忽略。

--job-input-file

要送出之輸入檔的位置。 QIR、QIO 和傳遞作業的必要專案。在 Q# 作業上忽略。

--job-input-format

要送出之檔案的格式。在 Q# 作業上省略此參數。

--job-name

要提供給此程式的易記名稱。

--job-output-format

預期的作業輸出格式。在 Q# 作業上忽略。

--job-params

傳遞至目標做為 key=value pair、json 字串或 @{file} json 內容列表的作業參數。

--no-build

[已淘汰]如果指定，則不會在提交之前建置 Q# 程式。

預設值: False

--project

[已淘汰]要提交之 Q# 專案的位置。預設為目前資料夾。

--shots

在指定目標上執行 Q# 程式的次數。

--storage

如果指定，則會使用 Azure 儲存體的連線 ionString 來儲存作業數據和結果。

--target-capability

傳遞至編譯程序的目標功能參數。

<PROGRAM_ARGS>

Q# 作業所預期的自變數清單，指定為 --name=value 之後 --。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

az quantum run

預覽

命令群組『quantum』處於預覽狀態，且正在開發中。參考和支援層級： https://aka.ms/CLI_refstatus

相當於 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>]

範例

從目前資料夾提交 Q# 程式，並等候結果。

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

使用作業和程序參數，從目前資料夾提交並等候 Q# 程式。

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

使用 target-capability 參數，從目前資料夾提交並等候 Q# 程式。

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

必要參數

--location -l

位置。來自的值： az account list-locations。您可以使用 az configure --defaults location=<location> 設定預設位置。

--resource-group -g

資源群組的名稱。您可以使用 az configure --defaults group=<name> 來設定預設群組。

--target-id -t

量子運算作業的執行引擎。當工作區設定為一組提供者時，它們都會啟用一或多個目標。您可以使用來設定預設目標 az quantum target set。

--workspace-name -w

Quantum 工作區的名稱。您可以使用來設定預設工作區 az quantum workspace set。

選擇性參數

--entry-point

QIR 程式或線路的進入點。 QIR 的必要專案。在 Q# 作業上忽略。

--job-input-file

要送出之輸入檔的位置。 QIR、QIO 和傳遞作業的必要專案。在 Q# 作業上忽略。

--job-input-format

要送出之檔案的格式。在 Q# 作業上省略此參數。

--job-name

要提供給此程式的易記名稱。

--job-output-format

預期的作業輸出格式。在 Q# 作業上忽略。

--job-params

傳遞至目標做為 key=value pair、json 字串或 @{file} json 內容列表的作業參數。

--no-build

[已淘汰]如果指定，則不會在提交之前建置 Q# 程式。

預設值: False

--project

[已淘汰]要提交之 Q# 專案的位置。預設為目前資料夾。

--shots

在指定目標上執行 Q# 程式的次數。

--storage

如果指定，則會使用 Azure 儲存體的連線 ionString 來儲存作業數據和結果。

--target-capability

傳遞至編譯程序的目標功能參數。

<PROGRAM_ARGS>

Q# 作業所預期的自變數清單，指定為 --name=value 之後 --。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。您可以使用來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。使用 --debug 來取得完整偵錯記錄。

共用方式為

az quantum

命令

az quantum execute

範例

必要參數

選擇性參數

az quantum run

範例

必要參數

選擇性參數

其他資源