az sql vm

  • リファレンス

SQL 仮想マシンを管理します。

コマンド

名前 説明 型 Status
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 仮想マシン グループの名前またはリソース ID。 名前のみを指定した場合、SQL 仮想マシン グループは SQL 仮想マシンの同じリソース グループに存在する必要があります。

省略可能のパラメーター

--bootstrap-acc-pwd -b

SQL 仮想マシン グループに指定されている場合は、クラスター ブートストラップ アカウントのパスワード。

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

SQL 仮想マシンの名前。

--operator-acc-pwd -p

SQL 仮想マシン グループに指定されたクラスター オペレーター アカウントのパスワード。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service-acc-pwd -s

SQL 仮想マシン グループに指定された SQL サービス アカウントのパスワード。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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 Key Vault の URL。

--least-privilege-mode

SQL IaaS エージェントの最小特権モード。 sysadmin から機能ごとに使用される特定のアクセス許可に更新します。

承認された値: Enabled, NotSet
--license-type -i

SQL Server ライセンスの種類。

承認された値: AHUB, DR, PAYG
--location -l

Location。 指定しない場合、仮想マシンはリソース グループの同じリージョンに存在する必要があります。を使用して、既定の場所を az configure --defaults location=<location>構成できます。

--log-backup-frequency

ログのバックアップの頻度。 5 ~ 60 分。

--maintenance-window-duration

修正プログラムの適用期間。 30 ~ 180 分。

--maintenance-window-start-hour

修正プログラムの適用が開始される 1 日の時間。 ローカル VM 時間 0 ~ 23 時間。

--port

SQL Server ポート。

--retention-period

バックアップの保有期間。 1 ~ 30 日。

--sa-key

バックアップの保存先となるストレージ アカウント キー。

--sp-name

キー コンテナーにアクセスするためのサービス プリンシパル名。

--sp-secret

キー コンテナーにアクセスするためのサービス プリンシパル名シークレット。

--sql-auth-update-pwd

SQL Server sysadmin ログイン パスワード。

--sql-auth-update-username

作成する SQL Server sysadmin ログイン。

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

サブスクリプションの名前または ID。 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

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

SQL 仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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]

例

クライアント側の検証を使用して、システム割り当てマネージド ID で Azure AD 認証を有効にします。

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

クライアント側の検証を使用して、ユーザー割り当てマネージド ID で Azure AD 認証を有効にします。

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

クライアント側の検証をスキップするシステム割り当てマネージド ID で Azure AD 認証を有効にします。 サーバー側の検証は常に行われます。

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

クライアント側の検証をスキップするユーザー割り当てマネージド ID で Azure AD 認証を有効にします。 サーバー側の検証は常に行われます。

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

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--msi-client-id

Virutal Machine Managed Identity Client ID。

--name -n

SQL 仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--skip-client-validation

クライアント側の Azure AD 認証の検証をスキップします。サーバー側の検証は引き続き行われます。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

SQL 仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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

SQLIaa Standard Edition xtension 構成設定を取得します。 すべての設定を表示するには、*を使用します。 一部のみを選択するには、設定をスペースで区切る必要があります。

承認された値: *, AssessmentSettings, AutoBackupSettings, AutoPatchingSettings, KeyVaultCredentialSettings, ServerConfigurationsManagementSettings
--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

SQL 仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name -n

SQL 仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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 仮想マシンを更新して、Log Analytics ワークスペースに関連付け、エージェント リソースのリソース グループを割り当てながら、SQL ベスト プラクティス評価のスケジュールを毎月有効にします。

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 ワークスペースとリソース グループを指定する必要があります。

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

評価をスケジュールする 1 か月以内の DayOfWeek 日の発生。 値 1、2、3、4、および -1 をサポートします。 月の最後の DayOfWeek 日 (たとえば、月の最後の火曜日) には -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

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--image-sku

SQL イメージ SKU。

承認された値: Developer, Enterprise, Express, Standard, Web
--key-vault

Azure Key Vault の URL。

--least-privilege-mode

SQL IaaS エージェントの最小特権モード。 sysadmin から機能ごとに使用される特定のアクセス許可に更新します。

承認された値: Enabled, NotSet
--license-type -i

SQL Server ライセンスの種類。

承認された値: AHUB, DR, PAYG
--log-backup-frequency

ログのバックアップの頻度。 5 ~ 60 分。

--maintenance-window-duration

修正プログラムの適用期間。 30 ~ 180 分。

--maintenance-window-start-hour

修正プログラムの適用が開始される 1 日の時間。 ローカル VM 時間 0 ~ 23 時間。

--name -n

SQL 仮想マシンの名前。

--port

SQL Server ポート。

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove> OR --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

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 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]

例

クライアント側でシステム割り当てマネージド ID を使用して Azure AD 認証を検証します。

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

クライアント側でユーザー割り当てマネージド ID を使用して Azure AD 認証を検証します。

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

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--msi-client-id

Virutal Machine Managed Identity Client ID。

--name -n

SQL 仮想マシンの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

サブスクリプションの名前または ID。 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

サブスクリプションの名前または ID。 az account set -s NAME_OR_ID を使用して、既定のサブスクリプションを構成できます。

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。