共用方式為

az sql vm

  • 參考

管理 SQL 虛擬機。

命令

名稱 Description 類型 狀態
az sql vm add-to-group

將 SQL 虛擬機新增至 SQL 虛擬機群組。

 核心 GA
az sql vm create

建立 SQL 虛擬機。

 核心 GA
az sql vm delete

刪除 SQL 虛擬機。

 核心 GA
az sql vm enable-azure-ad-auth

啟用 SQL 虛擬機的 Azure AD 驗證。

 核心 GA
az sql vm group

管理 SQL 虛擬機群組。

 核心 GA
az sql vm group ag-listener

管理 SQL 可用性群組接聽程式。

 核心 GA
az sql vm group ag-listener create

建立可用性群組接聽程式。

 核心 GA
az sql vm group ag-listener delete

刪除可用性群組接聽程式。

 核心 GA
az sql vm group ag-listener list

列出 SQL 虛擬機群組中的所有可用性群組接聽程式。

 核心 GA
az sql vm group ag-listener show

取得可用性群組接聽程式。

 核心 GA
az sql vm group ag-listener update

更新 可用性群組接聽程式。

 核心 GA
az sql vm group create

建立 SQL 虛擬機群組。

 核心 GA
az sql vm group delete

刪除 SQL 虛擬機群組。

 核心 GA
az sql vm group list

列出資源群組或訂用帳戶中的所有 SQL 虛擬機群組。

 核心 GA
az sql vm group show

取得 SQL 虛擬機群組。

 核心 GA
az sql vm group update

如果沒有 SQL 虛擬機連結至群組，更新 SQL 虛擬機器群組。

 核心 GA
az sql vm list

列出資源群組或訂用帳戶中的所有 SQL 虛擬機。

 核心 GA
az sql vm remove-from-group

從目前的 SQL 虛擬機群組中移除 SQL 虛擬機。

 核心 GA
az sql vm show

取得 SQL 虛擬機。

 核心 GA
az sql vm start-assessment

在 SQL 虛擬機上啟動 SQL 最佳做法評估。

 核心 GA
az sql vm update

更新 SQL 虛擬機的屬性。

 核心 GA
az sql vm validate-azure-ad-auth

在客戶端驗證 SQL 虛擬機的 Azure AD 驗證，而不啟用它。

 核心 GA

az sql vm add-to-group

編輯

將 SQL 虛擬機新增至 SQL 虛擬機群組。

az sql vm add-to-group --sqlvm-group
                       [--bootstrap-acc-pwd]
                       [--ids]
                       [--name]
                       [--operator-acc-pwd]
                       [--resource-group]
                       [--service-acc-pwd]
                       [--subscription]

範例

將 SQL 虛擬機新增至群組。

az sql vm add-to-group -n sqlvm -g myresourcegroup --sqlvm-group sqlvmgroup --bootstrap-acc-pwd {bootstrappassword} --operator-acc-pwd {operatorpassword} --service-acc-pwd {servicepassword}

必要參數

--sqlvm-group -r

SQL 虛擬機群組的名稱或資源識別碼。 如果只提供名稱，SQL 虛擬機群組應該位於 SQL 虛擬機的相同資源群組中。

選擇性參數

--bootstrap-acc-pwd -b

如果在 SQL 虛擬機群組中提供，則為叢集啟動程式帳戶的密碼。

--ids

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

--name -n

SQL 虛擬機的名稱。

--operator-acc-pwd -p

SQL 虛擬機群組中提供的叢集操作員帳戶密碼。

--resource-group -g

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

--service-acc-pwd -s

SQL 虛擬機群組中提供的 SQL 服務帳戶密碼。

--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 sql vm create

編輯

建立 SQL 虛擬機。

az sql vm create --name
                 --resource-group
                 [--backup-pwd]
                 [--backup-schedule-type {Automated, Manual}]
                 [--backup-system-dbs {false, true}]
                 [--connectivity-type {LOCAL, PRIVATE, PUBLIC}]
                 [--credential-name]
                 [--day-of-week {Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--enable-auto-backup {false, true}]
                 [--enable-auto-patching {false, true}]
                 [--enable-encryption {false, true}]
                 [--enable-key-vault-credential {false, true}]
                 [--enable-r-services {false, true}]
                 [--full-backup-duration]
                 [--full-backup-frequency {Daily, Weekly}]
                 [--full-backup-start-hour]
                 [--image-offer]
                 [--image-sku {Developer, Enterprise, Express, Standard, Web}]
                 [--key-vault]
                 [--least-privilege-mode {Enabled, NotSet}]
                 [--license-type {AHUB, DR, PAYG}]
                 [--location]
                 [--log-backup-frequency]
                 [--maintenance-window-duration]
                 [--maintenance-window-start-hour]
                 [--port]
                 [--retention-period]
                 [--sa-key]
                 [--sp-name]
                 [--sp-secret]
                 [--sql-auth-update-pwd]
                 [--sql-auth-update-username]
                 [--sql-mgmt-type {Full, LightWeight, NoAgent}]
                 [--sql-workload-type {DW, GENERAL, OLTP}]
                 [--storage-account]
                 [--tags]

範例

使用 AHUB 計費標記建立 SQL 虛擬機。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type AHUB

建立具有DR計費標籤的 SQL 虛擬機。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type DR

建立具有特定 SKU 類型和授權類型的 SQL 虛擬機。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --image-sku Enterprise --license-type AHUB

建立已啟用最低許可權模式的 SQL 虛擬機。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --least-privilege-mode Enabled --sql-mgmt-type Full

建立具有 NoAgent 類型的 SQL 虛擬機，僅適用於 EOS SQL 2008 和 SQL 2008 R2。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type AHUB --sql-mgmt-type NoAgent --image-sku Enterprise --image-offer SQL2008-WS2008R2

在 SQL2016 之後啟用 R 服務。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --enable-r-services true

建立 SQL 虛擬機並設定自動備份設定。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --backup-schedule-type manual --full-backup-frequency Weekly --full-backup-start-hour 2 --full-backup-duration 2 --sa-key {storageKey} --storage-account 'https://storageacc.blob.core.windows.net/' --retention-period 30 --log-backup-frequency 60

建立 SQL 虛擬機並設定自動修補設定。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --day-of-week sunday --maintenance-window-duration 60 --maintenance-window-start-hour 2

建立 SQL 虛擬機並設定 SQL 連線設定。

az sql vm create -n sqlvm -g myresourcegroup -l eastus --license-type PAYG --sql-mgmt-type Full --connectivity-type private --port 1433 --sql-auth-update-username {newlogin} --sql-auth-update-pwd {sqlpassword}

必要參數

--name -n

SQL 虛擬機的名稱。 新 SQL 虛擬機的名稱必須等於從 SQL Marketplace 映像建立的基礎虛擬機。

--resource-group -g

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

選擇性參數

--backup-pwd

備份時加密的密碼。

--backup-schedule-type

備份排程類型。

接受的值: Automated, Manual
--backup-system-dbs

在備份時包含系統資料庫。

接受的值: false, true
預設值: False
--connectivity-type

SQL Server 連線選項。

接受的值: LOCAL, PRIVATE, PUBLIC
--credential-name

認證名稱。

--day-of-week

要套用修補程式的一周中的一天。

接受的值: Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday
--enable-auto-backup

在 SQL 虛擬機上啟用或停用自動備份。 如果提供任何備份設定，參數會自動設定為 true。

接受的值: false, true
--enable-auto-patching

在 SQL 虛擬機上啟用或停用自動修補。 如果提供任何自動修補設定，參數會自動設定為 true。

接受的值: false, true
--enable-encryption

在 SQL 虛擬機上啟用備份的加密。

接受的值: false, true
預設值: False
--enable-key-vault-credential

啟用或停用金鑰保存庫認證設定。 如果提供任何金鑰保存庫設定，參數會自動設定為 true。

接受的值: false, true
--enable-r-services

啟用或停用 R 服務（SQL 2016 及更新版本）。

接受的值: false, true
--full-backup-duration

可進行完整備份的特定一天時間範圍持續時間。 1-23 小時。

--full-backup-frequency

完整備份的頻率。 在這兩種情況下，完整備份都會在下一個排定的時間範圍期間開始進行。

接受的值: Daily, Weekly
--full-backup-start-hour

可進行完整備份的特定一天開始時間期間。 0-23 小時。

--image-offer

SQL 映像供應專案。 範例包括 SQL2008R2-WS2008、SQL2008-WS2008。

--image-sku

SQL 映像 SKU。

接受的值: Developer, Enterprise, Express, Standard, Web
--key-vault

Azure 金鑰保存庫 URL。

--least-privilege-mode

SQL IaaS 代理程式最低許可權模式。 更新 從系統管理員到每個功能所使用的特定許可權。

接受的值: Enabled, NotSet
--license-type -i

SQL Server 授權類型。

接受的值: AHUB, DR, PAYG
--location -l

位置。​​ 如果未提供，虛擬機應該位於資源群組的相同區域中。您可以使用 來設定預設位置 az configure --defaults location=<location>。

--log-backup-frequency

記錄備份的頻率。 5-60 分鐘。

--maintenance-window-duration

修補的持續時間。 30-180 分鐘。

--maintenance-window-start-hour

起始修補的一天中的小時。 本機 VM 時間 0-23 小時。

--port

SQL Server 連接埠。

--retention-period

備份的保留期間。 1-30 天。

--sa-key

儲存體將進行備份的帳戶金鑰。

--sp-name

用來存取金鑰保存庫的服務主體名稱。

--sp-secret

用來存取金鑰保存庫的服務主體名稱秘密。

--sql-auth-update-pwd

SQL Server 系統管理員登入密碼。

--sql-auth-update-username

要建立的 SQL Server 系統管理員登入。

--sql-mgmt-type
已被取代

自變數 'sql_management_mode' 已被取代，並將在未來版本中移除。

SQL Server 管理類型。 如果已選取 NoAgent，請提供 --image-sku 和 --offer-type。

接受的值: Full, LightWeight, NoAgent
預設值: LightWeight
--sql-workload-type

SQL Server 工作負載類型。

接受的值: DW, GENERAL, OLTP
--storage-account

儲存體將進行備份的帳戶 URL。

--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 sql vm delete

編輯

刪除 SQL 虛擬機。

az sql vm delete [--ids]
                 [--name]
                 [--resource-group]
                 [--subscription]
                 [--yes]

選擇性參數

--ids

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

--name -n

SQL 虛擬機的名稱。

--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 sql vm enable-azure-ad-auth

編輯

啟用 SQL 虛擬機的 Azure AD 驗證。

az sql vm enable-azure-ad-auth [--ids]
                               [--msi-client-id]
                               [--name]
                               [--resource-group]
                               [--skip-client-validation]
                               [--subscription]

範例

使用客戶端驗證來啟用系統指派受控識別的 Azure AD 驗證。

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup

使用客戶端驗證來啟用使用者指派受控識別的 Azure AD 驗證。

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup --msi-client-id 12345678

使用系統指派的受控識別來啟用 Azure AD 驗證，略過客戶端驗證。 伺服器端驗證一律會發生。

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup --skip-client-validation

使用使用者指派的受控識別來啟用 Azure AD 驗證，略過客戶端驗證。 伺服器端驗證一律會發生。

az sql vm enable-azure-ad-auth -n sqlvm -g myresourcegroup --msi-client-id 12345678 --skip-client-validation

選擇性參數

--ids

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

--msi-client-id

V 貝魯特電腦受控識別用戶端標識碼。

--name -n

SQL 虛擬機的名稱。

--resource-group -g

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

--skip-client-validation

略過用戶端 Azure AD 驗證驗證，伺服器端驗證仍會發生。

--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 sql vm list

編輯

列出資源群組或訂用帳戶中的所有 SQL 虛擬機。

az sql vm list [--resource-group]

選擇性參數

--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 sql vm remove-from-group

編輯

從目前的 SQL 虛擬機群組中移除 SQL 虛擬機。

az sql vm remove-from-group [--ids]
                            [--name]
                            [--resource-group]
                            [--subscription]

範例

從群組中移除 SQL 虛擬機。

az sql vm remove-from-group -n sqlvm -g myresourcegroup

選擇性參數

--ids

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

--name -n

SQL 虛擬機的名稱。

--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 sql vm show

編輯

取得 SQL 虛擬機。

az sql vm show [--expand {*, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings}]
               [--ids]
               [--name]
               [--resource-group]
               [--subscription]

選擇性參數

--expand

取得 SQLIaaSExtension 組態設定。 若要檢視所有設定，請使用 *。 若要只選取幾個，設定必須以空格分隔。

接受的值: *, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings
--ids

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

--name -n

SQL 虛擬機的名稱。

--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 sql vm start-assessment

編輯

在 SQL 虛擬機上啟動 SQL 最佳做法評估。

az sql vm start-assessment [--ids]
                           [--name]
                           [--resource-group]
                           [--subscription]

範例

啟動 SQL 最佳做法評估。

az sql vm start-assessment -n sqlvm -g myresourcegroup

選擇性參數

--ids

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

--name -n

SQL 虛擬機的名稱。

--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 sql vm update

編輯

更新 SQL 虛擬機的屬性。

az sql vm update [--add]
                 [--agent-rg]
                 [--am-day {Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--am-month-occ {-1, 1, 2, 3, 4}]
                 [--am-schedule {false, true}]
                 [--am-time]
                 [--am-week-int {1, 2, 3, 4, 5, 6}]
                 [--backup-pwd]
                 [--backup-schedule-type {Automated, Manual}]
                 [--backup-system-dbs {false, true}]
                 [--connectivity-type {LOCAL, PRIVATE, PUBLIC}]
                 [--credential-name]
                 [--day-of-week {Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday}]
                 [--enable-assessment {false, true}]
                 [--enable-auto-backup {false, true}]
                 [--enable-auto-patching {false, true}]
                 [--enable-encryption {false, true}]
                 [--enable-key-vault-credential {false, true}]
                 [--enable-r-services {false, true}]
                 [--force-string]
                 [--full-backup-duration]
                 [--full-backup-frequency {Daily, Weekly}]
                 [--full-backup-start-hour]
                 [--ids]
                 [--image-sku {Developer, Enterprise, Express, Standard, Web}]
                 [--key-vault]
                 [--least-privilege-mode {Enabled, NotSet}]
                 [--license-type {AHUB, DR, PAYG}]
                 [--log-backup-frequency]
                 [--maintenance-window-duration]
                 [--maintenance-window-start-hour]
                 [--name]
                 [--port]
                 [--remove]
                 [--resource-group]
                 [--retention-period]
                 [--sa-key]
                 [--set]
                 [--sp-name]
                 [--sp-secret]
                 [--sql-mgmt-type {Full, LightWeight, NoAgent}]
                 [--sql-workload-type {DW, GENERAL, OLTP}]
                 [--storage-account]
                 [--subscription]
                 [--tags]
                 [--workspace-name]
                 [--workspace-rg]
                 [--workspace-sub]
                 [--yes]

範例

新增或更新標記。

az sql vm update -n sqlvm -g myresourcegroup --set tags.tagName=tagValue

拿掉標籤。

az sql vm update -n sqlvm -g myresourcegroup --remove tags.tagName

使用特定 SKU 類型更新 SQL 虛擬機。

az sql vm update -n sqlvm -g myresourcegroup --image-sku Enterprise

將 SQL 虛擬機管理性從 LightWeight 更新為 Full。

az sql vm update -n sqlvm -g myresourcegroup --sql-mgmt-type Full

將 SQL 虛擬機更新為最低許可權模式。

az sql vm update -n sqlvm -g myresourcegroup --least-privilege-mode Enabled --sql-mgmt-type Full

更新 SQL 虛擬機自動備份設定。

az sql vm update -n sqlvm -g myresourcegroup --backup-schedule-type manual --full-backup-frequency Weekly --full-backup-start-hour 2 --full-backup-duration 2 --sa-key {storageKey} --storage-account 'https://storageacc.blob.core.windows.net/' --retention-period 30 --log-backup-frequency 60

停用 SQL 虛擬機自動備份設定。

az sql vm update -n sqlvm -g myresourcegroup --enable-auto-backup false

更新 SQL 虛擬機自動修補設定。

az sql vm update -n sqlvm -g myresourcegroup --day-of-week sunday --maintenance-window-duration 60 --maintenance-window-start-hour 2

停用 SQL 虛擬機自動修補設定。

az sql vm update -n sqlvm -g myresourcegroup --enable-auto-patching false

將 SQL 虛擬機計費標籤更新為 AHUB。

az sql vm update -n sqlvm -g myresourcegroup --license-type AHUB

將 SQL 虛擬機計費標籤更新為DR。

az sql vm update -n sqlvm -g myresourcegroup --license-type DR

更新 SQL 虛擬機以停用 SQL 最佳做法評估。

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment false

更新 SQL 虛擬機以停用 SQL 最佳做法評定的排程。

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment-schedule false

更新 SQL 虛擬機，以在 VM 已與 Log Analytics 工作區相關聯時，使用每周間隔啟用 SQL 最佳做法評定的排程。

az sql vm update -n sqlvm -g myresourcegroup --assessment-weekly-interval 1 --assessment-day-of-week monday --assessment-start-time-local '19:30'

更新 SQL 虛擬機，以針對 SQL 最佳做法評估啟用每月發生的排程，同時與 Log Analytics 工作區建立關聯，併為 Agent 資源指派資源群組。

az sql vm update -n sqlvm -g myresourcegroup --workspace-name myLogAnalyticsWorkspace --workspace-rg myRg --agent-rg myRg2 --assessment-monthly-occurrence 1 --assessment-day-of-week monday --assessment-start-time-local '19:30'

更新 SQL 虛擬機以啟用 SQL 最佳做法評定，而不需設定依需求執行評定的排程。 必須提供Log Analytics工作區和資源群組，才能部署Agent資源。

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment true --workspace-name myLogAnalyticsWorkspace --workspace-rg myRg --agent-rg myRg2

更新 SQL 虛擬機，以啟用 SQL 最佳做法評定，同時與不同訂用帳戶中的 Log Analytics 工作區產生關聯

az sql vm update -n sqlvm -g myresourcegroup --enable-assessment true --workspace-name myLogAnalyticsWorkspace --workspace-rg myRg --workspace-sub myLogAnalyticsWorkspaceSubName --agent-rg myRg2

選擇性參數

--add

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

預設值: []
--agent-rg

包含 AMA 資源 DCE 和 DCR 的資源群組。

--am-day --assessment-day-of-week

執行評定的一周中的一天。

接受的值: Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday
--am-month-occ --assessment-monthly-occurrence

在一個月內發生 DayOfWeek 天以排程評量。 支援值 1,2,3,4 和 -1。 針對當月的最後一天使用 -1 （例如 - 當月的最後一個星期二）。

接受的值: -1, 1, 2, 3, 4
--am-schedule --enable-assessment-schedule

啟用或停用評定排程。 如果提供任何評定排程設定，參數會自動設定為 true。

接受的值: false, true
--am-time --assessment-start-time-local

以 HH：mm 格式的一天時間。 範例包括 17：30、05：13。

--am-week-int --assessment-weekly-interval

排程在 2 個評量執行之間的周數。 支援 1-6 的值。

接受的值: 1, 2, 3, 4, 5, 6
--backup-pwd

備份時加密的密碼。

--backup-schedule-type

備份排程類型。

接受的值: Automated, Manual
--backup-system-dbs

在備份時包含系統資料庫。

接受的值: false, true
預設值: False
--connectivity-type

SQL Server 連線選項。

接受的值: LOCAL, PRIVATE, PUBLIC
--credential-name

認證名稱。

--day-of-week

要套用修補程式的一周中的一天。

接受的值: Everyday, Friday, Monday, Saturday, Sunday, Thursday, Tuesday, Wednesday
--enable-assessment

啟用或停用評定功能。 如果提供任何評估設定，參數會自動設定為 true。

接受的值: false, true
--enable-auto-backup

在 SQL 虛擬機上啟用或停用自動備份。 如果提供任何備份設定，參數會自動設定為 true。

接受的值: false, true
--enable-auto-patching

在 SQL 虛擬機上啟用或停用自動修補。 如果提供任何自動修補設定，參數會自動設定為 true。

接受的值: false, true
--enable-encryption

在 SQL 虛擬機上啟用備份的加密。

接受的值: false, true
預設值: False
--enable-key-vault-credential

啟用或停用金鑰保存庫認證設定。 如果提供任何金鑰保存庫設定，參數會自動設定為 true。

接受的值: false, true
--enable-r-services

啟用或停用 R 服務（SQL 2016 及更新版本）。

接受的值: false, true
--force-string

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

預設值: False
--full-backup-duration

可進行完整備份的特定一天時間範圍持續時間。 1-23 小時。

--full-backup-frequency

完整備份的頻率。 在這兩種情況下，完整備份都會在下一個排定的時間範圍期間開始進行。

接受的值: Daily, Weekly
--full-backup-start-hour

可進行完整備份的特定一天開始時間期間。 0-23 小時。

--ids

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

--image-sku

SQL 映像 SKU。

接受的值: Developer, Enterprise, Express, Standard, Web
--key-vault

Azure 金鑰保存庫 url。

--least-privilege-mode

SQL IaaS 代理程式最低許可權模式。 更新 從系統管理員到每個功能所使用的特定許可權。

接受的值: Enabled, NotSet
--license-type -i

SQL Server 授權類型。

接受的值: AHUB, DR, PAYG
--log-backup-frequency

記錄備份的頻率。 5-60 分鐘。

--maintenance-window-duration

修補的持續時間。 30-180 分鐘。

--maintenance-window-start-hour

起始修補的一天中的小時。 本機 VM 時間 0-23 小時。

--name -n

SQL 虛擬機的名稱。

--port

SQL Server 連接埠。

--remove

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

預設值: []
--resource-group -g

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

--retention-period

備份的保留期間。 1-30 天。

--sa-key

儲存體將進行備份的帳戶金鑰。

--set

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

預設值: []
--sp-name

用來存取金鑰保存庫的服務主體名稱。

--sp-secret

用來存取金鑰保存庫的服務主體名稱秘密。

--sql-mgmt-type
已被取代

自變數 'sql_management_mode' 已被取代，並將在未來版本中移除。

SQL Server 管理類型。 更新 從 LightWeight 到 Full。

接受的值: Full, LightWeight, NoAgent
--sql-workload-type

SQL Server 工作負載類型。

接受的值: DW, GENERAL, OLTP
--storage-account

儲存體將進行備份的帳戶 URL。

--subscription

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

--tags

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

--workspace-name

要與 VM 建立關聯的 Log Analytics 工作區名稱。

--workspace-rg

包含 Log Analytics 工作區的資源群組。

--workspace-sub

包含 Log Analytics 工作區的訂用帳戶。

--yes -y
已被取代

自變數 'prompt' 已被取代，未來版本將會移除。

不提示確認。 需要 --sql-mgmt-type。

預設值: True
全域參數
--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 sql vm validate-azure-ad-auth

編輯

在客戶端驗證 SQL 虛擬機的 Azure AD 驗證，而不啟用它。

az sql vm validate-azure-ad-auth [--ids]
                                 [--msi-client-id]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]

範例

在用戶端使用系統指派的受控識別來驗證 Azure AD 驗證。

az sql vm validate-azure-ad-auth -n sqlvm -g myresourcegroup

在用戶端使用使用者指派的受控識別來驗證 Azure AD 驗證。

az sql vm validate-azure-ad-auth -n sqlvm -g myresourcegroup --msi-client-id 12345678

選擇性參數

--ids

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

--msi-client-id

V 貝魯特電腦受控識別用戶端標識碼。

--name -n

SQL 虛擬機的名稱。

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