az hybridaks

注意

此參考是 Azure CLI 的混合式 擴充功能的一部分 （2.32.0 版或更高版本）。 擴充功能會在您第一次執行 az hybridaks 命令時自動安裝。 深入了解擴充功能。

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

管理已布建的混合式叢集。

命令

名稱	Description	類型	狀態
az hybridaks create	建立混合式 AKS 布建叢集。	副檔名	預覽版
az hybridaks delete	刪除混合式 AKS 布建叢集。	副檔名	預覽版
az hybridaks get-upgrades	取得混合式 AKS 布建叢集可用的升級版本。	副檔名	預覽版
az hybridaks list	列出資源群組或訂用帳戶中的混合式 AKS 布建叢集。	副檔名	預覽版
az hybridaks nodepool	管理混合式布建叢集中的節點集區。	副檔名	預覽版
az hybridaks nodepool add	在混合式 AKS 布建叢集中新增節點集區。	副檔名	預覽版
az hybridaks nodepool delete	刪除混合式 AKS 布建叢集中的 nodepool。	副檔名	預覽版
az hybridaks nodepool list	列出混合式 AKS 布建叢集中的所有節點集區。	副檔名	預覽版
az hybridaks nodepool scale	調整混合式 AKS 布建叢集中的節點集區。	副檔名	預覽版
az hybridaks nodepool show	取得混合式 AKS 布建叢集中的 nodepool。	副檔名	預覽版
az hybridaks notice	將 NOTICE 檔案輸出至使用者指定的 filepath。	副檔名	預覽版
az hybridaks proxy	取得已連線混合式 AKS 布建叢集的存取權。	副檔名	預覽版
az hybridaks show	取得混合式 AKS 布建叢集。	副檔名	預覽版
az hybridaks update	更新混合式 AKS 布建叢集。	副檔名	預覽版
az hybridaks upgrade	升級混合式 AKS 布建叢集。	副檔名	預覽版
az hybridaks vnet	管理混合式虛擬網路。	副檔名	預覽版
az hybridaks vnet create	建立混合式 AKS 虛擬網路。	副檔名	預覽版
az hybridaks vnet delete	刪除混合式 AKS 虛擬網路。	副檔名	預覽版
az hybridaks vnet list	依資源群組或訂用帳戶列出混合式 AKS 虛擬網路。	副檔名	預覽版
az hybridaks vnet show	取得混合式 AKS 虛擬網路。	副檔名	預覽版

az hybridaks create

預覽

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

建立混合式 AKS 布建叢集。

az hybridaks create --custom-location
                    --name
                    --resource-group
                    [--aad-admin-group-object-ids]
                    [--addon]
                    [--arc-agent-auto-upgrade]
                    [--arc-agent-version]
                    [--control-plane-count]
                    [--control-plane-ip]
                    [--control-plane-vm-size]
                    [--generate-ssh-keys]
                    [--kubernetes-version]
                    [--load-balancer-count]
                    [--load-balancer-sku]
                    [--load-balancer-vm-size]
                    [--location]
                    [--no-ssh-key]
                    [--no-wait]
                    [--node-count]
                    [--node-vm-size]
                    [--pod-cidr]
                    [--service-cidr]
                    [--ssh-key-value]
                    [--tags]
                    [--vnet-ids]
                    [--zones]

範例

PutProvisionedCluster

az hybridaks create -g sample-rg --custom-location sample-cl -n sample-hybridakscluster --vnet-id vnet1

必要參數

--custom-location

要用於布建叢集之自訂位置的名稱或識別碼。

--name -n

布建叢集的名稱。

--resource-group -g

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

選擇性參數

--aad-admin-group-object-ids -i

將在布建叢集上設定為叢集管理員之 aad 群組物件識別碼的逗號分隔清單。

--addon -a

啟用附加元件。 您可以藉由指定此旗標來新增多個附加元件。 使用量：--addon name=addon-name [config_key=config_value ...]。

--arc-agent-auto-upgrade

Arc Agent 自動升級。

預設值: Enabled

--arc-agent-version

Arc 代理程式版本。

--control-plane-count

控制平面節點的數目。

--control-plane-ip

控制平面的 API 伺服器 IP 位址。

--control-plane-vm-size

控制平面的 VM 大小。

--generate-ssh-keys

如果不存在，請產生 ssh 金鑰組。

預設值: False

--kubernetes-version -k

布建叢集的 kubernetes 版本。

--load-balancer-count

負載平衡器節點數目。

--load-balancer-sku

負載平衡器的類型。 選項：「unstacked-haproxy」 |「stacked-kube-vip」 |「stacked-metallb」 |「unmanaged」。

--load-balancer-vm-size

負載平衡器的 VM 大小。

--location -l

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

--no-ssh-key -x

請勿使用 插入任何公開金鑰。

預設值: False

--no-wait

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

預設值: False

--node-count -c

要建立于 nodepool 中的節點數目。

--node-vm-size

nodepool 中節點的 VM 大小。

--pod-cidr

要從中指派 Pod IP 的 CIDR 標記法 IP 範圍。

--service-cidr

要從中指派服務叢集 IP 的 CIDR 標記法 IP 範圍。

--ssh-key-value

要插入控制平面之 SSH 公開金鑰的路徑。

預設值: ~\.ssh\id_rsa.pub

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「」 清除現有的標記。

--vnet-ids

HybridAKS VNet 的 ARM 資源識別碼。

--zones -z

將放置控制平面節點的可用性區域逗號分隔清單。

全域參數

--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 hybridaks delete

預覽

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

刪除混合式 AKS 布建叢集。

az hybridaks delete --name
                    --resource-group
                    [--no-wait]
                    [--yes]

範例

DeleteProvisionedCluster

az hybridaks delete --name "sample-hybridakscluster" --resource-group "sample-rg"

必要參數

--name -n

布建叢集的名稱。

--resource-group -g

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

選擇性參數

--no-wait

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

預設值: False

--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 hybridaks get-upgrades

預覽

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

取得混合式 AKS 布建叢集可用的升級版本。

az hybridaks get-upgrades --name
                          --resource-group

範例

取得混合式 AKS 布建叢集可用的升級版本

az hybridaks get-upgrades --name "samplecluster" --resource-group "sample-rg"

必要參數

--name -n

布建叢集的名稱。

--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 hybridaks list

預覽

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

列出資源群組或訂用帳戶中的混合式 AKS 布建叢集。

az hybridaks list [--resource-group]

範例

ListProvisionedClusterByResourceGroup

az hybridaks list --resource-group "sample-rg"

ListProvisionedClusterBySubscription

az hybridaks 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 hybridaks notice

預覽

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

將 NOTICE 檔案輸出至使用者指定的 filepath。

az hybridaks notice --output-filepath

範例

GetNoticeFile

az hybridaks notice --output-filepath "./Notice"

必要參數

--output-filepath

針對 NOTICE 檔案輸出 filepath。

全域參數

--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 hybridaks proxy

預覽

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

取得已連線混合式 AKS 布建叢集的存取權。

az hybridaks proxy [--file]
                   [--ids]
                   [--kube-context]
                   [--name]
                   [--port]
                   [--resource-group]
                   [--subscription]
                   [--token]

範例

取得已連線 Kubernetes 叢集的存取權。

az hybridaks proxy -n clusterName -g resourceGroupName

使用自訂埠存取已連線的 kubernetes 叢集

az hybridaks proxy -n clusterName -g resourceGroupName --port portValue

使用服務帳戶權杖取得已連線 Kubernetes 叢集的存取權

az hybridaks proxy -n clusterName -g resourceGroupName --token tokenValue

藉由指定自訂 kubeconfig 位置，取得已連線 Kubernetes 叢集的存取權

az hybridaks proxy -n clusterName -g resourceGroupName -f path/to/kubeconfig

藉由指定自訂內容來取得已連線 Kubernetes 叢集的存取權

az hybridaks proxy -n clusterName -g resourceGroupName --kube-context contextName

選擇性參數

--file -f

要更新的 Kubernetes 組態檔。 如果未提供，請更新檔案 '~/.kube/config'。 請改用 '-' 列印 YAML 至 stdout。

預設值: ~\.kube\config

--ids

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

--kube-context

如果指定，請覆寫預設內容名稱。

--name -n

混合式 AKS 布建叢集的名稱。

--port

用於存取已連線叢集的埠。

預設值: 47013

--resource-group -g

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

--subscription

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

--token

用來向 kubernetes 叢集進行驗證的服務帳戶權杖。

全域參數

--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 hybridaks show

預覽

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

取得混合式 AKS 布建叢集。

az hybridaks show --name
                  --resource-group

範例

GetProvisionedCluster

az hybridaks show --name "sample-hybridakscluster" --resource-group "sample-rg"

必要參數

--name -n

布建叢集的名稱。

--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 hybridaks update

預覽

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

更新混合式 AKS 布建叢集。

az hybridaks update --name
                    --resource-group
                    [--aad-admin-group-object-ids]
                    [--tags]

範例

UpdateProvisionedCluster

az hybridaks update --tags additionalProperties="sample" --name "sample-hybridakscluster" --resource-group "sample-rg"

必要參數

--name -n

布建叢集的名稱。

--resource-group -g

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

選擇性參數

--aad-admin-group-object-ids -i

將在布建叢集上設定為叢集管理員之 aad 群組物件識別碼的逗號分隔清單。

--tags

以空格分隔的標記：key[=value] [key[=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 hybridaks upgrade

預覽

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

升級混合式 AKS 布建叢集。

az hybridaks upgrade --name
                     --resource-group
                     [--kubernetes-version]
                     [--no-wait]
                     [--node-image-only]
                     [--yes]

範例

UpgradeProvisionedCluster

az hybridaks upgrade --name "sample-hybridakscluster" --resource-group "sample-rg" --kubernetes-version v1.22.2

UpgradeProvisionedClusterNodeImage

az hybridaks upgrade --name "sample-hybridakscluster" --resource-group "sample-rg" --node-image-only

必要參數

--name -n

布建叢集的名稱。

--resource-group -g

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

選擇性參數

--kubernetes-version -k

布建叢集的 kubernetes 版本。

--no-wait

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

預設值: False

--node-image-only

僅升級節點映射的旗標。

預設值: False

--yes

停用確認提示的旗標。

預設值: 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 來取得完整偵錯記錄。