共用方式為

az powerbi embedded-capacity

  • 預覽
  • 參考

備註

此參考是 Azure CLI powerbidedicated 延伸模組的一部分（2.56.0 版或更高版本）。 擴充功能會在您第一次 執行 az powerbi embedded-capacity 命令時自動安裝。 深入瞭解擴充功能。

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

管理 PowerBI 內嵌容量。

命令

名稱 Description 類型 狀態
az powerbi embedded-capacity create

建立新的PowerBI內嵌容量。

 擴充套件 預覽
az powerbi embedded-capacity delete

刪除指定的PowerBI內嵌容量。

 擴充套件 預覽
az powerbi embedded-capacity list

列出指定資源群組的所有內嵌容量。

 擴充套件 預覽
az powerbi embedded-capacity list-sku

列出 PowerBI 專用資源的合格 SKU。

 擴充套件 預覽
az powerbi embedded-capacity show

取得指定 PowerBI 內嵌容量的詳細數據。

 擴充套件 預覽
az powerbi embedded-capacity update

更新指定的PowerBI內嵌容量。

 擴充套件 預覽
az powerbi embedded-capacity wait

將 CLI 置於等候狀態，直到符合條件為止。

 擴充套件 預覽

az powerbi embedded-capacity create

預覽

命令群組 'powerbi embedded-capacity' 處於預覽狀態，目前正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

建立新的PowerBI內嵌容量。

az powerbi embedded-capacity create --name
                                    --resource-group
                                    --sku-name
                                    [--administration-members]
                                    [--location]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--sku-tier {PBIE_Azure}]
                                    [--tags]

範例

建立新的PowerBI內嵌容量。

az powerbi embedded-capacity create --resource-group "TestRG" --name "azsdktest" --location eastus --sku-name "A1" --sku-tier "PBIE_Azure" --administration-members "azsdktest@microsoft.com" "azsdktest2@microsoft.com"

建立新的 PowerBI 內嵌容量而不等待。

az powerbi embedded-capacity create --resource-group "TestRG" --name "azsdktest" --location eastus --sku-name "A1" --sku-tier "PBIE_Azure" --administration-members "azsdktest@microsoft.com" "azsdktest2@microsoft.com" --no-wait

必要參數

--name -n

專用容量的名稱。 長度必須至少為 3 個字元，且不超過 63 個字元。

--resource-group -g

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

--sku-name

SKU 層級的名稱。 如需詳細資訊，請參閱 https://azure.microsoft.com/en- us/pricing/details/power-bi-embedded/。 允許的值：A1、A2、A3、A4、A5、A6。

選擇性參數

--administration-members

系統管理員使用者身分識別的陣列。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--location -l

位置。 值的來源：az account list-locations。 您可以使用 az configure --defaults location=<location>來設定預設位置。 未指定時，將會使用資源群組的位置。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--sku-tier

套用 SKU 的 Azure 定價層名稱。

接受的值: PBIE_Azure
--tags

以空格分隔的標記：key[=value] [key[=value] ...]。支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

全域參數
--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 powerbi embedded-capacity delete

預覽

命令群組 'powerbi embedded-capacity' 處於預覽狀態，目前正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

刪除指定的PowerBI內嵌容量。

az powerbi embedded-capacity delete [--ids]
                                    [--name]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

範例

刪除指定資源群組中的容量。

az powerbi embedded-capacity delete --resource-group "TestRG" --name "azsdktest"

刪除指定資源群組中的容量，而不提示。

az powerbi embedded-capacity delete --resource-group "TestRG" --name "azsdktest" -y

刪除指定資源群組中的容量，而不需等候。

az powerbi embedded-capacity delete --resource-group "TestRG" --name "azsdktest" --no-wait

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

專用容量的名稱。 長度必須至少為 3 個字元，且不超過 63 個字元。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--yes -y

請勿提示確認。

預設值: False
全域參數
--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 powerbi embedded-capacity list

預覽

命令群組 'powerbi embedded-capacity' 處於預覽狀態，目前正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

列出指定資源群組的所有內嵌容量。

az powerbi embedded-capacity list [--resource-group]

範例

列出資源群組中的容量

az powerbi embedded-capacity list --resource-group "TestRG"

列出預設訂用帳戶中的所有容量。

az powerbi embedded-capacity list

選擇性參數

--resource-group -g

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

全域參數
--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 powerbi embedded-capacity list-sku

預覽

命令群組 'powerbi embedded-capacity' 處於預覽狀態，目前正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

列出 PowerBI 專用資源的合格 SKU。

az powerbi embedded-capacity list-sku [--dedicated-capacity-name]
                                      [--ids]
                                      [--resource-group]
                                      [--subscription]

選擇性參數

--dedicated-capacity-name --name -n

專用容量的名稱。 長度必須至少為 3 個字元，且不超過 63 個字元。

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--resource-group -g

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

--subscription

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

全域參數
--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 powerbi embedded-capacity show

預覽

命令群組 'powerbi embedded-capacity' 處於預覽狀態，目前正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

取得指定 PowerBI 內嵌容量的詳細數據。

az powerbi embedded-capacity show [--ids]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]

範例

取得容量的詳細數據

az powerbi embedded-capacity show --resource-group "TestRG" --name "azsdktest"

選擇性參數

--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

專用容量的名稱。 長度必須至少為 3 個字元，且不超過 63 個字元。

--resource-group -g

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

--subscription

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

全域參數
--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 powerbi embedded-capacity update

預覽

命令群組 'powerbi embedded-capacity' 處於預覽狀態，目前正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

更新指定的PowerBI內嵌容量。

az powerbi embedded-capacity update [--add]
                                    [--administration-members]
                                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--ids]
                                    [--name]
                                    [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--remove]
                                    [--resource-group]
                                    [--set]
                                    [--sku-name]
                                    [--sku-tier {PBIE_Azure}]
                                    [--subscription]
                                    [--tags]

範例

更新指定 PowerBI 內嵌容量的 SKU 名稱。

az powerbi embedded-capacity update --resource-group "TestRG" --name "azsdktest" --sku-name "A1"

更新指定 PowerBI 內嵌容量的系統管理員成員，而不需等候。

az powerbi embedded-capacity update --resource-group "TestRG" --name "azsdktest" --sku-name "A1" --administration-members "azsdktest3@microsoft.com" --no-wait

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例： --add property.listProperty <key=value, string or JSON string>.

--administration-members

系統管理員使用者身分識別的陣列。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

專用容量的名稱。 長度必須至少為 3 個字元，且不超過 63 個字元。

--no-wait

請勿等候長時間執行的作業完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--remove

從清單中移除屬性或專案。 範例： --remove property.list <indexToRemove> 或 --remove propertyToRemove。

--resource-group -g

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

--set

指定要設定的屬性路徑和值，以更新物件。 範例： --set property1.property2=<value>.

--sku-name

SKU 層級的名稱。 如需詳細資訊，請參閱 https://azure.microsoft.com/en- us/pricing/details/power-bi-embedded/。 允許的值：A1、A2、A3、A4、A5、A6。

--sku-tier

套用 SKU 的 Azure 定價層名稱。

接受的值: PBIE_Azure
--subscription

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

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

全域參數
--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 powerbi embedded-capacity wait

預覽

命令群組 'powerbi embedded-capacity' 處於預覽狀態，目前正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

將 CLI 置於等候狀態，直到符合條件為止。

az powerbi embedded-capacity wait [--created]
                                  [--custom]
                                  [--deleted]
                                  [--exists]
                                  [--ids]
                                  [--interval]
                                  [--name]
                                  [--resource-group]
                                  [--subscription]
                                  [--timeout]
                                  [--updated]

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False
--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False
--exists

等候資源存在。

預設值: False
--ids

一或多個資源識別碼（以空格分隔）。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--interval

輪詢間隔以秒為單位。

預設值: 30
--name -n

專用容量的名稱。 長度必須至少為 3 個字元，且不超過 63 個字元。

--resource-group -g

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

--subscription

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

--timeout

以秒為單位的等候上限。

預設值: 3600
--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False
全域參數
--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。