az sql server
管理 SQL 伺服器。
命令
az sql server create
建立伺服器。
az sql server create --name
--resource-group
[--admin-password]
[--admin-user]
[--assign-identity]
[--enable-ad-only-auth]
[--enable-public-network {false, true}]
[--external-admin-name]
[--external-admin-principal-type]
[--external-admin-sid]
[--federated-client-id]
[--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
[--key-id]
[--location]
[--minimal-tls-version {1.0, 1.1, 1.2, 1.3}]
[--no-wait]
[--pid]
[--restrict-outbound-network-access {false, true}]
[--user-assigned-identity-id]
範例
建立伺服器。
az sql server create -l westus -g mygroup -n myserver -u myadminuser -p myadminpassword
建立具有已停用公用網路存取伺服器的伺服器。
az sql server create -l westus -g mygroup -n myserver -u myadminuser -p myadminpassword -e false
在沒有 SQL Admin 的情況下建立伺服器,且已啟用 AD 管理員和 AD。
az sql server create --enable-ad-only-auth --external-admin-principal-type User --external-admin-name myUserName --external-admin-sid c5e964e2-6bb2-1111-1111-3b16ec0e1234 -g myResourceGroup -n myServer
在沒有 SQL Admin 的情況下建立伺服器,並啟用 AD 管理員、僅啟用 AD、User ManagedIdenties 和 Identity Type 為 SystemAssigned、UserAssigned。
az sql server create --enable-ad-only-auth --external-admin-principal-type User --external-admin-name myUserName \ --external-admin-sid c5e964e2-6bb2-1111-1111-3b16ec0e1234 -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type SystemAssigned,UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi
建立沒有 SQL Admin 的伺服器,並啟用 AD 管理員、僅啟用 AD、User ManagedIdenties 和 Identity Type 為 UserAssigned。
az sql server create --enable-ad-only-auth --external-admin-principal-type User --external-admin-name myUserName \ --external-admin-sid c5e964e2-6bb2-1111-1111-3b16ec0e1234 -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi
必要參數
Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>
。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
選擇性參數
系統管理員登入密碼(建立伺服器所需的密碼)。
伺服器的系統管理員用戶名稱。 一旦建立就無法變更。
產生並指派此伺服器的 Azure Active Directory 身分識別,以搭配 Azure KeyVault 等密鑰管理服務使用。
為此伺服器啟用僅限 Azure Active Directory 驗證。
設定是否允許對伺服器的公用網路存取。 若為 false,則只有透過 Private Links 建立的連接才能連線到此伺服器。
Azure AD 系統管理員使用者、群組或應用程式的顯示名稱。
使用者、群組或應用程式。
Azure AD 系統管理員的唯一標識碼。 使用者或群組的物件標識碼、應用程式的用戶端識別碼。
跨租使用者 CMK 案例中使用的同盟用戶端標識碼。
要使用的身分識別類型。 可能的值為 SystemAsssigned、UserAssigned、SystemAssigned、UserAssigned 和 None。
用於加密的金鑰保存庫 URI。
位置。 值的來源:az account list-locations
。 您可以使用 az configure --defaults location=<location>
設定預設位置。
SQL Server 針對輸入連線強制執行的最低 TLS 版本。
請勿等候長時間執行的作業完成。
主要使用者受控識別的標識碼。
設定是否限制伺服器的輸出網路存取。 當為 true 時,將會限制來自伺服器的輸出連線。
產生並指派此伺服器的使用者受控識別(UMI)。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sql server delete
刪除伺服器。
az sql server delete [--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>
。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sql server list
列出可用的伺服器。
az sql server list [--expand-ad-admin]
[--resource-group]
範例
列出目前訂用帳戶中的所有伺服器。
az sql server list
列出資源群組中的所有伺服器。
az sql server list -g mygroup
選擇性參數
展開伺服器的 Active Directory 系統管理員。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sql server list-usages
傳回伺服器使用量。
az sql server list-usages [--ids]
[--name]
[--resource-group]
[--subscription]
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>
。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sql server refresh-external-governance-status
重新整理外部治理狀態。
az sql server refresh-external-governance-status [--ids]
[--resource-group]
[--server]
[--subscription]
範例
重新整理伺服器的外部治理狀態
az sql server refresh-external-governance-status --resource-group MyResourceGroup --server MyServer
選擇性參數
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>
。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sql server show
取得伺服器。
az sql server show [--expand-ad-admin]
[--ids]
[--name]
[--resource-group]
[--subscription]
選擇性參數
展開伺服器的 Active Directory 系統管理員。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>
。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sql server update
更新伺服器。
az sql server update [--add]
[--admin-password]
[--assign_identity]
[--enable-public-network {false, true}]
[--federated-client-id]
[--force-string]
[--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
[--ids]
[--key-id]
[--minimal-tls-version {1.0, 1.1, 1.2, 1.3}]
[--name]
[--no-wait]
[--pid]
[--remove]
[--resource-group]
[--restrict-outbound-network-access {false, true}]
[--set]
[--subscription]
[--user-assigned-identity-id]
範例
更新伺服器。 ( 自動產生 )
az sql server update --admin-password myadminpassword --name MyAzureSQLServer --resource-group MyResourceGroup
使用使用者受控標識碼和身分識別類型更新伺服器為 SystemAssigned,UserAssigned。
az sql server update -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type SystemAssigned,UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi
使用使用者受控標識碼和身分識別類型更新伺服器為 UserAssigned。
az sql server update -g myResourceGroup -n myServer -i \ --user-assigned-identity-id /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi \ --identity-type UserAssigned --pid /subscriptions/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/testumi
選擇性參數
藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例:--add property.listProperty <key=value, string or JSON string>
。
系統管理員登入密碼。
產生並指派此伺服器的 Azure Active Directory 身分識別,以搭配 Azure KeyVault 等密鑰管理服務使用。
設定是否允許對伺服器的公用網路存取。 若為 false,則只有透過 Private Links 建立的連接才能連線到此伺服器。
跨租使用者 CMK 案例中使用的同盟用戶端標識碼。
使用 'set' 或 'add' 時,請保留字串常值,而不是嘗試轉換成 JSON。
要使用的身分識別類型。 可能的值為 SystemAsssigned、UserAssigned、SystemAssigned、UserAssigned 和 None。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
用於加密的金鑰保存庫 URI。
SQL Server 針對輸入連線強制執行的最低 TLS 版本。
Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>
。
請勿等候長時間執行的作業完成。
主要使用者受控識別的標識碼。
從清單中移除屬性或專案。 範例: --remove property.list <indexToRemove>
或 --remove propertyToRemove
。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
設定是否限制伺服器的輸出網路存取。 當為 true 時,將會限制來自伺服器的輸出連線。
指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=<value>
。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
產生並指派此伺服器的使用者受控識別(UMI)。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az sql server wait
將 CLI 置於等候狀態,直到符合 SQL Server 的條件為止。
az sql server wait [--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
選擇性參數
請等候在 'Succeeded' 使用 'provisioningState' 建立。
等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到刪除為止。
等候資源存在。
要包含在回應中的子資源。 預設值為 None。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
輪詢間隔以秒為單位。
Azure SQL Server 的名稱。 您可以使用 來設定預設值 az configure --defaults sql-server=<name>
。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
以秒為單位的等候上限。
等到 provisioningState 更新為 'Succeeded'。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。