az quantum workspace

  • 預覽

Note

此參考是Azure CLIquantum擴充（版本2.73.0或更高版本）的一部分。 當您第一次執行 az quantum workspace 命令時，擴充功能會自動安裝。 深入了解擴充功能。

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

Manage Azure Quantum workspaces.

命令

名稱 Description 類型 狀態
az quantum workspace clear

清除預設的 Azure Quantum 工作空間。

 Extension Preview
az quantum workspace create

建立一個新嘅 Azure Quantum 工作空間。

 Extension Preview
az quantum workspace delete

刪除給定（或目前）的 Azure Quantum 工作空間。

 Extension Preview
az quantum workspace keys

Manage Azure Quantum Workspace API keys.

 Extension Preview
az quantum workspace keys list

列出給定（或目前）Azure Quantum workspace 的 API 鍵。

 Extension Preview
az quantum workspace keys regenerate

Regenerate API key for the given （或current the given of the given or current） Azure Quantum workspace.

 Extension Preview
az quantum workspace list

取得可用 Azure Quantum 工作空間清單。

 Extension Preview
az quantum workspace quotas

列出給定（或目前）Azure Quantum 工作空間的配額。

 Extension Preview
az quantum workspace set

選擇預設 Azure Quantum workspace for future commands。

 Extension Preview
az quantum workspace show

取得給定（或目前）Azure Quantum 工作區的詳細資訊。

 Extension Preview
az quantum workspace update

更新指定（或目前）的 Azure Quantum 工作空間。

 Extension Preview

az quantum workspace clear

預覽

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

清除預設的 Azure Quantum 工作空間。

az quantum workspace clear [--acquire-policy-token]
                           [--change-reference]

範例

如果之前設定過，請清除預設的 Azure Quantum 工作區。

az quantum workspace clear

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az quantum workspace create

預覽

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

建立一個新嘅 Azure Quantum 工作空間。

az quantum workspace create --location
                            --resource-group
                            --storage-account
                            --workspace-name
                            
                            [--acquire-policy-token]
                            [--auto-accept]
                            [--change-reference]
                            [--provider-sku-list]
                            [--skip-autoadd]
                            [--skip-role-assignment]

範例

建立一個新的 Azure Quantum 工作空間，與提供免費信用的供應商一起使用。

az quantum workspace create -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -a MyStorageAccountName

建立一個新的 Azure Quantum 工作空間，並列出特定的提供者清單。

az quantum workspace create -g MyResourceGroup -w MyWorkspace -l MyLocation \
    -r "MyProvider1 / MySKU1, MyProvider2 / MySKU2" --skip-autoadd -a MyStorageAccountName

To display a list of available providers and their SKUs, use the following command:
    az quantum offerings list -l MyLocation -o table

必要參數

--location
已被取代

選項「--location」已被棄用，將於 2026 年 5 月移除。

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

--resource-group -g

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

--storage-account -a

要供量子工作區使用的記憶體帳戶名稱。

--workspace-name -w

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

-l

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--auto-accept

如果指定，則會接受提供者條款，而不需要互動式 Y/N 提示。

屬性 值
預設值: False
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--provider-sku-list -r

提供者/SKU 配對的逗號分隔清單。 以斜線分隔提供者和 SKU。 以引號括住整個清單。 來自 az quantum offerings list -l <location> -o table的值。

--skip-autoadd

如果指定，則不會自動新增提供免費點數的方案。

屬性 值
預設值: False
--skip-role-assignment

略過記憶體帳戶中量子工作區的角色指派步驟。

屬性 值
預設值: False
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az quantum workspace delete

預覽

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

刪除給定（或目前）的 Azure Quantum 工作空間。

az quantum workspace delete --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--change-reference]

範例

依資源群組和工作區名稱刪除 Azure Quantum 工作空間。 如果已設定預設工作區，則不需要 -g 和 -w 參數。

az quantum workspace delete -g MyResourceGroup -w MyWorkspace

必要參數

--resource-group -g

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

--workspace-name -w

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az quantum workspace list

預覽

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

取得可用 Azure Quantum 工作空間清單。

az quantum workspace list [--location]
                          [--resource-group]
                          [--tag]
                          []

範例

取得所有可用 Azure Quantum 工作空間的清單。

az quantum workspace list

取得某地點可用的 Azure Quantum 工作空間列表。

az quantum workspace list -l MyLocation

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--location
已被取代

選項「--location」已被棄用，將於 2026 年 5 月移除。

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

--resource-group -g

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

--tag

只顯示已關聯指定標記的量子工作區。

-l

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

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az quantum workspace quotas

預覽

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

列出給定（或目前）Azure Quantum 工作空間的配額。

az quantum workspace quotas --resource-group
                            --workspace-name
                            [--acquire-policy-token]
                            [--change-reference]
                            [--location]
                            []

範例

列出指定 Azure Quantum 工作空間的配額資訊。 如果已設定預設工作區，則不需要 -g、-w 和 -l 參數。

az quantum workspace quotas -g MyResourceGroup -w MyWorkspace -l MyLocation

必要參數

--resource-group -g

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

--workspace-name -w

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--location
已被取代

選項「--location」已被棄用，將於 2026 年 5 月移除。

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

-l
已被取代

參數「--location」已被棄用，將於 2026 年 5 月移除。

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

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az quantum workspace set

預覽

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

選擇預設 Azure Quantum workspace for future commands。

az quantum workspace set --resource-group
                         --workspace-name
                         [--acquire-policy-token]
                         [--change-reference]
                         [--location]
                         []

範例

Set the default Azure Quantum workspace.

az quantum workspace set -g MyResourceGroup -w MyWorkspace -l MyLocation

必要參數

--resource-group -g

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

--workspace-name -w

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

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--location
已被取代

選項「--location」已被棄用，將於 2026 年 5 月移除。

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

-l
已被取代

參數「--location」已被棄用，將於 2026 年 5 月移除。

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

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az quantum workspace show

預覽

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

取得給定（或目前）Azure Quantum 工作區的詳細資訊。

az quantum workspace show [--resource-group]
                          [--workspace-name]

範例

顯示目前選擇的預設 Azure Quantum 工作空間。

az quantum workspace show

顯示所提供的 Azure Quantum 工作空間詳情。

az quantum workspace show -g MyResourceGroup -w MyWorkspace

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--resource-group -g

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

--workspace-name -w

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

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False

az quantum workspace update

預覽

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

更新指定（或目前）的 Azure Quantum 工作空間。

az quantum workspace update [--acquire-policy-token]
                            [--change-reference]
                            [--enable-api-key]
                            [--resource-group]
                            [--workspace-name]

範例

Enable a provided a Azure Quantum workspace api keys.

az quantum workspace update --enable-api-key True

Disable a provided a Provided Azure Quantum workspace api keys.

az quantum workspace update --enable-api-key False

選擇性參數

下列參數是選擇性參數，但視內容而定，命令可能需要一或多個參數才能成功執行。

--acquire-policy-token

自動取得 Azure 原則 令牌以進行此資源操作。

屬性 值
參數群組: Global Policy Arguments
--change-reference

相關變更的 ID 是為此資源操作所參考的。

屬性 值
參數群組: Global Policy Arguments
--enable-api-key

啟用或停用 API 金鑰驗證。

--resource-group -g

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

--workspace-name -w

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

全域參數
--debug

提高日誌詳細程度以顯示所有調試日誌。

屬性 值
預設值: False
--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

屬性 值
預設值: False
--output -o

輸出格式。

屬性 值
預設值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。

屬性 值
預設值: False